tencentMath

立即使用

概述

本模块封装了腾讯云数学作业批改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 及更高版本