短語音識別 IOS SDK簡介

概述

(1) 概念解釋

短語音識別：將一段不超過15秒的語音轉換成文本，將音頻文件中的文字信息識別出來，代替?zhèn)鹘y(tǒng)輸入場景

(2) 說明

Hi，您好，歡迎使用有道智云短語音識別iOS SDK。

如果您想快速體驗服務，建議您前往 語音識別體驗中心 或者在體驗中心右下側找到小程序二維碼，掃描進行體驗。

本文檔主要針對需要集成短語音識別服務iOS SDK的開發(fā)工程師，詳細描述有道智云短語音識別能力及集成過程。

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

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

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

客服QQ：1906538062

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

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

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

短語音識別SDK集成指南

集成前提

開始集成SDK之前開發(fā)者需要登錄 有道智云平臺 ，創(chuàng)建應用獲取應用ID（或者通過運營人員獲取應用ID），以便使用識別服務。

語音識別 SDK 由如下幾個 SDK 組成，用戶可根據(jù)需要組合使用：

1. FanYiSDK.h：頭文件（必選）
2. libbase.a：語音識別相關sdk基礎庫（必選）
3. libspeechrecognition.a：在線語音識別 SDK（必選，使用在線語音識別時使用）

集成步驟

SDK包導入

語音識別 SDK 由如下幾個 SDK 組成:FanYiSDK.h、libbase.a、libspeechrecognition.a；

(1). 添加頭文件和庫文件：將語音識別 SDK 添加到工程中，包括 FanYiSDK.h頭文件、libbase.a和libspeechrecognition.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，只執(zhí)行初始化一次即可。

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

功能集成

說明：支持最長15秒的短語音在線識別功能，請參考 demo 中 SpeechRecognitionViewController 的使用；

參數(shù)說明

-格式支持：wav（不壓縮，pcm編碼，采樣率：推薦16k ，編碼：16bit位深的單聲道），aac，mp3

構造查詢器

YDSpeechRecognitionRequest *request = [YDSpeechRecognitionRequest request];
YDSpeechRecognitionParam *param = [YDSpeechRecognitionParam param];
param.langType = @"zh-CHS";//源語言
param.rate = @"8000";//采樣率
param.channel = @"1";//聲道數(shù)，目前只支持單聲道，請寫固定值1
request.param = param;

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

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

執(zhí)行識別過程

識別返回兩種情況，一種是成功，相關結果存儲在 result 參數(shù)中，另外一種是失敗，失敗信息放在 error，是一個枚舉類。

[request lookup:base64Str WithCompletionHandler:^(YDSpeechRecognitionRequest *request, YDSpeechRecognitionResult *result, NSError *error) {
if (error) {
//失敗
NSLog(@"error:%@", error);
}else {
//成功
[self handleReuslt:result];
}
}];

語音識別結果說明

對于在線語音識別，服務器查詢結果返回數(shù)據(jù)如下：

{
    "result": [
        "今天天氣不錯"    //識別結果
    ],  
    "errorCode": "0",   //錯誤碼。一定存在
}

SDK demo對上述json數(shù)據(jù)解析封裝為YDSpeechRecognitionResult對象，如下：

@interface YDSpeechRecognitionResult : NSObject
/* 識別結果 */
@property (nonatomic, copy) NSArray *result;
/* 翻譯結果錯誤碼，一定存在 */
@property (nonatomic, copy) NSString *errorCode;

+ (instancetype)initWithDict:(NSDictionary *)info;
@end

支持語言

錯誤代碼列表

常見問題及注意事項

1. 運行程序崩潰？

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

2. 翻譯沒結果？

       檢查下識別接口回調的錯誤信息，保證申請的應用ID是有效且提前綁定了。
   

3. 如何獲得應用ID

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