有道智云實(shí)時語音翻譯SDK 簡介

概述

(1) 概念解釋

實(shí)時語音翻譯：可實(shí)現(xiàn)對連續(xù)音頻流的實(shí)時識別，實(shí)時識別和翻譯a語音輸入的內(nèi)容，轉(zhuǎn)換成文本信息并返回對應(yīng)文字流。

(2) 說明

Hi，您好，歡迎使用有道智云實(shí)時語音翻譯iOS SDK。如果您想快速體驗(yàn)服務(wù)，建議您前往 實(shí)時語音翻譯體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

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

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

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

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

客服QQ：1906538062

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

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

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

功能介紹

有道智云實(shí)時語音翻譯 SDK 是有道智云開放平臺提供的云服務(wù)之一，是有道在線實(shí)時語音翻譯接口的一種實(shí)現(xiàn)，支持在線實(shí)時語音翻譯。

兼容性

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

實(shí)時語音翻譯 IOS SDK集成指南

集成前提

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

集成步驟

SDK包導(dǎo)入

實(shí)時語音翻譯 SDK 由如下幾個 SDK 組成，YDStreamSpeechTrans.h、base.h 、libbase.a、libStreamSpeechTrans.a

(1). 添加頭文件和庫文件：將實(shí)時語音翻譯 SDK 添加到工程中，包括 YDStreamSpeechTrans.h 和 base.h 頭文件、libbase.a和libStreamSpeechTrans.a文件。

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

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

SDK初始化

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

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

功能集成

說明：支持實(shí)時實(shí)時語音翻譯，目前支持多達(dá)80余種語言的相互翻譯，請參考 demo 中 StreamSpeechTransVController 的使用，其語言的代碼可參考本文檔支持語言列表中的內(nèi)容，其已經(jīng)在base.h中的YDOnlineLanguageTool類中被封裝好，可以選擇自定義或直接使用;

1. 參數(shù)說明
格式支持：只支持wav格式。

采樣率：16k。

編碼：16bit位深的單聲道

2. 構(gòu)造識別器

YDSpeechTranslate *translate = [YDSpeechTranslate sharedTranslate];
translate.delegate = self;
YDSpeechTranslateParam *param = [YDSpeechTranslateParam param];
param.from = @"zh-CHS";//源語言類型,目前支持多達(dá)80余種
param.to = @"en";//目標(biāo)語言類型,目前支持多達(dá)80余種。  注：中英混合和粵語不能作為to
param.rate = @"16000";//采樣率
param.format = @"wav";//語音文件格式
param.vadBOS = 2000;//前端點(diǎn)靜音檢測時長,ms
param.vadEOS = 2000;//后端點(diǎn)靜音檢測時長,ms
translate.delegate = param;

3. 執(zhí)行識別過程

執(zhí)行[self.translate startListening];開始實(shí)時語音翻譯，結(jié)果將在代理方法中回調(diào)給開發(fā)者；

#pragma mark - YDSpeechTranslateDelegate
- (void)onBeginOfSpeech {
  [self startSpeakingAnimation];
  NSLog(@"------speech start-----");
}

- (void)onEndOfSpeech {
  [self endSpekingAnimation];
  NSLog(@"------speech end-----");
}

- (void)onResults:(NSDictionary *)result {
    NSString *context = result[@"context"];
    NSString *tranContent = result[@"tranContent"];
    BOOL isPartial = [result[@"partial"] boolValue];

    NSString *showContext = [NSString stringWithFormat:@"%@%@", self.displayingText, context];
    NSString *showTranContent = [NSString stringWithFormat:@"\n\n%@%@", self.displayingTranText, tranContent];

    NSMutableAttributedString *contextAtt = [self getShowText:showContext textColor:[UIColor grayColor] font:[UIFont systemFontOfSize:13]];
    NSMutableAttributedString *tranContentAtt = [self getShowText:showTranContent textColor:[UIColor blackColor] font:[UIFont boldSystemFontOfSize:15]];

    [contextAtt appendAttributedString:tranContentAtt];

    self.recognizedTV.attributedText = contextAtt;

    if (!isPartial) {
        [self.displayingText appendString:context];
        [self.displayingTranText appendString:tranContent];
    }
}

- (void)onCompleted:(NSError *)speechError {
  [self endSpekingAnimation];
  NSLog(@"------speech completed-----");
}

- (void)onConstantlyQuietIsBOS:(BOOL)isBOS {
  NSLog(@"檢測到%@靜音", isBOS ? @"前端點(diǎn)" : @"后端點(diǎn)");
}

4. 識別結(jié)果說明

支持語言

錯誤代碼列表

常見問題及注意事項(xiàng)

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

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

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

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

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

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

4. 添加翻譯 SDK 之后審核沒有通過？

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

版本更新記錄