語音評測 Android SDK簡介

概述

(1) 概念解釋

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

(2) 說明

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

如果您想快速體驗(yàn)服務(wù)，建議您前往 語音評測體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

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

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

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

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

客服QQ：1906538062

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

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

溫馨提示：

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

功能介紹

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

兼容性

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

短語音識別SDK集成指南

集成前提

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

集成步驟

(1) SDK包導(dǎo)入

請?jiān)诠こ涛募夸浵聞?chuàng)建一個(gè)名為 libs 的子目錄(有的話則不需要?jiǎng)?chuàng)建)，并將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，添加如下內(nèi)容：

#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，請?jiān)诔绦虻腁pplication中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication。

YouDaoApplication.init(this, appkey);

功能集成

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

(1) 參數(shù)說明

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

采樣率：推薦16k。

編碼：16bit位深的單聲道

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

注意：輸入語音數(shù)據(jù)需要轉(zhuǎn)換為Base64編碼。

(2) 構(gòu)造語音評測對象

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

(3) 設(shè)置回調(diào)和開始翻譯

通過SpeechEvaluate，設(shè)置上一步構(gòu)造的查詞對象，調(diào)用evaluate方法傳入圖片base64編碼的數(shù)據(jù)和回調(diào)接口開始評測。

識別回調(diào)接口包含兩個(gè)方法：onResult表示識別成功，相關(guān)結(jié)果存儲在result參數(shù)中；onError表示失敗，將int類型錯(cuò)誤碼回調(diào)給用戶。錯(cuò)誤詳細(xì)信息可見于 錯(cuò)誤代碼列表 。

注意：整個(gè)識別是異步的，回調(diào)在子線程進(jìn)行，若涉及到界面操作，請切回主線程。

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);
                }
            });
        }
    }
});

支持語言

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

錯(cuò)誤代碼列表

常見問題及解決方案

1.運(yùn)行程序崩潰？
檢查下是否對應(yīng)的 so 是否放到當(dāng)前工程目錄下。

2.語音評測沒結(jié)果？
檢查下接口回調(diào)的錯(cuò)誤信息，保證申請的應(yīng)用ID是有效且提前綁定了。

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

版本更新記錄