Skip to content

开始语音识别 ​

方法名 ​

startRecognizer

注意

识别结果在初始化回调中返回

用法 ​

  • 用法如下:
js
let params = {
  //【可选配置】是否开启顺滑(DDC)
  enableDdc: false,
  //【可选配置】是否开启文字转数字(ITN)
  enableItn: false,
  //【可选配置】是否开启标点
  showNluPunc: true,
  //【可选配置】设置识别语种
  language: "en-US",
  //【可选配置】是否启用云端自动判停
  autoStop: false,
  //【可选配置】是否隐藏句尾标点
  disableEndPunc: false,
  //【可选配置】控制识别结果返回的形式,全量返回或增量返回,默认为全量
  resultType: "full",
  //【可选配置】设置VAD头部静音时长,用户多久没说话视为空音频,即静音检测时长
  vadStartSilenceTime: 0,
  //【可选配置】设置VAD尾部静音时长,用户说话后停顿多久视为说话结束,即自动判停时长
  vadEndSilenceTime: 0,
  //【可选配置】设置VAD模式,用于定制VAD场景,默认为空
  vadMode: "",
  //【可选配置】用户音频输入最大时长,仅一句话识别场景生效,单位毫秒,默认为 60000ms.
  vadMaxSpeechDuration: 60000,
  //【可选配置】控制是否返回录音音量,在 APP 需要显示音频波形时可以启用
  enableGetVolume: false,
  //【可选配置】设置纠错词表,识别结果会根据设置的纠错词纠正结果,例如:"{\"古爱玲\":\"谷爱凌\"}",当识别结果中出现"古爱玲"时会替换为"谷爱凌"
  correctWords: "{\"古爱玲\":\"谷爱凌\",\"古埃宁\":\"谷爱凌\",\"谷爱玲\":\"谷爱凌\",\"谷埃宁\":\"谷爱凌\"}",
  // 更新 ASR 热词,例如:"{\"hotwords\":[{\"word\":\"过秦论\",\"scale\":2.0}]}"
  // scale为float类型参数,其中叠词的范围为[1.0,2.0],非叠词的范围为[1.0,50.0],scale值越大,结果中出现热词的概率越大
  updateAsrHotWords: "{\"hotwords\":[{\"word\":\"过秦论\",\"scale\":2.0}]}",
  //使用音频文件识别时,需要设置文件的绝对路径
  // 使用音频文件识别时【必须配置】,否则【无需配置】
  // filePath: ""
};
module.startRecognizer({
  params: params,
  //成功执行的函数
  success: (res) => {
    console.log(res)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  complete: (res) => {
    console.log(res)
  }
})
js
let params = {
  //【可选配置】是否开启顺滑(DDC)
  enableDdc: false,
  //【可选配置】是否开启文字转数字(ITN)
  enableItn: false,
  //【可选配置】是否开启标点
  showNluPunc: true,
  //【可选配置】设置识别语种
  language: "en-US",
  //【可选配置】是否启用云端自动判停
  autoStop: false,
  //【可选配置】是否隐藏句尾标点
  disableEndPunc: false,
  //【可选配置】控制识别结果返回的形式,全量返回或增量返回,默认为全量
  resultType: "full",
  //【可选配置】设置VAD头部静音时长,用户多久没说话视为空音频,即静音检测时长
  vadStartSilenceTime: 0,
  //【可选配置】设置VAD尾部静音时长,用户说话后停顿多久视为说话结束,即自动判停时长
  vadEndSilenceTime: 0,
  //【可选配置】设置VAD模式,用于定制VAD场景,默认为空
  vadMode: "",
  //【可选配置】用户音频输入最大时长,仅一句话识别场景生效,单位毫秒,默认为 60000ms.
  vadMaxSpeechDuration: 60000,
  //【可选配置】控制是否返回录音音量,在 APP 需要显示音频波形时可以启用
  enableGetVolume: false,
  //【可选配置】设置纠错词表,识别结果会根据设置的纠错词纠正结果,例如:"{\"古爱玲\":\"谷爱凌\"}",当识别结果中出现"古爱玲"时会替换为"谷爱凌"
  correctWords: "{\"古爱玲\":\"谷爱凌\",\"古埃宁\":\"谷爱凌\",\"谷爱玲\":\"谷爱凌\",\"谷埃宁\":\"谷爱凌\"}",
  // 更新 ASR 热词,例如:"{\"hotwords\":[{\"word\":\"过秦论\",\"scale\":2.0}]}"
  // scale为float类型参数,其中叠词的范围为[1.0,2.0],非叠词的范围为[1.0,50.0],scale值越大,结果中出现热词的概率越大
  updateAsrHotWords: "{\"hotwords\":[{\"word\":\"过秦论\",\"scale\":2.0}]}",
  //使用音频文件识别时,需要设置文件的绝对路径
  // 使用音频文件识别时【必须配置】,否则【无需配置】
  // filePath: ""
};
module.startRecognizer({
  params: params,
  //成功执行的函数
  success: (res) => {
    console.log(res)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  // complete: (res) => {
  //   console.log(res)
  // }
} as LevenOptions)
  • 参数说明
    参数名参数类型是否必填默认值参数描述
    paramsObject是无接口请求参数
    params.enableDdcBoolean否无是否开启顺滑(DDC)
    params.enableItnBoolean否无是否开启文字转数字(ITN)
    params.showNluPuncBoolean否无是否开启标点
    params.languageString否无设置识别语种
    params.autoStopBoolean否无是否启用云端自动判停
    params.disableEndPuncBoolean否无是否隐藏句尾标点
    params.resultTypeString否无控制识别结果返回的形式,全量返回或增量返回,默认为全量
    params.vadStartSilenceTimeInteger否无头部静音时长,用户多久没说话视为空音频,即静音检测时长
    params.vadEndSilenceTimeInteger否无设置VAD尾部静音时长,用户说话后停顿多久视为说话结束,即自动判停时长
    params.vadModeString否无设置VAD模式,用于定制VAD场景,默认为空
    params.vadMaxSpeechDurationInteger否60000用户音频输入最大时长,仅一句话识别场景生效,单位毫秒,默认为 60000ms
    params.enableGetVolumeBoolean否无控制是否返回录音音量,在 APP 需要显示音频波形时可以启用
    params.correctWordsString否无设置纠错词表,识别结果会根据设置的纠错词纠正结果,例如:"{"古爱玲":"谷爱凌"}",当识别结果中出现"古爱玲"时会替换为"谷爱凌"
    params.updateAsrHotWordsString否无更新 ASR 热词,例如:"{"hotwords":[{"word":"过秦论","scale":2.0}]}"
    scale为float类型参数,其中叠词的范围为[1.0,2.0],非叠词的范围为[1.0,50.0],scale值越大,结果中出现热词的概率越大
    params.filePathString否无使用音频文件识别时,需要设置文件的绝对路径,使用音频文件识别时【必须配置】,否则【无需配置】
    successFunction否无执行成功的函数
    failFunction否无执行失败的函数
    completeFunction否无执行完成的函数,不管成功还是失败都会执行

回调 ​

  • 示例
json
{
    "data": {},
    "message": "",
    "code": 0
}
  • 回调说明:
    参数名参数类型参数描述
    messageString消息提示
    dataObject数据对象
    codeInteger返回类型,0.成功,其他:失败