有道智云在線 TTS SDK 簡介

概念解釋

TTS：功能包含對文本的合成功能，輸入需要合成的文本，返回可以播放的在線URL和本地可以播放的文件和路徑

說明

Hi，您好，歡迎使用有道智云TTS Android SDK。如果您想快速體驗服務(wù)，建議您前往官網(wǎng)體驗中心或者搜索小程序（有道智云體驗中心）進(jìn)行試用。

本文檔主要針對需要集成TTS服務(wù) Android SDK的開發(fā)工程師，詳細(xì)描述有道智云TTS能力及集成過程。

如果您有與我們商務(wù)合作的需求，可以通過一下方式聯(lián)系我們：

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：

客服QQ：1906538062

智云語音技術(shù)交流QQ群：861723255

聯(lián)系郵箱： zyservice@corp.youdao.com

溫馨提示：
本文檔主要針對開發(fā)人員，接入測試前需要在后臺創(chuàng)建Android應(yīng)用，并綁定TTS實例；如果您還沒有，請按照新手指南操作。

平臺向每個賬戶贈送100元的體驗金，供用戶集成前測試所用，具體資費(fèi)規(guī)則詳見TTS服務(wù)報價。

功能介紹

有道TTS SDK 是有道智云開放平臺提供的云服務(wù)之一，是有道TTS接口的一種實現(xiàn)，支持文字合成語音等功能。

兼容性

支持設(shè)備：運(yùn)行了 Android 4.1及以上系統(tǒng)的 Android 設(shè)備

TTS SDK集成指南

集成前提

開始集成SDK之前開發(fā)者需要登錄有道開放平臺(http://www.fn5000.cn)， 創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過運(yùn)營人員獲取應(yīng)用ID），以便使用TTS服務(wù)。

集成步驟

SDK包導(dǎo)入

請在工程文件根目錄下創(chuàng)建一個名為 libs 的子目錄(有的話則不需要創(chuàng)建)，并將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的設(shè)置）

AndroidManifest配置

添加權(quán)限

<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，添加如下內(nèi)容

-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中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication

//appkey即應(yīng)用ID
YouDaoApplication.init(this, appkey);

功能集成

請參考demo中的 SpeechSynthesizerDemoActivity 使用

參數(shù)說明

speed：合成語音的速度

lanType：支持語種的code

source：設(shè)置為app對應(yīng)的名稱（英文字符串）

timeout：表示超時時間

voice：翻譯結(jié)果發(fā)音選擇，0為女聲，1為男聲，默認(rèn)為女聲

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

構(gòu)造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/")///自定義文件夾需要獲取讀寫權(quán)限
        .fileName("abc")
        .build();
        youdaoSpeechSynthesizer = YoudaoSpeechSynthesizer.getInstance(tps);

設(shè)置回調(diào)，開始合成

設(shè)置回調(diào)接口包含兩個方法：onResult表示合成成功，相關(guān)結(jié)果存儲在result參數(shù)中，onError表示失敗，失敗信息放在TTSErrorCode是一個枚舉類中。

注意：整個合成是異步的，回調(diào)在子線程進(jìn)行，若涉及到界面操作，請切回主線程。

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) {

        }
    };

發(fā)言人列表

注意: 更多中文音色發(fā)音人列表請查看發(fā)音人列表

錯誤代碼列表

常見問題及注意事項

1. 返回110
   應(yīng)用沒有綁定服務(wù)實例，可以新建服務(wù)，綁定服務(wù)。
2. 返回108
   appKey無效，注冊賬號， 登錄后臺創(chuàng)建應(yīng)用并完成綁定， 可獲得應(yīng)用ID和密鑰等信息，其中應(yīng)用ID就是appKey（ 注意不是應(yīng)用密鑰）
3. 返回101
   首先確保必填參數(shù)齊全，然后，確認(rèn)參數(shù)書寫是否正確。
4. 返回202
   如果確認(rèn)?appKey?和?appSecret?的正確性，仍返回202，一般是編碼問題。請確保?img?為UTF-8編碼.

版本更新記錄