语音评测 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和应用密钥等信息。

版本更新记录