有道智云在線(xiàn) TTS SDK 簡(jiǎn)介

概述

(1) 概念解釋

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

(2) 說(shuō)明

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

本文檔主要針對(duì)需要集成TTS服務(wù)iOS SDK的開(kāi)發(fā)工程師，詳細(xì)描述有道智云語(yǔ)音合成能力及集成過(guò)程。

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

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

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

客服QQ：1906538062

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

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

溫馨提示：
本文檔主要針對(duì)開(kāi)發(fā)人員，接入測(cè)試前需要在后臺(tái)創(chuàng)建iOS應(yīng)用，并綁定語(yǔ)音合成實(shí)例；如果您還沒(méi)有，請(qǐng)按照 新手指南 操作。

平臺(tái)向每個(gè)賬戶(hù)贈(zèng)送50元的體驗(yàn)金，供用戶(hù)集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見(jiàn)TTS服務(wù)報(bào)價(jià)。

功能介紹

有道語(yǔ)音合成 SDK 是有道智云開(kāi)放平臺(tái)提供的云服務(wù)之一，是有道TTS接口的一種實(shí)現(xiàn)，支持在線(xiàn)文字合成語(yǔ)音等功能。

兼容性

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

TTS SDK集成指南

集成前提

開(kāi)始集成SDK之前開(kāi)發(fā)者需要登錄 有道智云平臺(tái) ，創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過(guò)運(yùn)營(yíng)人員獲取應(yīng)用ID），以便使用語(yǔ)音合成服務(wù)。

集成步驟

SDK包導(dǎo)入

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

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

(2) 設(shè)置工程O(píng)ther Linker Flags為-ObjC

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

SDK初始化

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

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

功能集成

說(shuō)明：請(qǐng)參考 demo 中 TTSController 的使用

構(gòu)造查詢(xún)器

YDTTSRequest *request = [YDTTSRequest request];

語(yǔ)音合成過(guò)程

識(shí)別返回兩種情況，一種是成功，相關(guān)結(jié)果存儲(chǔ)在 result 參數(shù)中，另外一種是失敗，失敗信息放在 error。詳細(xì)信息可參見(jiàn) 錯(cuò)誤代碼列表。

[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];
    }
} ];

參數(shù)說(shuō)明

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

speed：合成語(yǔ)音的速度

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

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

常見(jiàn)問(wèn)題及注意事項(xiàng)

1. 運(yùn)行程序崩潰？

        檢查下是否對(duì)應(yīng)的 `SDK靜態(tài)庫(kù)包` 是否放到當(dāng)前工程目錄下。
   

2. 合成沒(méi)結(jié)果？

       檢查下接口回調(diào)的錯(cuò)誤信息，保證申請(qǐng)的應(yīng)用ID是有效且提前綁定了。
   

3. 如何獲得應(yīng)用ID

       注冊(cè)賬號(hào)，登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定， 可獲得應(yīng)用ID和應(yīng)用密鑰等信息。
   

支持的語(yǔ)言和發(fā)音表

錯(cuò)誤代碼列表

版本更新記錄