有道智云在線 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://www.0570gy.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編碼.

版本更新記錄