soundGeneralRecongnitionSdk

initCloudEngineListener startRecordOne startRecordTwo stopRecord playback

概述

soundGeneralRecongnitionSdk简介

本插件封装了声通识别sdk

插件接口

initCloudEngineListener

设置初始化监听

initCloudEngineListener({params}, callback(ret))

params

appKey：

  • 类型：字符串
  • 描述：（必填项）声通 appkey,必须的参数。

secretKey：

  • 类型：字符串
  • 描述：（必填项）声通 secretkey,必须的参数。

isUseOnlineProvison：

  • 类型：布尔
  • 描述：（可选项）是否需要在线下载证书，默认为 false，(即使用本地证书)
  • 默认：false

isUpdateProvison：

  • 类型：布尔
  • 描述：（可选项）是否需要在线更新证书，默认为 false。若为true，isUseOnlineProvison参数也需设为true

vadEnable：

  • 类型：布尔
  • 描述：（可选项）内核支持VAD情况下，是否启用 VAD
  • 默认：true

seek：

  • 类型：数字
  • 描述：（可选项）vad 技术 可选，发音结束判断间隔，单位 10ms，
  • 默认：60，即 600ms

server：

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

serverList：

  • 类型：字符串
  • 描述：（可选项）获取 serverList 的地址

sdkCfgAddr：

  • 类型：字符串
  • 描述：（可选项）获取 sdkCfgAddr 的地址，Android不支持此参数

connectTimeout：

  • 类型：数字
  • 描述：（可选项）建立连接的超时时间，单位 s

serverTimeout：

  • 类型：数字
  • 描述：（可选项）响应的超时时间，单位 s
  • 默认：60

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status: 字符串类型    start :开始初始化 ,success:初始化成功,failure:初始化失败,denied:用户未授权（仅支持ios）
}

示例代码

var soundGeneralRecongnitionSdk = api.require('soundGeneralRecongnitionSdk');
soundGeneralRecongnitionSdk.initCloudEngineListener({
    appKey : '10002431',
    secretKey :''
}, function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startRecordOne

设置开始录制的第一种方式

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

params

coreType：

  • 类型：字符串
  • 描述：（必填项） 请求的内核类型，word.eval:代表单词，sent.eval:代表句子，para.eval:代表段 落，choice.rec:代表有限分支识别，open.eval:代表开放题型，align.eval:代表音频比 对，grammar.rec:代表语法题(iOS不支持)，asr.rec:代表英文自由识别。

content：

  • 类型：字符串
  • 描述：（必填项）评测内容;

soundIntensityEnable：

  • 类型：布尔
  • 描述：（可选项）是否返回音强，Android不支持此参数
  • 默认：true

attachAudioUrl：

  • 类型：布尔
  • 描述：（可选项）使用云服务时可选，指定服务器使返回结果附带音频下载地址
  • 默认：true

callback(ret,err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    recordStatus:   数据类型:字符串类型    startRecord :录制开始 ,recording:录制中,recordEnd:录制结束，iOS不支持此字段
    recordStatus=recordEnd且获取数据成功时返回;
    result:{           //获取到的数据信息详见sdk开发包中的返回结果及请求参数的文档
       ....
     },
    status:, //布尔类型，是否成功，Android不支持此参数
    intensity:, //数字类型，音强，soundIntensityEnable为true时返回

}

err：

  • 类型：JSON 对象
  • 内部字段：
{
    recordStatus:   数据类型:字符串类型    startRecord :录制开始 recordEnd:录制结束，ios不支持此字段
    Android：recordStatus=recordEnd且获取数据失败返回;
    errId:    数字类型  详见sdk错误信息文档

}

示例代码

var soundGeneralRecongnitionSdk = api.require('soundGeneralRecongnitionSdk');
                  soundGeneralRecongnitionSdk. startRecordOne({
                              coreType: 'word.eval',
                              content:'hello',
                              }, function(ret,err) {
                               api.alert({ msg: JSON.stringify(ret) });
                               api.alert({ msg: JSON.stringify(err) });
                               }
                           );

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startRecordTwo

设置开始录制的第二种方式

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

params

coreType：

  • 类型：字符串
  • 描述：（必填项） 请求的内核类型，word.eval:代表单词，sent.eval:代表句子，para.eval:代表段 落，choice.rec:代表有限分支识别，open.eval:代表开放题型，align.eval:代表音频比 对，grammar.rec:代表语法题，asr.rec:代表英文自由识别。

refText：

  • 类型：字符串
  • 描述：（必填项）参考文本，多个参考答案用竖线(|)隔开；音频比对题型中该参数,传入标准音频文件的fs或者widget路径。

qType：

  • 类型：数字类型
  • 描述：非 open.eval 题型默认传 0；open.eval 题型必须，0：短文朗读；1：短文跟读；2：句子翻译；3：段落翻译；4：故事复述；5：看图说话；6：情景问答；7：口头作文

soundIntensityEnable：

  • 类型：布尔
  • 描述：（可选项）是否返回音强，Android不支持此参数
  • 默认：true

attachAudioUrl：

  • 类型：布尔
  • 描述：（可选项）使用云服务时可选，指定服务器使返回结果附带音频下载地址
  • 默认：true

callback(ret,err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    recordStatus:   数据类型:字符串类型    startRecord :录制开始 recordEnd:录制结束，iOS不支持此字段
    recordStatus=recordEnd且获取数据成功时返回;
    result:{           //获取到的数据信息详见sdk开发包中的返回结果及请求参数的文档
       ....
     },
    status: //布尔类型，是否成功，Android不支持此参数
    intensity: //数字类型，音强，soundIntensityEnable为true时返回，Android不支持此参数
}

err：

  • 类型：JSON 对象
  • 内部字段：
{
    recordStatus:   数据类型:字符串类型    startRecord :录制开始 ,recording:录制中,recordEnd:录制结束
    recordStatus=recordEnd且获取数据失败返回;
     errId:    数字类型  详见sdk错误信息文档
 
}

示例代码

var soundGeneralRecongnitionSdk = api.require('soundGeneralRecongnitionSdk');
                  soundGeneralRecongnitionSdk. startRecordTwo({
                              coreType: 'word.eval',
                              content:'hello',
                              }, function(ret,err) {
                               api.alert({ msg: JSON.stringify(ret) });
                               api.alert({ msg: JSON.stringify(err) });
                               }
                           );

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopRecord

停止录制

stopRecord()

示例代码

var soundGeneralRecongnitionSdk = api.require('soundGeneralRecongnitionSdk');
                  soundGeneralRecongnitionSdk.stopRecord();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

playback

回放

playback()

示例代码

var soundGeneralRecongnitionSdk = api.require('soundGeneralRecongnitionSdk');
                  soundGeneralRecongnitionSdk.playback();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18