語音識別 Android SDK 簡介

概述

(1) 概念解釋

短語音識別：將一段不超過15秒的語音轉換成文本，將音頻文件中的文字信息識別出來，代替傳統輸入場景。

(2) 說明

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

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

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

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

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

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

客服QQ：1906538062

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

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

溫馨提示：

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

功能介紹

有道短語音識別sdk是對有道的短語音識別服務的封裝。提供識別類SpeechTranslate，您只需要通過調用sdk接口，傳入待識別的音頻文件和格式，即可進行語音的識別。

兼容性

支持設備：運行了 Android 4.0.3以及以上系統的 Android 設備

短語音識別SDK集成指南

集成前提

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

語音識別sdk由如下sdk組成：

集成步驟

(1) SDK包導入

請在工程文件根目錄下創建一個名為 libs 的子目錄(有的話則不需要創建)，并將YoudaoBase_v2.0.0.jar so包和YoudaoVoiceRecognize_v2.0.0.jar拷貝到 libs 目錄下，并將以下代碼添加到app的build.gradle中：

android {
    sourceSets.main.jniLibs.srcDirs = ['libs']
    ...
}
dependencies {
    compile files('libs/YoudaoBase_v2.0.0.jar')
    compile files('libs/YoudaoVoiceRecognize_v2.0.0.jar')
}

(2) AndroidManifest配置

添加權限

<uses-permission android:name="android.permission.INTERNET" />
<!-- 獲取WiFi狀態 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 獲取網絡信息狀態，如當前的網絡連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 讀取手機狀態 phone group -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 往SDCard讀寫數據權限   storage group -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

(3) 代碼混淆配置

代碼混淆文件proguard-project.txt，添加如下內容：

-ignorewarnings
-libraryjars libs/YoudaoBase_v2.0.0.jar
-libraryjars libs/YoudaoVoiceRecognize_v2.0.0.jar

-keep class com.youdao.sdk.ydtranslate.** { *;}
-keep class com.youdao.voicerecognize.online.** { *;}

(4) SDK初始化

使用短語音識別SDK，請在程序的Application中調用SDK初始化代碼，可以參考demo中DemoApplication。

YouDaoApplication.init(this, appkey);

功能集成

說明：請參考 demo 中 RecognizeDemoActivity 的使用

(1) 參數說明

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

source：設置為app對應的名稱（英文字符串）

注意：輸入語音數據需要轉換為Base64編碼。

(2) 構造短語音識別輸入對象

     //輸入音頻為WAV格式
      ASRParameters tps = new ASRParameters.Builder()
                .source("youdaoocr")
                .timeout(100000)
                .lanType(Language.ENGLISH.getCode())//langType支持中文和英文
                .rate(Constants.RATE_8000)
                .build();

(3) 設置回調和開始識別

通過SpeechTranslate，設置上一步構造的查詞對象，調用lookup方法傳入語音base64編碼的數據和回調接口開始查詢，方法中最后一個參數"requestId"，SDK并未使用，在回調中會再返回給開發者，用于區分每次調用，開發者可傳null或者任意字符串。

識別回調接口包含兩個方法：onResult表示識別成功，相關結果存儲在result參數中，onError表示失敗，失敗信息可根據錯誤碼通過 錯誤代碼列表 查看。

注意：整個識別是異步的，回調在子線程進行，若涉及到界面操作，請切回主線程。

SpeechTranslate.getInstance(tps).recognize(bases64,"requestId"
                new ASRListener() {
                     @Override
                    public void onResult(final ASRResult result, String input, String requestid) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                if(result.getResult() != null && result.getResult().size() > 0){
                                    resultText.setText("識別完成:" +result.getResult().get(0));
                                }else{
                                    resultText.setText("未知錯誤");
                                }
                            }
                        });
                    }

                    @Override
                    public void onError(final ASRErrorCode error, String requestid) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                resultText.setText("識別失敗" + error.toString());
                            }
                        });
                    }
                }, "requestid");

語音識別結果說明

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

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

支持語言

錯誤代碼列表

常見問題及注意事項

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

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

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

4.出現錯誤HTTP_REQUEST_ERROR("Http requesterror.",1) 在確保有網情況下，若調用過程中出現這個錯誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請檢查是否是在主線程中調用的翻譯識別方法，請確保在主線程調用。

版本更新記錄