在开始API开发工作之前,您需要完成必要的开发准备工作,同时请确保您的工程中已经配置HMS Core SDK的maven仓地址,并且完成了本服务的SDK集成。
1. 用户调用接口创建一个语音识别器。
- // context为应用上下文信息。
- MLAsrRecognizer mSpeechRecognizer = MLAsrRecognizer.createAsrRecognizer(context);
2. 创建语音识别结果监听器回调。
- // 回调实现MLAsrListener接口,实现接口中的方法。
- protected class SpeechRecognitionListener implements MLAsrListener {
- @Override
- public void onStartListening() {
- // 录音器开始接收声音。
- }
- @Override
- public void onStartingOfSpeech() {
- // 用户开始讲话,即语音识别器检测到用户开始讲话。
- }
- @Override
- public void onVoiceDataReceived(byte[] data, float energy, Bundle bundle) {
- // 返回给用户原始的PCM音频流和音频能量。
- }
- @Override
- public void onRecognizingResults(Bundle partialResults) {
- // 从MLAsrRecognizer接收到持续语音识别的文本。
- }
- @Override
- public void onResults(Bundle results) {
- // 语音识别的文本数据。
- }
- @Override
- public void onError(int error, String errorMessage) {
- // 识别发生错误后调用该接口。
- }
- @Override
- public void onState(int state) {
- // 通知应用状态发生改变。
- }
- }
3. 将新建的结果监听器回调与语音识别器绑定。
- mSpeechRecognizer.setAsrListener(new SpeechRecognitionListener());
4. 配置识别参数,调用“startRecognizing”启动语音识别。
- // 新建Intent,用于配置语音识别参数。
- Intent mSpeechRecognizerIntent = new Intent(MLAsrConstants.ACTION_HMS_ASR_SPEECH);
- // 通过Intent进行语音识别参数设置。
- mSpeechRecognizerIntent
- // 设置识别语言为英文,若不设置,则默认识别英文。支持设置:"zh": 中文;"en-US": 英文;"fr-FR": 法语。
- .putExtra(MLAsrConstants.LANGUAGE, "zh")
- // 设置识别文本返回模式为边识别边出字,若不设置,默认为边识别边出字。支持设置:
- // MLAsrConstants.FEATURE_WORDFLUX:通过onRecognizingResults接口,识别同时返回文字;
- // MLAsrConstants.FEATURE_ALLINONE:识别完成后通过onResults接口返回文字。
- .putExtra(MLAsrConstants.FEATURE, MLAsrConstants.FEATURE_WORDFLUX);
- // 启动语音识别。
- mSpeechRecognizer.startRecognizing(mSpeechRecognizerIntent);
5. 识别完成后,释放资源
- if (mSpeechRecognizer!= null) {
- mSpeechRecognizer.destroy();
- }
1. 创建Intent,用于设置实时语音识别参数。
- // 通过intent进行识别设置。
- Intent intent = new Intent(this, MLAsrCaptureActivity.class)
- // 设置识别语言为英文,若不设置,则默认识别英文。支持设置:"zh": 中文;"en-US": 英文,;"fr": 法语。
- .putExtra(MLAsrCaptureConstants.LANGUAGE, "en-US")
- // 设置拾音界面是否显示文字,MLAsrCaptureConstants.FEATURE_ALLINONE为不显示,MLAsrCaptureConstants.FEATURE_WORDFLUX为显示。
- .putExtra(MLAsrCaptureConstants.FEATURE, MLAsrCaptureConstants.FEATURE_WORDFLUX);
2. 创建activity,传入步骤1创建的Intent,用于拾音,并将结果返回原activity,可实时识别60s内(包括60s)的语音。
- // 100表示当前Activity和拾音界面Activity之间的请求码,通过该码可以在当前Activity中获取拾音界面的处理结果。
- startActivityForResult(intent, 100);
3. 覆写onActivityResult方法,用于处理语音识别服务返回结果。
- @Override
- protected void onActivityResult(int requestCode, int resultCode, Intent data) {
- super.onActivityResult(requestCode, resultCode, data);
- String text = "";
- // 100是第2步中定义的当前Activity和拾音界面Activity之间的请求码。
- if (requestCode == 100) {
- switch (resultCode) {
- // 返回值为MLAsrCaptureConstants.ASR_SUCCESS表示识别成功。
- case MLAsrCaptureConstants.ASR_SUCCESS:
- if (data != null) {
- Bundle bundle = data.getExtras();
- // 获取语音识别得到的文本信息。
- if (bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_RESULT)) {
- text = bundle.getString(MLAsrCaptureConstants.ASR_RESULT);
- // 识别得到的文本信息处理。
- }
- }
- break;
- // 返回值为MLAsrCaptureConstants.ASR_FAILURE表示识别失败。
- case MLAsrCaptureConstants.ASR_FAILURE:
- // 识别失败处理。
- if(data != null) {
- Bundle bundle = data.getExtras();
- // 判断是否包含错误码。
- if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_ERROR_CODE)) {
- int errorCode = bundle.getInt(MLAsrCaptureConstants.ASR_ERROR_CODE);
- // 对错误码进行处理。
- }
- // 判断是否包含错误信息。
- if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_ERROR_MESSAGE)){
- String errorMsg = bundle.getString(MLAsrCaptureConstants.ASR_ERROR_MESSAGE);
- // 对错误信息进行处理。
- }
- //判断是否包含子错误码。
- if(bundle != null && bundle.containsKey(MLAsrCaptureConstants.ASR_SUB_ERROR_CODE)) {
- int subErrorCode = bundle.getInt(MLAsrCaptureConstants.ASR_SUB_ERROR_CODE);
- // 对子错误码进行处理。
- }
- }
- default:
- break;
- }
- }
- }