soundGeneralRecongnitionSdk

来自于:开发者立即使用

概述

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

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

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及更高版本