写逸智云在线 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 {
    compile files('libs/YoudaoBase_v2.0.0.jar')
    compile files('libs/YoudaoTTS_v1.0.0.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)
                .lanType(Language.getLanguageByName(currentLang).getCode())
                .voice(currentVoice)
                .speed(s)
                .volume(Float.valueOf(volumeEditText.getText().toString().trim()))
                .filePath(Environment.getExternalStorageDirectory().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) {

        }
    };

支持的语言和发音表

• 注：女声的代码为0，男声代码为1。
• 英语五种：
• 美式女声：0；
• 美式男生：1；
• 英式女声：2；
• 英式男生：3；
• 通用英式女声：4 (默认为通用英式女声)；
• 词典英式发音：5；
• 词典美式发音：6；
• 如果选择5或6，但是实际上不是个词，不会返回词典发音，而是返回对应的英式发音和通用美式发音；
• 如果对应语言没有输入的发声，会使用默认发声，比如粤语为女声，但输入为代码为1，依旧使用女声；
• 粤语暂不支持调节音量和语速；

错误代码列表

常见问题及注意事项

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

版本更新记录