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取消