Android SDK

混淆配置

启用代码混淆时，在 proguard-rules.pro 中保留 SDK 类。

-keep class com.alibaba.idst.nui.* { *; }

识别本地文件

以下示例使用 SDK V2.7.4-01B，识别应用私有目录中的 example.wav。将待识别的 WAV 文件保存到 getFilesDir() 对应的目录，替换 Appkey、Token 和设备标识。Token 由服务端获取并下发，设备标识建议使用唯一 ID。使用其他文件时，同时调整文件路径和 nls_config.format。将该 Activity 添加到应用工程，并在 AndroidManifest.xml 中注册。

import android.app.Activity;
import android.os.Bundle;
import android.os.Handler;
import android.os.HandlerThread;
import android.util.Log;
import com.alibaba.idst.nui.AsrResult;
import com.alibaba.idst.nui.Constants;
import com.alibaba.idst.nui.INativeFileTransCallback;
import com.alibaba.idst.nui.NativeNui;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.File;
import java.nio.charset.StandardCharsets;

public class FileTranscriberActivity extends Activity implements INativeFileTransCallback {
    private HandlerThread sdkThread;
    private Handler sdkHandler;
    private NativeNui nui;
    private String taskId;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        sdkThread = new HandlerThread("file-transcriber");
        sdkThread.start();
        sdkHandler = new Handler(sdkThread.getLooper());
        sdkHandler.post(() -> {
            try {
                startRecognition();
            } catch (JSONException e) {
                Log.e("FileTranscriber", "Invalid JSON parameters", e);
                releaseSDK();
            }
        });
    }

    private void startRecognition() throws JSONException {
        String filePath = new File(getFilesDir(), "example.wav").getAbsolutePath();
        JSONObject initParams = new JSONObject();
        initParams.put("app_key", "<APPKEY>");
        initParams.put("token", "<NLS_TOKEN>");
        initParams.put("device_id", "<DEVICE_ID>");
        initParams.put("url", "https://nls-gateway.cn-shanghai.aliyuncs.com/stream/v1/FlashRecognizer");
        initParams.put("service_mode", Constants.ModeFullCloud);

        nui = new NativeNui();
        int ret = nui.initialize(this, initParams.toString(), Constants.LogLevel.LOG_LEVEL_NONE, false);
        if (ret != 0) {
            Log.e("FileTranscriber", "Initialize failed: " + ret);
            releaseSDK();
            return;
        }

        JSONObject config = new JSONObject();
        config.put("format", "wav");
        JSONObject params = new JSONObject();
        params.put("file_path", filePath);
        params.put("nls_config", config);

        byte[] taskIdBuffer = new byte[32];
        ret = nui.startFileTranscriber(params.toString(), taskIdBuffer);
        if (ret != 0) {
            Log.e("FileTranscriber", "Start failed: " + ret);
            releaseSDK();
            return;
        }
        taskId = new String(taskIdBuffer, StandardCharsets.UTF_8);
    }

    @Override
    public void onFileTransEventCallback(Constants.NuiEvent event, int resultCode,
                                        int arg2, AsrResult asrResult, String taskId) {
        if (event == Constants.NuiEvent.EVENT_FILE_TRANS_RESULT) {
            if (asrResult != null) {
                Log.i("FileTranscriber", asrResult.asrResult);
            }
            sdkHandler.post(this::releaseSDK);
        } else if (event == Constants.NuiEvent.EVENT_ASR_ERROR) {
            Log.e("FileTranscriber", "Recognition failed: " + resultCode);
            sdkHandler.post(this::releaseSDK);
        }
    }

    private void releaseSDK() {
        if (nui != null) {
            nui.release();
            nui = null;
            taskId = null;
        }
    }

    @Override
    protected void onDestroy() {
        sdkHandler.post(() -> {
            if (nui != null && taskId != null) {
                nui.cancelFileTranscriber(taskId);
            }
            releaseSDK();
            sdkThread.quitSafely();
        });
        super.onDestroy();
    }
}

取消识别

需要中止尚未完成的任务时，在同一 Activity 中使用以下代码。SDK 调用仍在 sdkHandler 的工作线程执行。

sdkHandler.post(() -> {
    if (nui != null && taskId != null) {
        int ret = nui.cancelFileTranscriber(taskId);
        Log.i("FileTranscriber", "Cancel result: " + ret);
    }
});

开始识别后未收到回调，如何排查？

检查 initialize 的返回值、传入的 INativeFileTransCallback 实现，以及 SDK 实例的生命周期。处理任务期间应保留该实例，在收到最终结果或错误回调后再释放。纯云端功能从 V2.6.2 起不需要复制模型资源文件。

如何获取任务状态和结果？

通过 onFileTransEventCallback 获取当前任务的状态和结果。上传完成对应 EVENT_FILE_TRANS_UPLOADED，最终结果对应 EVENT_FILE_TRANS_RESULT，错误对应 EVENT_ASR_ERROR；回调中的 taskId 用于关联任务。

是否支持 OPUS 文件？

支持。将 file_path 设置为应用可读取的 OPUS 文件路径，并将 nls_config.format 设置为 opus。