有道智云实时语音翻译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 信息用以统计计费，提交审核时对应用是否有广告选项请选择“是”。
   

版本更新记录