有道智云在线 TTS SDK 简介

概念解释

TTS：功能包含对文本的合成功能，输入需要合成的文本，返回可以播放的在线URL和本地可以播放的文件和路径

说明

Hi，您好，欢迎使用有道智云TTS Android SDK。如果您想快速体验服务，建议您前往官网体验中心或者搜索小程序（有道智云体验中心）进行试用。

本文档主要针对需要集成TTS服务 Android SDK的开发工程师，详细描述有道智云TTS能力及集成过程。

如果您有与我们商务合作的需求，可以通过一下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

智云语音技术交流QQ群：861723255

联系邮箱： zyservice@corp.youdao.com

温馨提示：
本文档主要针对开发人员，接入测试前需要在后台创建Android应用，并绑定TTS实例；如果您还没有，请按照新手指南操作。

平台向每个账户赠送100元的体验金，供用户集成前测试所用，具体资费规则详见TTS服务报价。

功能介绍

有道TTS SDK 是有道智云开放平台提供的云服务之一，是有道TTS接口的一种实现，支持文字合成语音等功能。

兼容性

支持设备：运行了 Android 4.1及以上系统的 Android 设备

TTS SDK集成指南

集成前提

开始集成SDK之前开发者需要登录有道开放平台(http://ai.youdao.com)， 创建应用获取应用ID（或者通过运营人员获取应用ID），以便使用TTS服务。

集成步骤

SDK包导入

请在工程文件根目录下创建一个名为 libs 的子目录(有的话则不需要创建)，并将YoudaoBase.jar，so包和YoudaoTTS.jar拷贝到 libs 目录下，将以下代码添加到app的build.gradle中：

android {
    sourceSets.main.jniLibs.srcDirs = ['libs']
    ...
}

dependencies {
    implementation files('libs/online_auth.jar')
    implementation files('libs/zhiyun_offline_common.jar')
    implementation files('libs/YoudaoBase_v20230803.jar')
    implementation files('libs/YoudaoTTS_v1.0.1.jar')
}

也可以把so包放在jniLibs下（去掉上面的jniLibs的设置）

AndroidManifest配置

添加权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

代码混淆配置

代码混淆文件proguard-project.txt，添加如下内容

-ignorewarnings
-libraryjars libs/YoudaoBase_v2.0.0.jar
-libraryjars libs/YoudaoTTS_v1.0.0.jar
-keep class com.youdao.sdk.ydtranslate.** { ;}
-keep class com.youdao.speechsynthesizer.online.* { *;}

SDK初始化

使用TTS SDK，请在程序的Application中调用SDK初始化代码，可以参考demo中DemoApplication

//appkey即应用ID
YouDaoApplication.init(this, appkey);

功能集成

请参考demo中的 SpeechSynthesizerDemoActivity 使用

参数说明

speed：合成语音的速度

lanType：支持语种的code

source：设置为app对应的名称（英文字符串）

timeout：表示超时时间

voice：翻译结果发音选择，0为女声，1为男声，默认为女声

volume：音量大小，最大5.0，最小0.5

构造TTS输入对象

tps = new YoudaoSpeechSynthesizerParameters.Builder()
        .source("youdaotts")
        .timeout(12000)
        .voiceName(currentVoiceName)
        .speed(s)
        .format(Constants.SOUND_OUTPUT_MP3)
        .volume(Float.valueOf(volumeEditText.getText().toString().trim()))
        .filePath(getExternalCacheDir().toString() + "/youdao/")///自定义文件夹需要获取读写权限
        .fileName("abc")
        .build();
        youdaoSpeechSynthesizer = YoudaoSpeechSynthesizer.getInstance(tps);

设置回调，开始合成

设置回调接口包含两个方法：onResult表示合成成功，相关结果存储在result参数中，onError表示失败，失败信息放在TTSErrorCode是一个枚举类中。

注意：整个合成是异步的，回调在子线程进行，若涉及到界面操作，请切回主线程。

youdaoSpeechSynthesizer.synthesizeAndCache(text, listener, "requestid");
YoudaoSpeechSynthesizerListener listener = new YoudaoSpeechSynthesizerListener() {
        @Override
        public void onResult(final TTSResult result, String input, final int seq, String requestid) {

        }

        @Override
        public void onError(final TTSErrorCode error, final String input, final int seq, String requestid) {

        }
    };

发言人列表

注意: 更多中文音色发音人列表请查看发音人列表

错误代码列表

常见问题及注意事项

1. 返回110
   应用没有绑定服务实例，可以新建服务，绑定服务。
2. 返回108
   appKey无效，注册账号， 登录后台创建应用并完成绑定， 可获得应用ID和密钥等信息，其中应用ID就是appKey（ 注意不是应用密钥）
3. 返回101
   首先确保必填参数齐全，然后，确认参数书写是否正确。
4. 返回202
   如果确认 appKey 和 appSecret 的正确性，仍返回202，一般是编码问题。请确保 img 为UTF-8编码.

版本更新记录