精品女同亚洲欧美精品,亚洲精品中文子幕乱码,国产精品久久久久久久久久辛辛,亚洲欧美日韩国产综合一区二区

幫助與文檔 > 產(chǎn)品文檔 > 自然語(yǔ)言翻譯服務(wù) > IOS_SDK文檔 > 語(yǔ)音翻譯
語(yǔ)音翻譯

語(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í)例;如果您還沒(méi)有,請(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ù)需要組合使用:

文件 說(shuō)明
FanYiSDK.h 頭文件(必選)
libbase.a 語(yǔ)音翻譯相關(guān)sdk基礎(chǔ)庫(kù)(必選)
libspeechtransonline.a 在線語(yǔ)音翻譯 SDK(必選,使用在線語(yǔ)音翻譯時(shí)使用)

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

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

Alt

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

Alt

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

Alt

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]“
}

字段 含義
tSpeakUrl 翻譯結(jié)果發(fā)音地址,翻譯成功一定存在
errorCode 翻譯結(jié)果錯(cuò)誤碼,一定存在
query 源語(yǔ)言文本,翻譯成功一定存在
translation 翻譯結(jié)果,翻譯成功一定存在
dict 詞典deeplink
webdict 詞典web deeplink
speakUrl 源語(yǔ)言發(fā)音地址,翻譯成功一定存在

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ǔ)言

英文名 中文名 代碼
Arabic 阿拉伯語(yǔ) ar
Cantonese 粵語(yǔ) yue
Catalan 加泰隆語(yǔ) ca
Czech 捷克語(yǔ) cs
Danish 丹麥語(yǔ) da
Dutch 荷蘭語(yǔ) nl
English (Australia) 英語(yǔ)(澳大利亞) en-AUS
English (GB) 英語(yǔ)(英國(guó)) en-GBR
English (India) 英語(yǔ)(印度) en-IND
English (US) 英語(yǔ)(美國(guó)) en-USA
Finnish 芬蘭語(yǔ) fi
French 法語(yǔ) fr
French (Canada) 法語(yǔ)(加拿大) fr-CAN
German 德語(yǔ) de
Greek 希臘語(yǔ) el
Hebrew 希伯來(lái)語(yǔ) he
Hindi 印地語(yǔ) hi
Hungarian 匈牙利語(yǔ) hu
Italian 意大利語(yǔ) it
Indonesian 印尼文 id
Japanese 日語(yǔ) ja
Korean 韓語(yǔ) ko
Mandarin (China) 普通話(中國(guó)) zh-CHN
Mandarin (Taiwan) 普通話(中國(guó)臺(tái)灣) zh-TWN
Norwegian 挪威語(yǔ) no
Polish 波蘭語(yǔ) pl
Portuguese (Brazil) 葡萄牙語(yǔ)(巴西) pt-BRA
Portuguese (Portugal) 葡萄牙語(yǔ)(葡萄牙) pt
Romanian 羅馬尼亞語(yǔ) ro
Russian 俄語(yǔ) ru
Slovak 斯洛伐克語(yǔ) sk
Spanish 西班牙語(yǔ) es
Swedish 瑞典語(yǔ) sv
Thai 泰語(yǔ) th
Turkish 土耳其語(yǔ) tr

注意

  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). 翻譯沒(méi)結(jié)果?

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

(3). 添加翻譯 SDK 之后審核沒(méi)有通過(guò)?

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

錯(cuò)誤代碼列表

錯(cuò)誤碼 含義
101 缺少必填的參數(shù)
102 不支持的語(yǔ)言類型
103 翻譯文本過(guò)長(zhǎng)
104 不支持的API類型
105 不支持的簽名類型
106 不支持的響應(yīng)類型
107 不支持的傳輸加密類型
108 應(yīng)用ID無(wú)效,注冊(cè)賬號(hào),登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定,可獲得應(yīng)用ID和應(yīng)用密鑰等信息
109 batchLog格式不正確
110 無(wú)相關(guān)服務(wù)的有效實(shí)例
111 開發(fā)者賬號(hào)無(wú)效
113 q不能為空
201 解密失敗,可能為DES,BASE64,URLDecode的錯(cuò)誤
202 簽名檢驗(yàn)失敗
203 訪問(wèn)IP地址不在可訪問(wèn)IP列表
205 請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致,如有疑問(wèn)請(qǐng)參考入門指南
206 因?yàn)闀r(shí)間戳無(wú)效導(dǎo)致簽名校驗(yàn)失敗
207 重放請(qǐng)求
301 辭典查詢失敗
302 翻譯查詢失敗
303 服務(wù)端的其它異常
401 賬戶已經(jīng)欠費(fèi)停
402 offlinesdk不可用
411 訪問(wèn)頻率受限,請(qǐng)稍后訪問(wèn)
412 長(zhǎng)請(qǐng)求過(guò)于頻繁,請(qǐng)稍后訪問(wèn)
2003 不支持的語(yǔ)音聲道
2004 不支持的語(yǔ)音上傳類型
2005 不支持的語(yǔ)言類型
2006 不支持的識(shí)別類型
2201 識(shí)別音頻文件過(guò)大
2301 識(shí)別音頻時(shí)長(zhǎng)過(guò)長(zhǎng)
2411 不支持的音頻文件類型
2412 不支持的發(fā)音類型
3001 不支持的語(yǔ)音格式
3002 不支持的語(yǔ)音采樣率
3003 不支持的語(yǔ)音聲道
3004 不支持的語(yǔ)音上傳類型
3005 不支持的語(yǔ)言類型
3006 不支持的識(shí)別類型
3007 識(shí)別音頻文件過(guò)大
3008 識(shí)別音頻時(shí)長(zhǎng)過(guò)長(zhǎng)
3009 不支持的音頻文件類型
3010 不支持的發(fā)音類型
3201 解密失敗
3301 語(yǔ)音識(shí)別失敗
3302 語(yǔ)音翻譯失敗
3303 服務(wù)的異常
3411 訪問(wèn)頻率受限,請(qǐng)稍后訪問(wèn)
3412 超過(guò)最大請(qǐng)求字符數(shù)
5001 無(wú)效的OCR類型
5002 不支持的OCR image類型
5003 不支持的語(yǔ)言類型
5004 識(shí)別圖片過(guò)大
5005 不支持的圖片類型
5006 文件為空
5201 解密錯(cuò)誤,圖片base64解密失敗
5301 OCR段落識(shí)別失敗
5411 訪問(wèn)頻率受限
5412 超過(guò)最大識(shí)別流量
-1000 未知錯(cuò)誤
-2000 查詢輸入為空

版本更新記錄

上線日期 版本號(hào) 更新內(nèi)容
2017.05.08 v1.0.0 有道智云翻譯 iOS SDK上線,支持在線離線翻譯
2017.06.07 v1.1.0 1. 拆分翻譯 SDK,SDK 拆分為多個(gè)文件,用戶可根據(jù)需要引用
2. 修復(fù)已知 bug
2017.06.30 v1.2.0 修復(fù)已知 bug
2017.07.24 v1.3.0 1. 修復(fù) deeplink 相關(guān) bug
2017.08.16 v1.4.0 1. 修復(fù)已知 bug
2018.02.09 v1.7.0 支持在線語(yǔ)音翻譯
2018.05.16 v1.7.2 支持在線圖片翻譯