有道智云實時語音翻譯SDK 簡介

概述

(1) 概念解釋

實時語音翻譯：可實現對連續音頻流的實時識別，實時識別和翻譯a語音輸入的內容，轉換成文本信息并返回對應文字流。

(2) 說明

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

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

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

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

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

客服QQ：1906538062

智云語音技術交流QQ群：861723255

聯系郵箱： zhiyun@corp.youdao.com

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

###功能介紹

有道智云實時語音翻譯 SDK 是有道智云開放平臺提供的云服務之一，是有道在線實時語音翻譯接口的一種實現，支持在線實時語音翻譯。

###兼容性

支持設備：運行了iOS 8.0及以上系統的 iOS 設備

實時語音翻譯 IOS SDK集成指南

集成前提

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

集成步驟

SDK包導入

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

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

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

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

SDK初始化

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

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

功能集成

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

1. 參數說明 格式支持：只支持wav格式。

采樣率：16k。

編碼：16bit位深的單聲道

2. 構造識別器

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

3. 執行識別過程

執行[self.translate startListening];開始實時語音翻譯，結果將在代理方法中回調給開發者；

#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 ? @"前端點" : @"后端點");
}

4. 識別結果說明

支持語言

錯誤代碼列表

常見問題及注意事項

1. 運行程序崩潰？ 檢查下是否對應的 SDK靜態庫包 是否放到當前工程目錄下。

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

3. 如何獲得應用ID 注冊賬號，登錄后臺創建應用和實例并完成綁定， 可獲得應用ID和應用密鑰等信息。

4. 添加翻譯 SDK 之后審核沒有通過？ 翻譯 SDK 使用了 AdSupport 框架獲取設備 IDFA 信息用以統計計費，提交審核時對應用是否有廣告選項請選擇“是”。

版本更新記錄