目录

Before API development, you need to make necessary development preparations, ensure that the Maven repository address of the HMS Core SDK has been configured in your project, and the SDK of this service has been integrated.

1. Create and initialize an audio transcription engine, and create an audio file transcription configurator.

  1. // Create an audio transcription engine.
  2. MLRemoteAftEngine engine = MLRemoteAftEngine.getInstance();
  3. // Initialize the engine and pass the current context.
  4. engine.init(this);
  5. // Create an audio file transcription configurator.
  6. MLRemoteAftSetting setting = new MLRemoteAftSetting.Factory()
  7. // Set the transcription language code, complying with the BCP 47 standard. Currently, zh (Chinese) and en-US (English) are supported.
  8.     .setLanguageCode("zh")
  9.     .create();

2. Create a listener callback to process the audio file transcription result. (The duration of a to-be-processed audio file cannot be longer than 1 minute.)

  1. private MLRemoteAftListener aftListener = new MLRemoteAftListener() {
  2.     public void onResult(String taskId, MLRemoteAftResult result, Object ext) {
  3.         // Obtain the transcription result notification.
  4.         if (result.isComplete()) {
  5.             // Process the transcription result.
  6.         }
  7.     }
  8.     @Override
  9.     public void onError(String taskId, int errorCode, String message) {
  10.         // Transcription error callback function.
  11.     }
  12.     @Override
  13.     public void onInitComplete(String taskId, Object ext) {
  14.         // Reserved.
  15.     }
  16.     @Override
  17.     public void onUploadProgress(String taskId, double progress, Object ext) {
  18.         // Reserved.
  19.     }
  20.     @Override
  21.     public void onEvent(String taskId, int eventId, Object ext) {
  22.         // Reserved.
  23.     }
  24. };

3. Pass the listener callback function to the created audio transcription engine.

  1. engine.setAftListener(aftListener);

4. Use the shortRecognize method to pass locally obtained audio files or audio files recorded using a recorder to the audio transcription engine.

  1. // uri indicates audio resources read from the local storage or recorder. Only local audio files with duration (not longer than 1 minute) whose URIs starting with content:// or file:// are supported.
  2. engine.shortRecognize(uri, setting);