有道智云在線 TTS SDK 簡介

概述

(1) 概念解釋

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

(2) 說明

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

本文檔主要針對需要集成TTS服務iOS SDK的開發工程師，詳細描述有道智云語音合成能力及集成過程。

如果您有與我們商務合作的需求，可以通過一下方式聯系我們：

商務郵箱： AIcloud_Business@corp.youdao.com

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

客服QQ：1906538062

智云語音技術交流QQ群：861723255

聯系郵箱： zhiyun@corp.youdao.com

溫馨提示： 本文檔主要針對開發人員，接入測試前需要在后臺創建iOS應用，并綁定語音合成實例；如果您還沒有，請按照 新手指南 操作。

平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規則詳見TTS服務報價。

功能介紹

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

兼容性

支持設備：運行了iOS 8.0及以上系統的 iOS 設備

TTS SDK集成指南

集成前提

開始集成SDK之前開發者需要登錄 有道智云平臺 ，創建應用獲取應用ID（或者通過運營人員獲取應用ID），以便使用語音合成服務。

集成步驟

SDK包導入

TTS SDK 由如下幾個 SDK 組成，YDTTSiOSSDK.h、libbase.a、libTTSiOSSDK.a、base.h

(1) 添加頭文件和庫文件：TTS SDK 添加到工程中，包括 YDTTSiOSSDK.h、libbase.a、libTTSiOSSDK.a、base.h文件。可以直接將SDK文件夾拖動到工程中，也可以選擇File “Add files to ‘Project Name’…”

(2) 設置工程Other Linker Flags為-ObjC

(3) 在工程build Phases – Link Binary With Libraries中添加libbase.a，libTTSiOSSDK.a, AdSupport.framework, CoreTelephony.framework, SystemConfiguration, libz.tbd和libsqlite3.tbd。

SDK初始化

說明：所有的合成都需要初始化key，只執行初始化一次即可。

//初始化key
YDTranslateInstance *yd = [YDTranslateInstance sharedInstance];
yd.appKey = @"your appkey";

功能集成

說明：請參考 demo 中 TTSController 的使用

構造查詢器

YDTTSRequest *request = [YDTTSRequest request];

語音合成過程

識別返回兩種情況，一種是成功，相關結果存儲在 result 參數中，另外一種是失敗，失敗信息放在 error。詳細信息可參見 錯誤代碼列表。

[request lookup:_textView.text WithLanguage:self.language Parm:_parameter WithCompletionHandler:^(YDTTSRequest *request, NSData *result, NSError *error) {
    
    if (error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
        [self handleResponse:result];
    }
} ];

參數說明

    _parameter = [[YDTTSParameter alloc]init];
    _parameter.speed = @"";
    _parameter.volume = @"1.00";
    _parameter.voice = @"3";

speed：合成語音的速度

voice：翻譯結果發音選擇，0為女聲，1為男聲，默認為女聲

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

常見問題及注意事項

1. 運行程序崩潰？ 檢查下是否對應的 SDK靜態庫包 是否放到當前工程目錄下。

2. 合成沒結果？ 檢查下接口回調的錯誤信息，保證申請的應用ID是有效且提前綁定了。

3. 如何獲得應用ID 注冊賬號，登錄后臺創建應用和實例并完成綁定， 可獲得應用ID和應用密鑰等信息。

支持的語言和發音表

錯誤代碼列表

版本更新記錄