写逸智云在线 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和应用密钥等信息。
   

支持的语言和发音表

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

错误代码列表

版本更新记录