集成指南

更新时间：2021-12-17

DEMO 中已经集成了 SDK。您可以参考DEMO，集成SDK。
集成前，请先测通DEMO，了解调用原理。
如果您自己代码过于复杂，可以使用一个helloworld项目了解集成过程。
DEMO目录下的doc_integration_DOCUMENT的目录中有图文集成教程。

本文以Android Studio 作为示例

集成时请确认已经复制或者修改了以下文件，一共4步：

AndroidManifest.xml
app/libs/bdasr_V3_xxxxx_xxxxx.jar
app/src/main/jniLibs 下armeabi等5个目录
官网申请应用时的包名与build.gradle里一致，demo的包名是"com.baidu.speech.recognizerdemo"。这步没做会导致离线命令词或者唤醒报“no licence” 错误
运行时 getApplicationInfo().nativeLibraryDir 目录下查看是否有完整so文件。特别是系统app需要手动push so文件到这个目录下。

AndroidManifest.xml 文件

设置权限

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

SDK授权必须设置APP_ID, APP_SN

建议代码里直接传入APP_ID, APP_SN，请参考在线识别具体功能参数- 鉴权信息部分，填写这2个鉴权信息。

android 6.0 以上版本权限申请

以下代码可以在demo中查找

/**
 * android 6.0 以上需要动态申请权限
 */
private void initPermission() {
    String permissions[] = {Manifest.permission.RECORD_AUDIO,
            Manifest.permission.ACCESS_NETWORK_STATE,
            Manifest.permission.INTERNET,
            Manifest.permission.WRITE_EXTERNAL_STORAGE
    };

    ArrayList<String> toApplyList = new ArrayList<String>();

    for (String perm :permissions){
        if (PackageManager.PERMISSION_GRANTED != ContextCompat.checkSelfPermission(this, perm)) {
            toApplyList.add(perm);
            //进入到这里代表没有权限.

        }
    }
    String tmpList[] = new String[toApplyList.size()];
    if (!toApplyList.isEmpty()){
        ActivityCompat.requestPermissions(this, toApplyList.toArray(tmpList), 123);
    }

}

@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    // 此处为android 6.0以上动态授权的回调，用户自行实现。

bdasr_V3_xxxxxxxx_xxxx.jar 库

将core/libs/bdasr_V3_xxxxx_xxxxx.jar 复制到您的项目的同名目录中。

复制NDK 架构目录

将 core/src/main/jniLibs 下armeabi等包含so文件的5个目录，复制合并到您的项目的同名或者存放so的目录中。如果build.gradle中定义过jniLibs.srcDirs ，则复制合并到这个目录。
如与第三方库集成，至少要保留armeabi目录。如第三方库有7个架构目录，比语音识别SDK多出2个目录 mips和mips64，请将mips和mips64目录删除，剩下5个同名目录合并。
如第三方库仅有armeabi这一个目录，请将语音识别SDK的额外4个目录如armeabi-v7a删除,合并armeabi目录下的so。即目录取交集，so文件不可随意更改所属目录。
打包成apk文件，按照zip格式解压出libs目录可以验证。
运行时 getApplicationInfo().nativeLibraryDir 目录下查看是否有完整so文件。特别是系统app需要手动push so文件到这个目录下。

build.gradle 文件及包名确认

根目录下build.gradle确认下gradle的版本。
app/build.gradle 确认下 applicationId 包名是否与官网申请应用时相一致（离线功能需要）。 demo的包名是"com.baidu.speech.recognizerdemo"。
确认 compileSdkVersion buildToolsVersion 及 targetSdkVersion

proguard文件

-keep class com.baidu.speech.**{*;}

BEST PRACTICE

请先测通DEMO，了解DEMO的功能，代码的运行原理后再集成。DEMO有bug，请立即反馈。
对应任何第三方库，从一开始集成，边开发边测试，不要等所有功能都开发完再集成。否则一旦有问题，难以隔离排查。
有问题先与DEMO做对比。DEMO有bug，请查看错误码文档，如无法解决请立即反馈；DEMO无bug，自身代码有问题，请设置同样的输入参数后，对比两边代码及日志，自行排查问题。