一、概念

• 语音播报（Text to Speech，下文简称 TTS），基于华为智慧引擎（HUAWEI HiAI Engine）中的语音播报引擎，向开发者提供人工智能应用层 API。该技术提供将文本转换为语音并进行播报的能力。
• 支持超长文本播报，最大文本长度为 100000 个字符。
• 语音播报不支持多线程调用。

二、应用场景

• 实时语音交互：生成音频信息用于语音交互。例如：与智能音箱或手机智能助手的交互，后台会将回答信息以音频方式进行语音播报。
• 超长文本播报：用于小说、新闻等较长文本的自动朗读。

三、API 说明

• 语音播报功能提供了 TtsClient 类实现文本转语音功能，该类的主要接口如下表所示：

• TtsListener 中 onEvent 的 eventType 对照表：

• method ID 与方法对照表：

四、开发流程

• 导入相关的类：

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 的实例或子类实例：

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 引擎成功后调用音频转换并播放接口：

if (initResult) {
	    TtsClient.getInstance().speakText("欢迎使用语音播报！", null);
	}

• 使用完成后销毁 TTS 客户端：

TtsClient.getInstance().destroy();