語音評測 Android SDK簡介

概述

(1) 概念解釋

語音評測：通過技術自動對發音水平進行不同維度下的評價，給出用戶發音信息和得分詳情。

(2) 說明

Hi，您好，歡迎使用有道智云語音評測Android SDK。

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

本文檔主要針對需要集成 語音評測 Android SDK的開發工程師，詳細描述語音評測能力及集成過程。

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

商務郵箱： 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 的子目錄(有的話則不需要創建)，并將YoudaoBase.jar和youdaoSpeechEvaluate.jar拷貝到 libs 目錄下，并將以下代碼添加到app的build.gradle中：

dependencies {
    compile files('libs/YoudaoBase_v2.0.0.jar')
    compile files('libs/YoudaoSpeechEvaluate_v2.0.0.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.ACCESS_WIFI_STATE" />

(3) 代碼混淆配置

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

#Sdk
-ignorewarnings
-libraryjars libs/YoudaoBase_v2.0.0.jar
-keep class com.youdao.sdk.** { *;}

-libraryjars libs/YoudaoSpeechEvaluate_v2.0.0.jar
-keep class youdao.com.yd_speech_evaluator.**{*;}

(4) SDK初始化

使用圖片翻譯SDK，請在程序的Application中調用SDK初始化代碼，可以參考demo中DemoApplication。

YouDaoApplication.init(this, appkey);

功能集成

說明：請參考 demo 中 SpeechEvaluatorView 的使用，詳細見類中evaluation方法。

(1) 參數說明

格式支持：wav（不壓縮、pcm編碼）

采樣率：推薦16k。

編碼：16bit位深的單聲道

channel:只支持單聲道固定值為1

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

(2) 構造語音評測對象

private SpEvaParameters mSpEvaParameters = new SpEvaParameters.Builder()
            .channel(CHANNEL)
            .language(SpEvaLanguage.ENGLISH)
            .rate(RATE)
            .timeout(100000)
            .format(FORMAT)
            .build();

(3) 設置回調和開始翻譯

通過SpeechEvaluate，設置上一步構造的查詞對象，調用evaluate方法傳入圖片base64編碼的數據和回調接口開始評測。

識別回調接口包含兩個方法：onResult表示識別成功，相關結果存儲在result參數中；onError表示失敗，將int類型錯誤碼回調給用戶。錯誤詳細信息可見于 錯誤代碼列表 。

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

SpeechEvaluate.getInstance(mSpEvaParameters).evaluate(bases64, mEvaluateText, new SpEvaListener() {
    @Override
    public void onError(int errorCode) {
        final String errorString = SpEvaErrorCode.getErrorString(errorCode);
        YouDaoLog.e(errorString);
        mHandler.post(new Runnable() {
            @Override
            public void run() {
                ToastUtils.show(errorString);
            }
        });
    }

    @Override
    public void onResult(final SpEvaResult result, final String input) {
        if (result != null) {
            mHandler.post(new Runnable() {
                @Override
                public void run() {
                    updateResultView(result);
                }
            });
        }
    }
});

支持語言

目前支持英文的語音評測。

錯誤代碼列表

##常見問題及解決方案

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

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

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

版本更新記錄