语音播报概述
语音播报（Text to Speech，下文简称TTS），基于华为智慧引擎（HUAWEI HiAI Engine）中的语音播报引擎，向开发者提供人工智能应用层API。该技术提供将文本转换为语音并进行播报的能力。
约束与限制
- 支持超长文本播报，最大文本长度为100000个字符。
- 语音播报不支持多线程调用。
语音播报开发
场景介绍
- 实时语音交互：生成音频信息用于语音交互。
例如与智能音箱或手机智能助手的交互，后台会将回答信息以音频方式进行语音播报。
- 超长文本播报：用于小说、新闻等较长文本的自动朗读。
接口说明
语音播报功能提供了TtsClient类实现文本转语音功能，该类的主要接口如下表所示：
| 接口名 |
描述 |
|---|---|
| void create(Context context, TtsListener ttsListener) |
创建TTS客户端。context为应用的上下文；ttsListener为TTS回调，可以在TtsListener的onEvent方法中获取创建结果（成功或失败，可获取的值详见表2）。 只有在收到创建TTS客户端成功回调之后，才能进行TTS客户端的初始化。 |
| void release() |
释放正在使用的TTS引擎。调用此方法会将初始化状态置为false，并结束播报任务，建议在init(TtsParams)前调用。 |
| boolean init(TtsParams ttsParams) |
初始化TTS客户端。设置deviceId、deviceType、语速、音量、音调、音色参数，其中deviceId必须设置，否则初始化失败。 |
| boolean setParams(TtsParams ttsParams) |
设置参数。支持设置音量、音调、语速、音色四个参数的修改，修改其他值无效，在init(TtsParams)之后调用，否则设置不生效。 |
| boolean setAudioType(AudioManager.AudioVolumeType audioType) |
设置音频流类型。目前支持AudioVolumeType.STREAM_MUSIC等九种音频流类型的设置，可在播报前调用。 |
| void speakText(String text, String utteranceId) |
合成音频并播报。传入需播报的文本即可合成音频并播报，支持的最大文本长度为512个字符，若文本超长或文本为空将会报错，并将错误结果通过回调TtsListener的onError(String,String)方法传给调用者。utteranceId为播报请求的唯一标识，若utteranceId为空，TTS引擎将为本次请求随机生成utteranceId。 |
| void speakLongText(String longText, String utteranceId) |
连续合成并播报超长文本。文本最大支持长度为100000，若文本超过最大支持长度或文本为空将会报错，并将错误结果通过TtsListener的onError(String,String)方法传给调用者。 |
| boolean isSpeaking() |
判断是否正在进行TTS播报。如果正在进行TTS播报，返回true；否则，返回false。 |
| void stopSpeak() |
停止TTS播报。调用此方法停止播报后，若再次播报，将会从头开始播报，而不是从停止处播报。 |
| Optional<String> getVersion() |
获取TTS SDK版本号。 |
| void destroy() |
销毁TTS客户端。完成所有任务后，务必调用此方法销毁TTS客户端。 |
| eventType取值 |
描述 |
|---|---|
| TtsEvent.CREATE_TTS_CLIENT_SUCCESS |
创建TTS客户端成功。 |
| TtsEvent.CREATE_TTS_CLIENT_FAILED |
创建TTS客户端失败。 |
| TtsEvent.DESTROY_TTS_CLIENT_SUCCESS |
销毁TTS客户端成功。 |
| TtsEvent.METHOD_EXECUTE_SUCCESS |
方法执行成功或方法执行无异常时，返回此事件类型。对应的方法可以通过pacMap.getIntValue(TtsClient.PAC_MAP_KEY_METHOD_ID)获取。详见表3 |
| TtsEvent.METHOD_EXECUTE_FAILED_REMOTE_EXCEPTION |
方法执行失败或异常。对应的方法可以通过pacMap.getIntValue(TtsClient.PAC_MAP_KEY_METHOD_ID)获取。详见表3 |
| TtsEvent.DESTROY_TTS_CLIENT_FAILED |
销毁TTS客户端失败或未成功创建TTS客户端时，调用destroy方法，返回此事件类型。 |
| method Id |
方法 |
|---|---|
| TtsClient.METHOD_CREATE |
create |
| TtsClient.METHOD_DESTROY |
destroy |
| TtsClient.METHOD_RELEASE |
release |
| TtsClient.METHOD_SPEAK_LONG_TEXT |
speakLongText |
| TtsClient.METHOD_SPEAK_TEXT |
speakText |
| TtsClient.METHOD_STOP_SPEAK |
stopSpeak |
开发步骤
导入相关的类。
import ohos.ai.tts.TtsClient; // TTS接口
import ohos.ai.tts.TtsListener; // TTS回调
import ohos.ai.tts.TtsParams; // TTS参数
import ohos.ai.tts.constants.TtsEvent; // TTS事件
import ohos.utils.PacMap; // TTS依赖创建与TTS服务的连接。context为应用上下文信息，应为ohos.aafwk.ability.Ability或ohos.aafwk.ability.AbilitySlice的实例或子类实例。
说明
以下代码示例中Log.info()为各方法内定义的处理方法举例，已注释。
private static final TtsListener ttsListener = new TtsListener() {
@Override
public void onEvent(int eventType, PacMap pacMap) {
// Log.info("onEvent:" + eventType);
if (eventType == TtsEvent.CREATE_TTS_CLIENT_SUCCESS) {
// Log.info("TTS Client create success");
}
}
@Override
public void onStart(String utteranceId) {
// Log.info(utteranceId + " audio synthesis begins");
}
@Override
public void onProgress(String utteranceId, byte[] audioData, int progress) {
// Log.info(utteranceId + " audio synthesis progress：" + progress);
}
@Override
public void onFinish(String utteranceId) {
// Log.info(utteranceId + " audio synthesis completed");
}
@Override
public void onSpeechStart(String utteranceId) {
// Log.info(utteranceId + " begins to speech");
}
@Override
public void onSpeechProgressChanged(String utteranceId, int progress) {
// Log.info(utteranceId + " speech progress：" + progress);
}
@Override
public void onSpeechFinish(String utteranceId) {
// Log.info(utteranceId + " speech completed");
}
@Override
public void onError(String utteranceId, String errorMessage) {
// Log.info(utteranceId + " errorMessage: " + errorMessage);
}
};
TtsClient.getInstance().create(context, ttsListener);在TTS接口创建成功后初始化TTS引擎。
TtsParams ttsParams = new TtsParams();
ttsParams.setDeviceId("your device id");
boolean initResult = TtsClient.getInstance().init(ttsParams);初始化TTS引擎成功后调用音频转换并播放接口。文章来源：https://www.toymoban.com/news/detail-510267.html
if (initResult) {
TtsClient.getInstance().speakText("欢迎使用语音播报！", null);
}使用完成后销毁TTS客户端。文章来源地址https://www.toymoban.com/news/detail-510267.html
TtsClient.getInstance().destroy();到了这里，关于HarmonyOS学习路之开发篇—AI功能开发（语音播报）的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
