语音识别 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) ,请检查是否是在主线程中调用的翻译识别方法，请确保在主线程调用。

版本更新记录