Skip to content

@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) ​

订阅语音识别任务的状态变化。

参数:

参数名类型必填说明
stateChangestring是任务状态变化
callbackCallback<SpeechSynthesizerTask>是语音合成任务状态改变监听的回调函数

示例:

js
this.speechRecognizerInstance.on("stateChange",(data:SpeechRecognizerTask)=>{
    console.info("on:"+JSON.stringify(data))
});

off(type) ​

取消订阅语音识别任务的状态变化。

参数:

参数名类型必填说明
stateChangestring是任务状态变化

示例:

js
speechRecognizer.off("stateChange");

release() ​

释放资源。

返回值:

类型说明
number返回函数执行结果

示例:

js
speechRecognizer.release();

SpeechSynthesizer ​

start(text) ​

开始语音合成。

参数:

参数名类型必填说明
textstring是需要合成的文字

返回值:

类型说明
number返回函数执行结果

示例:

js
speechSynthesizer.start("你好,中国!");

stop() ​

停止语音播放。

返回值:

类型说明
number返回函数执行结果

示例:

js
speechSynthesizer.stop();

on(type, callback) ​

订阅语音合成任务的状态改变。

参数:

参数名类型必填说明
typestring是任务状态改变
callbackCallback<SpeechSynthesizerTask>是语音合成任务状态改变监听的回调函数

示例:

js
this.speechSynthesizer.on("stateChange",(data:SpeechSynthesizerTask)=>{
    console.info("on:"+JSON.stringify(data))
});

off(type) ​

取消订阅语音合成任务的状态改变。

参数:

参数名类型必填说明
typestring是任务状态改变

示例:

js
speechSynthesizer.off("stateChange");

pause() ​

暂停语音播放。

返回值:

类型说明
number返回函数执行结果

示例:

js
speechSynthesizer.pause();

resume() ​

恢复语音播放。

返回值:

类型说明
number返回函数执行结果

示例:

js
speechSynthesizer.resume();

release() ​

释放资源。

返回值:

类型说明
number返回函数执行结果

示例:

js
speechSynthesizer.release();

SpeechRecognizerTask ​

语音识别任务信息。

名称类型必填说明
statusSpeechRecognizerState是识别状态。
errorMessagesstring是错误信息。
subStatusnumber是订阅状态。
resultstring是语音识别结果。

SpeechSynthesizerTask ​

语音合成任务信息。

名称类型必填说明
statusSpeechSynthesizerState是语音合成状态。
errorMessagesstring是错误信息。
subStatusnumber是订阅状态。

SpeechRecognizerState ​

语音识别状态枚举。

值说明
-1无效状态
0准备状态
1捕获音频中
2捕获音频完成
3捕获音频失败
4音频处理中
5音频处理失败
6识别中
7识别完成
8识别失败
9取消

SpeechSynthesizerState ​

语音合成状态枚举。

值说明
-1无效状态
0准备状态
1识别中
2识别完成
3识别失败
4解析音频中
5解析音频失败
6播放音频中
7播放音频完成
8播放音频失败
9取消