Appearance
@ohos.voiceassistant
语音助手模块提供语音识别和语音合成功能。
导入模块
js
import voiceAssistant from '@ohos.voiceassistant';
语音识别
voiceAssistant.createSpeechRecognizer
createSpeechRecognizer(): SpeechRecognizer;
创建语音识别器实例。
返回值:
类型 | 说明 |
---|---|
SpeechRecognizer | 语音识别器实例 |
示例:
js
const speechRecognizer = voiceAssistant.createSpeechRecognizer();
voiceAssistant.createSpeechSynthesizer
createSpeechSynthesizer(): SpeechSynthesizer;
创建语音合成实例。
返回值:
类型 | 说明 |
---|---|
SpeechSynthesizer | 语音合成实例 |
示例:
js
const speechSynthesizer = voiceAssistant.createSpeechSynthesizer();
SpeechRecognizer
start()
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechRecognizer.start();
stop()
停止语音识别。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechRecognizer.stop();
on(type, callback)
订阅语音识别任务的状态变化。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
stateChange | string | 是 | 任务状态变化 |
callback | Callback<SpeechSynthesizerTask> | 是 | 语音合成任务状态改变监听的回调函数 |
示例:
js
this.speechRecognizerInstance.on("stateChange",(data:SpeechRecognizerTask)=>{
console.info("on:"+JSON.stringify(data))
});
off(type)
取消订阅语音识别任务的状态变化。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
stateChange | string | 是 | 任务状态变化 |
示例:
js
speechRecognizer.off("stateChange");
release()
释放资源。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechRecognizer.release();
SpeechSynthesizer
start(text)
开始语音合成。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
text | string | 是 | 需要合成的文字 |
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechSynthesizer.start("你好,中国!");
stop()
停止语音播放。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechSynthesizer.stop();
on(type, callback)
订阅语音合成任务的状态改变。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 任务状态改变 |
callback | Callback<SpeechSynthesizerTask> | 是 | 语音合成任务状态改变监听的回调函数 |
示例:
js
this.speechSynthesizer.on("stateChange",(data:SpeechSynthesizerTask)=>{
console.info("on:"+JSON.stringify(data))
});
off(type)
取消订阅语音合成任务的状态改变。
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 任务状态改变 |
示例:
js
speechSynthesizer.off("stateChange");
pause()
暂停语音播放。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechSynthesizer.pause();
resume()
恢复语音播放。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechSynthesizer.resume();
release()
释放资源。
返回值:
类型 | 说明 |
---|---|
number | 返回函数执行结果 |
示例:
js
speechSynthesizer.release();
SpeechRecognizerTask
语音识别任务信息。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
status | SpeechRecognizerState | 是 | 识别状态。 |
errorMessages | string | 是 | 错误信息。 |
subStatus | number | 是 | 订阅状态。 |
result | string | 是 | 语音识别结果。 |
SpeechSynthesizerTask
语音合成任务信息。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
status | SpeechSynthesizerState | 是 | 语音合成状态。 |
errorMessages | string | 是 | 错误信息。 |
subStatus | number | 是 | 订阅状态。 |
SpeechRecognizerState
语音识别状态枚举。
值 | 说明 |
---|---|
-1 | 无效状态 |
0 | 准备状态 |
1 | 捕获音频中 |
2 | 捕获音频完成 |
3 | 捕获音频失败 |
4 | 音频处理中 |
5 | 音频处理失败 |
6 | 识别中 |
7 | 识别完成 |
8 | 识别失败 |
9 | 取消 |
SpeechSynthesizerState
语音合成状态枚举。
值 | 说明 |
---|---|
-1 | 无效状态 |
0 | 准备状态 |
1 | 识别中 |
2 | 识别完成 |
3 | 识别失败 |
4 | 解析音频中 |
5 | 解析音频失败 |
6 | 播放音频中 |
7 | 播放音频完成 |
8 | 播放音频失败 |
9 | 取消 |