数学作业批改
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数学作业批改 > SDK 文档 > Android SDK

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
算式字符串

中国站