語音翻譯 IOS SDK 簡介

概述

(1) 概念解釋

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

(2) 說明

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

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

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

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

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

客服QQ：1906538062

智云翻譯技術交流QQ 1群: 652880659

智云翻譯技術交流QQ 2群: 669384425

智云翻譯技術交流QQ 3群: 807539209

智云翻譯技術交流QQ 4群: 936752411

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

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

功能介紹

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

兼容性

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

翻譯SDK集成指南

集成前提

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

SDK集成步驟

SDK包導入

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

1.添加頭文件和庫文件：將 translateSDK 添加到工程中，包括 FanYiSDK.h 頭文件和 libFanYiSDK.a 文件。可以直接將 translateSDK 文件夾拖動到工程中，也可以選擇File “Add files to ‘Project Name’…”

2.設置工程 Other Linker Flags 為 -ObjC

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

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

SDK初始化

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

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

功能集成

1.在線語音翻譯功能

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

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

(2) 構造查詢器

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

(3) 將語音數(shù)據(jù)轉化為base64編碼

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

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

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

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

語音翻譯結果說明

對于在線語音翻譯，服務器查詢結果返回數(shù)據(jù)如下：

{
"tSpeakUrl": “[url]“,
"query": "Sorry",
"translation": ["對不起"],
"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對上述json數(shù)據(jù)解析封裝為YDSpeechResult對象，如下

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

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

支持語言

注意

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

(1). 運行程序崩潰？

檢查下是否對應的 SDK靜態(tài)庫包 是否放到當前工程目錄下。

(2). 翻譯沒結果？

檢查下翻譯接口回調的錯誤信息，保證申請的應用ID是有效且提前綁定了。

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

翻譯 SDK 使用了 AdSupport 框架獲取設備 IDFA 信息用以統(tǒng)計計費，提交審核時對應用是否有廣告選項請選擇“是”。

錯誤代碼列表

版本更新記錄