speechApi
最低版本: 1.0.0最后更新: 2021/1/21组件功能:
语音相关方法
支持平台:
平台 | 是否支持 |
豹小秘 | 部分支持 |
豹大/花瓶 | 是 |
豹小秘Mini | 是 |
方法:
方法名 | 参数 | JS类型 | Java类型 | 必填 | 参数说明 | 方法说明 | 最低版本 |
playText | callbackld | number | Int | yes | TextListener的id,如果不需要处理事件,传-1 | 播放text文本,如果不需要监听播放状态,callbackld设-1,如果需要监听播放状态,需要设一个TextListener的id | 1.0.0 |
text | string | String | yes | 所要播放的文本 | |||
stopTTS | 无 | 无 | 无 | 无 | 无 | 强制停止播报TTS | 1.0.0 |
setRecognizeMode | isContinue | boolean | Boolean | yes | true 持续识别 false 需要唤醒后才能识别 | 关闭或开启语音长识别模式,开启长识别:不需要唤醒,关闭长识别:需要先唤醒才开始识别语音 | 1.0.0 |
setRecognizable | enable | boolean | Boolean | yes | true 开启 false 关闭 | 关闭或开启语音识别功能,默认是开启的 | 1.0.0 |
queryByText | text | string | String | yes | 需要识别的文本 | 调用服务识别 text 文本 | 1.0.0 |
resetAngleCenterRange | 无 | 无 | 无 | 无 | 无 | 重置拾音中心角度 | 1.0.0 |
setAngleCenterRange | centerAngle | number | Float | yes | 中心角度 [0,360) 左闭右开区间 | 设置识别区域。该接口设置仅在当前app为前台模式时有效,退出或每次重新启动都会恢复至设置模块下的数值。setASREnable(true)时,该值不会受影响 | 1.0.0 |
rangeAngle | number | Float | yes | 区间角度 [0,120] 左闭右闭区间 | |||
setCustomizeWakeUpWord | wakeUpWordChinese | string | String | yes | 唤醒词对应的汉字 | 设置唤醒词 | 1.0.0 |
wakeUpWordPinYin | string | String | yes | 唤醒词对应的拼音 | |||
separator | string | String | yes | 唤醒词之间的分隔符 | |||
closeCustomizeWakeUpWord | 无 | 无 | 无 | 无 | 无 | 关闭唤醒词 | 1.0.0 |
getPinYinScore | pinyin | string | String | yes | 唤醒词对应的拼音 | 获取拼音的唤醒率得分 | 1.0.0 |
separator | string | String | yes | 唤醒词之间的分隔符 | |||
queryPinYinFromChinese | chineseWord | string | String | yes | 所要查询的汉字 | 通过汉字 查询拼音 | 1.0.0 |
queryPinYinMappingTable | pinyin | string | String | yes | 所要查询的拼音 | 查询拼音对应的映射 | 1.0.0 |
queryUserSetWakeUpWord | 无 | 无 | 无 | 无 | 无 | 查询用户设置的唤醒词 | 1.0.0 |
startSkillServerCheckListener | callbackId | number | Int | yes | SkillServerCheckListener的id,如果不需要处理事件,传-1 | 开始弱网监测(只有花瓶有效) | 1.1.0(不支持小秘) |
stopSkillServerCheckListener | 无 | 无 | 无 | 无 | 无 | 关闭弱网监测(只有花瓶有效) | 1.1.0(不支持小秘) |
playToneByLocalPath | callbackId | number | Int | yes | ToneListener的id,如果不需要处理事件,传-1 | 播放本地音频文件 | 1.3.1 |
path | string | String | yes | 音频文件路径 | |||
stopTone | 无 | 无 | 无 | 无 | 无 | 停止播放本地音频文件 | 1.8.0 |
getLatestPlayStartTime | 无 | 无 | 无 | 无 | 无 | 获取最近一次播放tts的时间,一段tts播放结束或被打断会把这个时间重置为0 | 1.16.1 |
setTTSParams | ttsType | TTSParams | TTSParams | yes | 要设置的tts参数类型 | 设置 TTS 参数 | 1.17.0 |
value | number | int | yes | 要设置的tts参数的值,数据类型和参数类型都有对应值,SpeechSpeed,SpeechRate,SpeechPit,SpeakerRole,SpeechVolume和LangRecEnum的常量值LangRecEnumObj的codeValue | |||
setLangRec | langRecParam | LangRecParam | 无 | yes | 切换asr的语种的的参数配置 | 切换 ASR 语言 目前 LangRecParam 中 isAuto 只支持false langs 只能传LangRecEnum的常量的codeValue,目前只支持传一个,langs size 不是1会报错 实例:let param = new LangRecParam(false,[LangRecEnum.EN_US.codeValue]); | 1.17.0 |
setAsrExtendProperty | property | string | String | yes | 往语音链路传一些可识别的数据 | 往语音链路传一些可识别的数据 | 1.17.0(仅支持豹大/花瓶)) |
playTextWithParams | callbackId | number | yes | BridgeTextListener的id | 带参数(一次性有效)的播放tts | 1.22.0(仅支持豹大/花瓶) | |
ttsParams | TTSParamsOnce | TTSParamsOnce 对应的Json | yes | TTSParams 参数 | |||
text | string | String | yes | tts 文字 | |||
setASRParams | astType | ASRParams | String | yes | ASRParams 枚举类型 | 设置ASRParams | 1.22.0(仅支持豹大/花瓶) |
value | string | String | yes | 设置ASRParams 的值 | |||
setWakeupHintClosed | isWakeupHintClosed | boolean | boolean | yes | 是否开关唤醒反馈 | 开关唤醒反馈 | 2.0.0 |
temporaryWakeUp | timeout | number | long | no | 倒计时关闭长识别时间 | 正常模式下,临时唤醒,极客模式下无效(只支持豹小秘 Mini) | 2.0.0 |
downloadTtsAudio | ttsValues | any[] | yes | 下载参数,可以是 string[] 或 TTSEntity[] | 预下载 tts音频文件 | 2.1.0 |
示例代码:
this.textListener = new TextListener();
this.textListener.addListener(TextListener.EVENT_COMPLETE,
(): void => {
console.log, 'ttsPlayFinish');
}
);
speechApi.playText(
this.textListener.getId(),
‘今天天气怎么样?’
);