語(yǔ)音翻譯 IOS SDK 簡(jiǎn)介

概述

(1) 概念解釋

語(yǔ)音翻譯：將一段源語(yǔ)言音頻文件轉(zhuǎn)換成目標(biāo)語(yǔ)言文本/語(yǔ)音，大大減輕傳統(tǒng)文本翻譯的讀寫成本，翻譯更輕松

(2) 說(shuō)明

Hi，您好，歡迎使用有道智云語(yǔ)音翻譯iOS SDK。

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

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

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

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

客服QQ：1906538062

智云翻譯技術(shù)交流QQ 1群: 652880659

智云翻譯技術(shù)交流QQ 2群: 669384425

智云翻譯技術(shù)交流QQ 3群: 807539209

智云翻譯技術(shù)交流QQ 4群: 936752411

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

溫馨提示：
本文檔主要針對(duì)開發(fā)人員，接入測(cè)試前需要在后臺(tái)創(chuàng)建iOS應(yīng)用，并綁定語(yǔ)音翻譯實(shí)例；如果您還沒有，請(qǐng)按照新手指南 操作。
平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測(cè)試所用，具體資費(fèi)規(guī)則詳見語(yǔ)音翻譯服務(wù)報(bào)價(jià) 。

功能介紹

有道語(yǔ)音翻譯SDK是有道開放平臺(tái)提供的云服務(wù)之一，是有道在線翻譯接口的一種實(shí)現(xiàn)。有道語(yǔ)音翻譯SDK支持中文與外文（詳見 支持語(yǔ)言）之間的互譯。

兼容性

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

翻譯SDK集成指南

集成前提

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

SDK集成步驟

SDK包導(dǎo)入

翻譯SDK由如下幾個(gè)SDK組成，用戶可根據(jù)需要組合使用：

1.添加頭文件和庫(kù)文件：將 translateSDK 添加到工程中，包括 FanYiSDK.h 頭文件和 libFanYiSDK.a 文件?？梢灾苯訉?translateSDK 文件夾拖動(dòng)到工程中，也可以選擇File “Add files to ‘Project Name’…”

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

3.若使用離線功能，修改工程中任意一個(gè)類后綴名為 .mm，參見 demo 中 ViewController.mm，Xcode 10.0之前的版本需要添加libstc++.6.0.9.tbd，Xcode 10.0及以上版本需要設(shè)置C++ Standard Library為libc++；若未使用離線功能可跳過(guò)此步驟；

4.在工程build Phases – Link Binary With Libraries中添加libFanYiSDK.a, AdSupport.framework, CoreTelephony.framework, SystemConfiguration, libz.tbd和libsqlite3.tbd。如下：

SDK初始化

說(shuō)明：所有的查詢都需要初始化appKey(應(yīng)用ID)，只執(zhí)行初始化一次即可。
注：appKey即應(yīng)用ID

//初始化appKey(應(yīng)用ID)
YDTranslateInstance *yd = [YDTranslateInstance sharedInstance];
yd.appKey = @"your appkey";

功能集成

1.在線語(yǔ)音翻譯功能

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

(1) 使用的庫(kù)文件：頭文件、libbase.a、libspeechtransonline.as；

(2) 構(gòu)造查詢器

YDSpeechOnlineRequest *request = [YDSpeechOnlineRequest request];
YDSpeechOnlineParam *param = [YDSpeechOnlineParam param];
param.from = @"en";//源語(yǔ)言
param.to = @"zh-CHS";//翻譯目標(biāo)語(yǔ)言
param.format = @"wav";//語(yǔ)言文件格式
param.rate = @"8000";//采樣率
param.channel = @"1";//聲道數(shù)，目前只支持單聲道，請(qǐng)寫固定值1
request.param = param;

(3) 將語(yǔ)音數(shù)據(jù)轉(zhuǎn)化為base64編碼

NSData *speechData = [NSData dataWithContentsOfURL:self.recordFileUrl];
NSString *base64Str = [speechData base64EncodedStringWithOptions:0];

(4) 執(zhí)行翻譯過(guò)程。

翻譯返回兩種情況，一種是成功，相關(guān)結(jié)果存儲(chǔ)在 result 參數(shù)中，另外一種是失敗，失敗信息放在 error，可根據(jù) 錯(cuò)誤代碼列表 查詢。整個(gè)識(shí)別是異步的。

[request lookup:base64Str WithCompletionHandler:^(YDSpeechOnlineRequest *request, YDSpeechResult *result, NSError *error) {
    if (error) {
        //失敗
        NSLog(@"error:%@", error);
    }else {
        //成功
        [self handleReuslt:result];
    }
}];

語(yǔ)音翻譯結(jié)果說(shuō)明

對(duì)于在線語(yǔ)音翻譯，服務(wù)器查詢結(jié)果返回?cái)?shù)據(jù)如下：

{
"tSpeakUrl": “[url]“,
"query": "Sorry",
"translation": ["對(duì)不起"],
"errorCode": "0",
"dict": {
"url": "yddict://m.youdao.com/dict?le=eng&q=Sorry"
},
"webdict": {
"url": "http://m.youdao.com/dict?le=eng&q=Sorry"
},
"speakUrl": “[url]“
}

SDK對(duì)上述json數(shù)據(jù)解析封裝為YDSpeechResult對(duì)象，如下

@interface YDSpeechResult : NSObject
/* 翻譯結(jié)果發(fā)音地址，翻譯成功一定存在 */
@property (nonatomic, copy) NSString *tSpeakUrl;
/* 翻譯結(jié)果錯(cuò)誤碼，一定存在 */
@property (nonatomic, copy) NSString *errorCode;
/* 源語(yǔ)言文本，翻譯成功一定存在 */
@property (nonatomic, copy) NSString *query;
/* 翻譯結(jié)果，翻譯成功一定存在 */
@property (nonatomic, strong) NSArray *translation;
/* 詞典deeplink */
@property (nonatomic, strong) NSDictionary *dict;
/* 詞典web deeplink */
@property (nonatomic, strong) NSDictionary *webdict;
/* 源語(yǔ)言發(fā)音地址，翻譯成功一定存在 */
@property (nonatomic, copy) NSString *speakUrl;

+ (instancetype)initWithDict:(NSDictionary *)info;
@end

支持語(yǔ)言

注意

1. 越南語(yǔ)和印尼語(yǔ)目前只支持和中文的互譯。
2. 支持自動(dòng)識(shí)別的語(yǔ)種包括：中文、英文。
3. 格式支持：只支持wav格式。
4. 采樣率：16k。
5. 編碼：16bit位深的單聲道

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

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

(2). 翻譯沒結(jié)果？

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

(3). 添加翻譯 SDK 之后審核沒有通過(guò)？

翻譯 SDK 使用了 AdSupport 框架獲取設(shè)備 IDFA 信息用以統(tǒng)計(jì)計(jì)費(fèi)，提交審核時(shí)對(duì)應(yīng)用是否有廣告選項(xiàng)請(qǐng)選擇“是”。

錯(cuò)誤代碼列表

版本更新記錄