目录

在开始API开发工作之前,您需要完成必要的开发准备工作,同时请确保您的工程中已经配置HMS Core SDK的maven仓地址,并且完成了本服务的SDK集成。

实时语音识别(无拾音界面)

1. 用户调用接口创建一个语音识别器。

  1. // context为应用上下文信息。
  2. MLAsrRecognizer mSpeechRecognizer = MLAsrRecognizer.createAsrRecognizer(context);

2. 创建语音识别结果监听器回调。

  1. // 回调实现MLAsrListener接口,实现接口中的方法。
  2. protected class SpeechRecognitionListener implements MLAsrListener {
  3.    @Override
  4.    public void onStartListening() {
  5.        // 录音器开始接收声音。
  6.    }
  7.    @Override
  8.    public void onStartingOfSpeech() {
  9.        // 用户开始讲话,即语音识别器检测到用户开始讲话。
  10.    }
  11.    @Override
  12.    public void onVoiceDataReceived(byte[] data, float energy, Bundle bundle) {
  13.        // 返回给用户原始的PCM音频流和音频能量。
  14.    }
  15.    @Override
  16.    public void onRecognizingResults(Bundle partialResults) {
  17.        // 从MLAsrRecognizer接收到持续语音识别的文本。
  18.    }
  19.    @Override
  20.    public void onResults(Bundle results) {
  21.        // 语音识别的文本数据。
  22.    }
  23.    @Override
  24.    public void onError(int error, String errorMessage) {
  25.        // 识别发生错误后调用该接口。
  26.    }
  27.    @Override
  28.    public void onState(int state) {
  29.        // 通知应用状态发生改变。
  30.    }
  31. }

3. 将新建的结果监听器回调与语音识别器绑定。

  1. mSpeechRecognizer.setAsrListener(new SpeechRecognitionListener());

4. 配置识别参数,调用“startRecognizing”启动语音识别。

  1. // 新建Intent,用于配置语音识别参数。
  2. Intent mSpeechRecognizerIntent = new Intent(MLAsrConstants.ACTION_HMS_ASR_SPEECH);
  3. // 通过Intent进行语音识别参数设置。
  4. mSpeechRecognizerIntent
  5.    // 设置识别语言为英文,若不设置,则默认识别英文。支持设置:"zh": 中文;"en-US": 英文;"fr-FR": 法语。
  6.    .putExtra(MLAsrConstants.LANGUAGE, "zh")
  7.    // 设置识别文本返回模式为边识别边出字,若不设置,默认为边识别边出字。支持设置:  
  8.    // MLAsrConstants.FEATURE_WORDFLUX:通过onRecognizingResults接口,识别同时返回文字;
  9.    // MLAsrConstants.FEATURE_ALLINONE:识别完成后通过onResults接口返回文字。
  10.    .putExtra(MLAsrConstants.FEATURE, MLAsrConstants.FEATURE_WORDFLUX);
  11. // 启动语音识别。
  12. mSpeechRecognizer.startRecognizing(mSpeechRecognizerIntent);

5. 识别完成后,释放资源

  1. if (mSpeechRecognizer!= null) {
  2.    mSpeechRecognizer.destroy();
  3. }

实时语音识别(有拾音界面)

 1. 创建Intent,用于设置实时语音识别参数。

  1. // 通过intent进行识别设置。
  2. Intent intent = new Intent(this, MLAsrCaptureActivity.class)
  3.    // 设置识别语言为英文,若不设置,则默认识别英文。支持设置:"zh": 中文;"en-US": 英文,;"fr": 法语。
  4.    .putExtra(MLAsrCaptureConstants.LANGUAGE, "en-US")
  5.    // 设置拾音界面是否显示文字,MLAsrCaptureConstants.FEATURE_ALLINONE为不显示,MLAsrCaptureConstants.FEATURE_WORDFLUX为显示。
  6.    .putExtra(MLAsrCaptureConstants.FEATURE, MLAsrCaptureConstants.FEATURE_WORDFLUX);

2. 创建activity,传入步骤1创建的Intent,用于拾音,并将结果返回原activity,可实时识别60s内(包括60s)的语音。

  1. // 100表示当前Activity和拾音界面Activity之间的请求码,通过该码可以在当前Activity中获取拾音界面的处理结果。
  2. startActivityForResult(intent, 100);

3. 覆写onActivityResult方法,用于处理语音识别服务返回结果。

  1. @Override
  2. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  3.    super.onActivityResult(requestCode, resultCode, data);
  4.    String text = "";
  5.    // 100是第2步中定义的当前Activity和拾音界面Activity之间的请求码。
  6.    if (requestCode == 100) {
  7.        switch (resultCode) {
  8.            // 返回值为MLAsrCaptureConstants.ASR_SUCCESS表示识别成功。
  9.            case MLAsrCaptureConstants.ASR_SUCCESS:
  10.                if (data != null) {
  11.                    Bundle bundle = data.getExtras();
  12.                    // 获取语音识别得到的文本信息。
  13.                    if (bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_RESULT)) {    
  14.                        text = bundle.getString(MLAsrCaptureConstants.ASR_RESULT);
  15.                        // 识别得到的文本信息处理。
  16.                    }
  17.                }
  18.                break;
  19.            // 返回值为MLAsrCaptureConstants.ASR_FAILURE表示识别失败。
  20.            case MLAsrCaptureConstants.ASR_FAILURE:
  21.                // 识别失败处理。
  22.                if(data != null) {
  23.                    Bundle bundle = data.getExtras();
  24.                    // 判断是否包含错误码。
  25.                    if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_ERROR_CODE)) {
  26.                        int errorCode = bundle.getInt(MLAsrCaptureConstants.ASR_ERROR_CODE);
  27.                        // 对错误码进行处理。
  28.                    }
  29.                    // 判断是否包含错误信息。
  30.                    if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_ERROR_MESSAGE)){
  31.                        String errorMsg = bundle.getString(MLAsrCaptureConstants.ASR_ERROR_MESSAGE);
  32.                        // 对错误信息进行处理。
  33.                    }
  34.                    //判断是否包含子错误码。
  35.                    if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_SUB_ERROR_CODE)) {
  36.                        int subErrorCode = bundle.getInt(MLAsrCaptureConstants.ASR_SUB_ERROR_CODE);
  37.                       // 对子错误码进行处理。
  38.                    }
  39.                }
  40.            default:
  41.                break;
  42.        }
  43.    }
  44. }