语音评测 IOS SDK简介

概述

(1) 概念解释

语音评测：通过语音评测技术自动对发音水平进行不同维度下的评价，给出用户发音信息和得分详情。

(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 设备

语音评测SDK 集成指南

集成前提

开始集成SDK之前开发者需要登录 有道智云平台，创建应用获取应用ID（或者通过运营人员获取应用ID），以便使用评测服务。

集成步骤

SDK包导入

语音评测 SDK 由如下几个 SDK 组成：FanYiSDK.h、libbase.a、libSpeechEvaluation.a；

(1). 添加头文件和库文件：将语音评测 SDK 添加到工程中，包括 FanYiSDK.h头文件、libbase.a和libSpeechEvaluation.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初始化

说明：所有的查询都需要初始化key，只执行初始化一次即可。

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

功能集成

说明：支持在线语音评测,目前只支持英语评测,请参考 demo 中 SpeechEvaluationController 的使用;

参数说明

格式支持：只支持wav格式。

采样率：推荐16k。

编码：16bit位深的单声道

构造查询器

YDSpeechEvaluationRequest *request = [YDSpeechEvaluationRequest request];
YDSpeechEvaluationParam *param = [YDSpeechEvaluationParam param];
param.langType = @"en";//目前只支持英语评测
param.rate = @"16000";//采样率
param.channel = @"1";//声道数，目前只支持单声道，请写固定值1
request.param = param;

将语音数据转化为base64编码

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

执行识别过程

查询输入为语音录音文件base64的字符串，返回结果回调在block中，若成功返回则info包含了返回的所有json数据，开发者可自定义model对返回的info数据进行解析；

[request lookup:base64Str text:refText completionHandler:^(YDSpeechEvaluationRequest *request, NSDictionary *info, NSError *error) {
  if (!error) {
    NSLog(@"%@", info);
    YDSpeechEvaluationResult *result = [YDSpeechEvaluationResult mj_objectWithKeyValues:info];
    [self showResult:result];
  }
}];

支持语言

错误代码列表

常见问题及注意事项

(1). 运行程序崩溃？

检查下是否对应的 SDK静态库包 是否放到当前工程目录下。

(2). 语音评测没结果？

检查下语音评测接口回调的错误信息，保证申请的 应用ID 是有效且提前绑定了。

(3). 如何获得 应用ID

注册账号，登录后台创建应用和实例并完成绑定， 可获得应用ID和应用密钥等信息。

版本更新记录