tencentMath

立即使用

mathCorrection getStringToSign

概述

本模块封装了腾讯云数学作业批改SDK，数学作业批改（Homework Correction-Math，HCM）是腾讯云推出的速算题目智能批改产品。在过去，速算作业的批改需要教师做基础性、重复性的工作，消耗大量的时间；腾讯云针对此场景推出数学作业批改服务，支持各种数学公式和符号识别，能识别竖式、分式、脱式以及四则运算多种题型。

注意

SecretKey 属于安全敏感参数，线上版本一般由业务后台生成 临时 SecretKey 或者 SDK 外部签名返回到客户端。

内部签名：SDK 内部通过 SecretId 和 SecretKey 计算签名，用户无需关心签名细节。 外部签名：SDK 外部通过调用 getStringToSign 获取签名字符串，然后根据 签名规则-计算签名 进行签名。

注意：本模块 iOS 平台上最低适配系统版本为 iOS 11.0

模块接口

mathCorrection

速算题目批改

mathCorrection({params},callback(ret,err))

params

path：

  • 类型：字符串
  • 描述：图片数据本地路径，支持fs、widget

sessionId：

  • 类型：字符串
  • 描述：（可选项）sessionId
  • 默认：UUID

appId：

  • 类型：字符串
  • 描述：（可选项）账号应用id

secretId：

  • 类型：字符串
  • 描述：（可选项）secretId

secretKey：

  • 类型：字符串
  • 描述：（可选项）secretKey，使用内部签名，此处必填

timeout：

  • 类型：数字
  • 描述：（可选项）超时时间（默认30秒）
  • 默认：30

retryTimes：

  • 类型：数字
  • 描述：（可选项）重试次数（默认0次）
  • 默认：0

token：

  • 类型：字符串
  • 描述：（可选项）临时secretKey方案此处必填

timestamp：

  • 类型：字符串
  • 描述：（可选项）时间戳，临时secretKey方案此处必填

signature：

callback(ret,err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
  status:true,           //布尔类型；接口调用结果
    result:{.  //json对象；批改结果
      sessionId:'',   //字符串类型；sessionId
      items:[{        
         result:true, //布尔类型；计算结果
         rect:{       //json对象识别的算式在图片上的位置信息
           x:0, //数字类型；x坐标
           y:0, //数字类型；y坐标
           w:0, //数字类型；宽
           h:0, //数字类型；长
         },
         formula:'',  //字符串类型；识别的算式
         answer:'',  //字符串类型；推荐的答案，暂不支持多个关系运算符、无关系运算符、单位换算错题的推荐答案返回
         itemConf:1, //数字类型；文本行置信度，此字段可能返回 0，表示取不到有效值
         expressionType:'',  //字符串类型；算式题型编号，如加减乘除四则题型，此字段可能返回空，表示取不到有效值，具体题型及编号如下：
                            // 1 加减乘除四则
                               //2 加减乘除已知结果求运算因子
                             //3 判断大小
                             //4 约等于估算
                             //5 带余数除法
                             //6 分数四则运算
                             //7 单位换算
                             //8 竖式加减法
                             //9 竖式乘除法
                             //10 脱式计算
                             //11 解方程

      }]
    }
}

err：

  • 类型：JSON 对象
  • 内部字段：
{  
  code:0,           //数字类型；code       
  desc:'',         //字符串类型；desc
    requestId:'',         //字符串类型；requestId

}

示例代码

var tencentMath = api.require('tencentMath');
tencentMath.mathCorrection({
   path:''
},function(ret,err) {
    api.alert({ msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的 1.0.0 及更高版本

getStringToSign

获取签名所需字符串

getStringToSign({params},callback(ret,err))

params

timestamp：

  • 类型：数字
  • 描述：时间戳

callback(ret,err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    sign:''          //字符串类型；签名字符串

}

示例代码

var tencentMath = api.require('tencentMath');
tencentMath.getStringToSign({
   timestamp:
},function(ret,err) {
    api.alert({ msg:JSON.stringify(ret)});
});

可用性

iOS系统，Android系统

可提供的 1.0.0 及更高版本