概述
数学作业批改（Homework Correction-Math，HCM）是腾讯云推出的速算题目智能批改产品。在过去，速算作业的批改需要教师做基础性、重复性的工作，消耗大量的时间，腾讯云针对此场景推出数学作业批改服务，该服务支持各种数学公式和符号识别，能识别竖式、分式、脱式以及四则运算多种题型。
TAISDK 是一款封装了腾讯云教育 AI 能力的 SDK，通过集成 SDK，用户可以快速接入相关产品功能，如智聆口语评测、数学作业批改等。
前提条件
集成 SDK
1. 导入 SDK
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，需要同时传入tokenparam.token = "";//作业批改this.correction.correction(param, new TAIMathCorrectionCallback() {@Overridepublic void onError(TAIError error) {//错误返回}@Overridepublic void onSuccess(final TAIMathCorrectionRet result) {//成功返回TAIMathCorrectionRet}});
3. 签名
内部签名：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 | 算式字符串 |
