實時語音識別 Android SDK簡介

概述

(1) 概念解釋

實時語音識別：可實現對連續音頻流的實時識別，轉換成文本信息并返對應文字流

(2) 說明

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

本文檔主要針對需要集成實時語音識別的Android開發工程師，詳細描述實時語音識別能力相關的技術內容。

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

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

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

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

客服QQ：1906538062

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

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

溫馨提示：

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

功能介紹

實時語音識別SDK是對有道實時語音識別接口服務進行封裝。提供快速的接入方式；同時提供數據統計能力，方便了解用戶使用情況。

兼容性

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

實時語音識別SDK集成指南

集成前提

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

集成步驟

(1) SDK包導入

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

dependencies {
    ...
    implementation "android.arch.lifecycle:extensions:1.1.1"
    implementation "android.arch.lifecycle:common-java8:1.1.1"
    implementation "com.squareup.okhttp3:okhttp:3.11.0"
    implementation "com.google.code.gson:gson:2.8.5"
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.3.0"

    implementation files('libs/ydasrsdk-v2.0.2.jar')
}

(2) AndroidManifest配置

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
<uses-permission android:name="android.permission.BLUETOOTH" />

其中 RECORD_AUDIO、WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE 權限需要動態申請，申請權限代碼可見demo代碼所示。

(3) 代碼混淆配置

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

# Gson
-keepattributes Signature
-keepattributes *Annotation*
-keep class sun.misc.Unsafe { *; }
-keep class com.google.gson.stream.** { *; }

#okhttp3
-dontwarn com.squareup.okhttp3.**
-keep class com.squareup.okhttp3.** { *;}
-dontwarn okhttp3.**
-dontwarn okio.**
-dontwarn javax.annotation.**
-dontwarn org.conscrypt.**

#lifecycle
-keep public class android.arch.lifecycle.** {
    public protected *;
}
-keepclassmembers class ** {
    @android.arch.lifecycle.OnLifecycleEvent public *;
}

#kotlin
-dontwarn kotlin.**

#AsrSdk
-keep class com.youdao.ydasr.** { *; }
-keep interface com.youdao.ydasr.** { *; }
-keep class com.youdao.audio.** { *; }
-keep interface com.youdao.audio.** { *; }

功能集成

(1) 創建asr返回接口

private AsrListener mAsrListener = new AsrListener() {
    // 開始識別回調
    @Override
    public void onAsrStart() {}

    // 重連后再次連接成功回調
    @Override
    public void onAsrRestart() {}

    // 結束識別回調
    @Override
    public void onAsrStop() {}

    // 正在重連提示
    @Override
    public void onAsrReconnecting() {}

    // 錯誤回調
    @Override
    public void onAsrError(@NotNull AsrResultCode error) {

    // ASR結果回調， isSentence當前一句是否結束，是否是完整的句子
    @Override
    public void onAsrNext(@NotNull AsrResult result, boolean isSentence) {}

    // 音量變化回調
    @Override
    public void onAsrVolumeChange(float volume) {}

    // 后端點靜音回調
    @Override
    public void onAsrSilentEnd() {}

    // 前端點靜音回調
    @Override
    public void onAsrSilentStart() {}

    // 連接上藍牙麥克風提示
    @Override
    public void onBluetoothAudioConnected() {}

    // 藍牙麥克風斷開提示
    @Override
    public void onBluetoothAudioDisconnected() {}
};

(2) 創建AsrManager

在activity中創建AsrManager，初始化的參數包含appKey(如何獲取見集成前提)并注冊生命周期觀察

mAsrManager = AsrManager.getInstance(this, Consts.AsrAppKey, mAsrListener);
getLifecycle().addObserver(mAsrManager);

(3) 開始識別

Map<String, Object> params = new HashMap<>();
params.put(AsrParams.LANG, mLang);
params.put(AsrParams.SILENT_TIMEOUT_START, 5000L);
params.put(AsrParams.SILENT_TIMEOUT_END, 10000L);
params.put(AsrParams.SENTENCE_TIMEOUT, 3000L);
params.put(AsrParams.CONNECT_TIMEOUT, 10000L);
params.put(AsrParams.WAIT_SERVER_DISCONNECT, true);
mAsrManager.start(params);

注：音頻文件僅支持16k采樣的wav音頻

(4) 停止識別

mAsrManager.stop();

(5) 插入本地數據

Map<String, Object> params = new HashMap<>();
        params.put(AsrParams.LANG, mLang);
        params.put(AsrParams.SILENT_TIMEOUT_START, 5000L);
        params.put(AsrParams.SILENT_TIMEOUT_END, 10000L);
        params.put(AsrParams.SENTENCE_TIMEOUT, 3000L);
        params.put(AsrParams.CONNECT_TIMEOUT, 10000L);
        params.put(AsrParams.WAIT_SERVER_DISCONNECT, true);
mAsrManager.startConnect(params);

然后在asr回掉的onAsrStart中插入本地文件流

mAsrManager.insertAudioBytes(bytes);

識別結果

• 識別結果示例

{
    "result": [{
        "st": [{
            "bg": 30,
            "ed": 480,
            "ws": [{
                "w": "Have",
                "wb": 30,
                "we": 240
            }, {
                "w": "a",
                "wb": 240,
                "we": 270
            }, {
                "w": "good",
                "wb": 270,
                "we": 480
            }, {
                "w": "day.",
                "wb": 480,
                "we": 480
            }]
        }],
        "seg_id": 0
    }],
    "errorCode": "0",
    "action": "recognition"
}

• 識別結果說明

支持語言

錯誤代碼列表

常見問題

錯誤1

• 錯誤說明

null
C:/Users/liuyanyan/.gradle/caches/transforms-1/files-1.1/appcompat-v7-28.0.0.aar/7cbab2e2b4c7701e76fa4d46215a4687/res/values-v28/values-v28.xml
D:/workdir/ydasrDemo
C:/Users/liuyanyan/.gradle/caches/transforms-1/files-1.1/appcompat-v7-28.0.0.aar/7cbab2e2b4c7701e76fa4d46215a4687/res/values/values.xml
null
failed linking references. 

• 解決方案

targetSdkVersion 28
...
dependencies {
    ...
    implementation 'com.android.support:appcompat-v7:28.0.0'
}

錯誤2

• 錯誤說明

null
Default interface methods are only supported starting with Android N (--min-api 24): void android.arch.lifecycle.DefaultLifecycleObserver.onCreate(android.arch.lifecycle.LifecycleOwner)
Stripped invalid locals information from 1 method.
null
com.android.builder.dexing.DexArchiveBuilderException: Failed to process C:\Users\liuyanyan\.gradle\caches\modules-2\files-2.1\android.arch.lifecycle\common-java8\1.1.1\795d68cd761d093ccb235d1d91b8fd17c2ae25ff\common-java8-1.1.1.jar
com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
com.android.tools.r8.CompilationFailedException: Compilation failed to complete
com.android.tools.r8.utils.AbortException

• 解決方案：gradle中增加如下配置

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

其他注意事項

• asr回調方法非主線程的，如果需要在回調中更新UI，需放到主線程中，代碼可見demo.
• 權限及動態權限一定要添加否則可能導致無反應
• 依賴包也必須都添加，否則可能導致無反應或崩潰問題

版本更新記錄