Android SDK

最近更新时间:2024-02-02 16:35:31

我的收藏

概述

数学作业批改(Homework Correction-Math,HCM)是腾讯云推出的速算题目智能批改产品。在过去,速算作业的批改需要教师做基础性、重复性的工作,消耗大量的时间,腾讯云针对此场景推出数学作业批改服务,该服务支持各种数学公式和符号识别,能识别竖式、分式、脱式以及四则运算多种题型。 TAISDK 是一款封装了腾讯云教育 AI 能力的 SDK,通过集成 SDK,用户可以快速接入相关产品功能,如智聆口语评测、数学作业批改等。

前提条件

获取密钥:SecretId 和 SecretKey 是使用 SDK 的安全凭证,您可以在 访问管理 > 云 API 密钥 > API 密钥管理 中获取该凭证。



集成 SDK

1. 导入 SDK

下载 Demo 源码,并在 build.gradle 引入依赖包。
implementation 'com.tencent.taisdk:taisdk:1.2.0.61'

2. 调用接口

声明并定义对象:
private TAIMathCorrection correction = new TAIMathCorrection();
初始化参数:
TAIMathCorrectionParam param = new TAIMathCorrectionParam();
param.context = this;
param.appId = "";
param.sessionId = UUID.randomUUID().toString();

ByteArrayOutputStream outputStream = new ByteArrayOutputStream(this.bitmap.getByteCount());
this.bitmap.compress(Bitmap.CompressFormat.JPEG, 50, outputStream);
param.imageData = outputStream.toByteArray();

param.secretId = "";
param.secretKey = "";
// 如果使用服务端生成临时secretKey,需要同时传入token
param.token = "";
//作业批改
this.correction.correction(param, new TAIMathCorrectionCallback() {
@Override
public void onError(TAIError error) {
//错误返回
}

@Override
public void onSuccess(final TAIMathCorrectionRet result) {
//成功返回TAIMathCorrectionRet
}
});

3. 签名

SecretKey 属于安全敏感参数,线上版本一般由业务后台生成 临时 SecretKey 或者 SDK 外部签名返回到客户端。
内部签名:SDK 内部通过 SecretId 和 SecretKey 计算签名,用户无需关心签名细节。
外部签名:SDK 外部通过调用 getStringToSign 获取签名字符串,然后根据 签名规则-计算签名 进行签名。
//获取签名所需字符串
public String getStringToSign(long timestamp);
注意
时间戳 timestamp 必须和 TAIEvaluationParam 参数的 timestamp 一致。

参数说明

公共参数

TAICommonParam 参数说明:
参数
类型
必填
说明
context
Context
上下文
appId
String
AppID
timeout
Int
超时时间,默认30秒
secretId
String
密钥 ID
secretKey
String
内部签名:必填
密钥 Key
signature
String
外部签名:必填
签名
timestamp
Long
外部签名:必填
秒级时间戳
TAIError 参数说明:
参数
类型
说明
code
Int
错误码
desc
String
错误描述
requestId
String
请求 ID,定位错误信息

数学作业批改参数

TAIMathCorrectionParam 参数说明:
参数
类型
必填
说明
sessionId
String
一次批改唯一标识
imageData
byte[]
图片数据
TAIMathCorrectionRet 参数说明:
参数
类型
说明
sessionId
String
一次批改唯一标识
formula
String
算式
items
List
算式结果
TAIMathCorrectionItem 参数说明:
参数
类型
说明
result
Boolean
算式结果
rect
Rect
算式坐标
formula
String
算式字符串