一. 概述

DUI Lite SDK 离线ASR++可在无网的情况下，提供根据声音特征信息识别出 情绪信息的能力。

二. SDK使用说明

使用当前功能时，请先授权，否则禁止使用。请参考 授权说明。

2.1 离线ASR++识别

2.1.1 准备

jar：DUI-lite-SDK-for-Android-x.x.x.jar

so：libca.so(授权模块)， libasrpp.so(离线ASR++模块)，libduiutils.so(通用处理模块)，libvad.so(vad模块)，libduidns.so(dns解析模块)

资源：(资源可以放在assets目录中，也可以自己手动放在磁盘中，比如/sdcard/)

vad_xxx.bin （本地vad资源）

asrpp_xxx.bin（性别、情绪、年龄识别资源）！注意：如果资源只包含 性别 识别，那 sdk 回调结果就只返回性别信息

asr++ 可以根据声音特征信息识别出 性别、情绪、年龄 信息的能力，具体识别的是哪种能力只与加载的资源有关，代码是一样的。即 性别资源识别性别的信息，年龄资源识别年龄的信息

如需同时识别  性别、情绪、年龄 ，可以创建多个 asr++ 对象，加载不同资源即可。

2.1.2 使用流程

1. 创建引擎对象，创建引擎对象方法： createInstance （多实例）
2. 初始化引擎，调用 init 方法
3. 启动引擎，调用 start 方法
4. 默认使用Android的录音机获取音频数据，如需自行输入音频数据，可以使用 feedData 方法
5. 此时引擎内部处理音频数据中，有识别出性别、年龄等信息或其它错误信息会从回调中返回。
6. 停止引擎，调用 stop 方法
7. 停止引擎后可以调用 start 方法重新启动引擎
8. 销毁引擎，调用 destroy方法

三. 示例代码

涉及引擎类：AILocalAsrppEngine，详细使用示例请参考 demo

3.1 设置配置信息

参考代码

AILocalAsrppConfig config = new AILocalAsrppConfig();
config.setAsrppResource(SampleConstants.ASRPP_RES);
config.setVadEnable(true);
config.setVadResource(SampleConstants.VAD_RES);
config.setVadPauseTime(500);

部分方法参数说明

以上方法均有配套的get和is判断方法，比如说isVadEnable()获取当前vadEnable状态，getVadResource()获取vad资源路径，请根据需要自行使用。

完整的方法说明可以参考 Javadoc

3.2 初始化识别engine

// 详细示例可参见 Demo 里的 LocalAsrpp.java
AILocalAsrppEngine mAsrppEngine;
mAsrppEngine = AILocalAsrppEngine.createInstance();
mAsrppEngine.init(config, new AILocalAsrppListenerImpl());

以下是 AILocalAsrppEngine 的方法说明。

3.3 实现ASRPP回调方法

    /**
     * 引擎回调接口，用以接收相关事件
     */
    public class AILocalAsrppListenerImpl implements AILocalAsrppListener {

        @Override
        public void onBeginningOfSpeech() {
            showInfo("检测到说话");

        }

        @Override
        public void onEndOfSpeech() {
            showInfo("检测到语音停止，开始识别...");
        }

        @Override
        public void onReadyForSpeech() {
            showInfo("请说话...");
        }

        @Override
        public void onRmsChanged(float rmsdB) {
            showTip("RmsDB = " + rmsdB);
        }

        @Override
        public void onError(AIError error) {
            Log.d(TAG, error.toString());
            showInfo(error.toString());
            setAsrBtnState(true, "识别");
        }

        @Override
        public void onResults(AIResult results) {
            Log.i(TAG, results.toString());
            try {
                showInfo(new JSONObject(results.getResultObject().toString()).toString());
            } catch (JSONException e) {
                e.printStackTrace();
            }
            setAsrBtnState(true, "识别");
        }

        @Override
        public void onInit(int status) {
            if (status == 0) {
                Log.i(TAG, "end of init asr engine");
                showInfo("识别引擎加载成功");
                setAsrBtnState(true, "识别");
            } else {
                showInfo("识别引擎加载失败");
            }
        }


        @Override
        public void onResultDataReceived(byte[] buffer, int size) {
        }

        @Override
        public void onRawDataReceived(byte[] buffer, int size) {

        }

    }

3.4 设置intent并启动识别引擎

AILocalAsrppIntent aiLocalAsrppIntent = new AILocalAsrppIntent();
aiLocalAsrppIntent.setNoSpeechTimeOut(0);
aiLocalAsrppIntent.setMaxSpeechTimeS(0);
mAsrppEngine.start(aiLocalAsrppIntent);

部分intent方法如下表，仅总结部分set方法，对应的get与状态判断is方法不再这里列出，请参考Javadoc

3.5 引擎的停止与销毁

mAsrppEngine.stop();
mAsrppEngine.destroy();

在识别完成之后请在合适的位置调用这两个方法。

3.6 完整的代码块

可以直接参考下方代码进行自己的使用，更多api请参考 Javadoc

// 详细示例可参见 Demo 里的 LocalAsrpp.java
AILocalAsrppEngine mAsrppEngine;


AILocalAsrppConfig config = new AILocalAsrppConfig();
config.setAsrppResource(SampleConstants.ASRPP_RES);
config.setVadEnable(true);
config.setVadResource(SampleConstants.VAD_RES);
config.setVadPauseTime(500);

mAsrppEngine = AILocalAsrppEngine.createInstance();
mAsrppEngine.init(config, new AILocalAsrppListenerImpl());


AILocalAsrppIntent aiLocalAsrppIntent = new AILocalAsrppIntent();
aiLocalAsrppIntent.setNoSpeechTimeOut(0);
aiLocalAsrppIntent.setMaxSpeechTimeS(0);
mAsrppEngine.start(aiLocalAsrppIntent);


mAsrppEngine.stop();
mAsrppEngine.destroy();

在 init 和 start 时会有很多参数设置，Demo 已经为常见情况做了示例，详细说明请查看 JavaDoc

四. 日志信息介绍

查看 asr++ 的日志信息，可以在 logcat 种过滤以下信息：

AILocalAsrppEngine   LocalAsrppProcessor   AsrppKernel

五. 识别结果

5.1 字段说明

libversion

1.9.37

binversion

asrpp_common_2019010

delay

948.688721

speech

152960

coreversion

2.0

emotion

{
        "emotion":"happy",
        "libversion":"1.0.0",
        "delay":"800.932617",
        "binversion":"emotion_common_20181227"
    }

gender

{
        "gender":"male",
        "libversion":"1.0.0",
        "delay":"50.847900",
        "binversion":"gender_common_20190110_male_female"
    }

age

{
        "age":"elder",
        "libversion":"1.0.0",
        "delay":"135.515625",
        "binversion":"age_common_20190108"
    }

5.1.1 emotion字段

libversion

1.0.0

delay

800.932617

binversion

emotion_common_20181227

5.1.2 gender字段

libversion

1.0.0

delay

50.847900

binversion

gender_common_20190110_male_female

5.1.3 age字段

child

adult 

elder

libversion

1.0.0

delay

135.515625

binversion

age_common_20190108

5.2 例子

{
    "libversion":"1.9.37",
    "binversion":"asrpp_common_2019010",
    "delay":"948.688721",
    "speech":"152960",
    "coreversion":"2.0",
    "emotion":{
        "emotion":"happy",
        "libversion":"1.0.0",
        "delay":"800.932617",
        "binversion":"emotion_common_20181227"
    },
    "gender":{
        "gender":"male",
        "libversion":"1.0.0",
        "delay":"50.847900",
        "binversion":"gender_common_20190110_male_female"
    },
    "age":{
        "age":"elder",
        "libversion":"1.0.0",
        "delay":"135.515625",
        "binversion":"age_common_20190108"
    }
}

六. 错误码

错误码

七. 接口文档

更多的接口内容与描述请参阅 javadoc