語音評(píng)測(cè) IOS SDK簡介

概述

(1) 概念解釋

語音評(píng)測(cè)：通過語音評(píng)測(cè)技術(shù)自動(dòng)對(duì)發(fā)音水平進(jìn)行不同維度下的評(píng)價(jià)，給出用戶發(fā)音信息和得分詳情。

(2) 說明

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

本文檔主要針對(duì)需要集成 語音評(píng)測(cè) IOS SDK的開發(fā)工程師，詳細(xì)描述語音評(píng)測(cè)能力及集成過程。

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

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

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

客服QQ：1906538062

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

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

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

功能介紹

有道智云語音評(píng)測(cè) SDK 是有道智云開放平臺(tái)提供的云服務(wù)之一，是有道在線語音評(píng)測(cè)接口的一種實(shí)現(xiàn)，支持在線語音評(píng)測(cè)。

兼容性

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

語音評(píng)測(cè)SDK 集成指南

集成前提

開始集成SDK之前開發(fā)者需要登錄 有道智云平臺(tái)，創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過運(yùn)營人員獲取應(yīng)用ID），以便使用評(píng)測(cè)服務(wù)。

集成步驟

SDK包導(dǎo)入

語音評(píng)測(cè) SDK 由如下幾個(gè) SDK 組成：FanYiSDK.h、libbase.a、libSpeechEvaluation.a；

(1). 添加頭文件和庫文件：將語音評(píng)測(cè) SDK 添加到工程中，包括 FanYiSDK.h頭文件、libbase.a和libSpeechEvaluation.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初始化

說明：所有的查詢都需要初始化key，只執(zhí)行初始化一次即可。

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

功能集成

說明：支持在線語音評(píng)測(cè),目前只支持英語評(píng)測(cè),請(qǐng)參考 demo 中 SpeechEvaluationController 的使用;

參數(shù)說明

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

采樣率：推薦16k。

編碼：16bit位深的單聲道

構(gòu)造查詢器

YDSpeechEvaluationRequest *request = [YDSpeechEvaluationRequest request];
YDSpeechEvaluationParam *param = [YDSpeechEvaluationParam param];
param.langType = @"en";//目前只支持英語評(píng)測(cè)
param.rate = @"16000";//采樣率
param.channel = @"1";//聲道數(shù)，目前只支持單聲道，請(qǐng)寫固定值1
request.param = param;

將語音數(shù)據(jù)轉(zhuǎn)化為base64編碼

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

執(zhí)行識(shí)別過程

查詢輸入為語音錄音文件base64的字符串，返回結(jié)果回調(diào)在block中，若成功返回則info包含了返回的所有json數(shù)據(jù)，開發(fā)者可自定義model對(duì)返回的info數(shù)據(jù)進(jìn)行解析；

[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];
  }
}];

支持語言

錯(cuò)誤代碼列表

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

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

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

(2). 語音評(píng)測(cè)沒結(jié)果？

檢查下語音評(píng)測(cè)接口回調(diào)的錯(cuò)誤信息，保證申請(qǐng)的 應(yīng)用ID 是有效且提前綁定了。

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

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

版本更新記錄