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.vadMaxSpeechDurationInteger60000用户音频输入最大时长,仅一句话识别场景生效,单位毫秒,默认为 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.成功,其他:失败