程序包 ohos.ai.asr

接口 AsrListener

public interface AsrListener

Provides callbacks for observing the process and result of ASR method calls.

The caller determines how to implement this interface when using AsrClient#init(AsrIntent, AsrListener) to initialize the ASR engine.

从以下版本开始:

3

方法概要

限定符和类型	方法	说明
void	onAudioEnd()	Called when the audio ends.
void	onAudioStart()	Called when the audio starts.
void	onBeginningOfSpeech()	Called when the ASR engine detects that a user starts to speak.
void	onBufferReceived(byte[] buffer)	Called when the ASR engine receives a new audio stream.
void	onEnd()	Called when the ASR ends.
void	onEndOfSpeech()	Called when the ASR engine detects that the user stops speaking.
void	onError(int error)	Called when an error occurs during ASR.
void	onEvent(int eventType, PacMap params)	Called when the ASR engine detects certain events to report them to the caller.
void	onInit(PacMap params)	Called when the ASR engine is initialized.
void	onIntermediateResults(PacMap intermediateResults)	Called when the ASR engine delivers intermediate speech recognition results.
void	onResults(PacMap results)	Called when the ASR engine delivers the finally parsed speech recognition results.
void	onRmsChanged(float rms)	Called when the ASR engine detects any changes to the root mean square (RMS) energy of the input audio.

方法详细资料

onInit

void onInit(PacMap params)

Called when the ASR engine is initialized.

After the ASR engine is initialized by using AsrClient#init(AsrIntent, AsrListener), the ASR engine server invokes this callback to process the initialization result data. The caller determines how to implement this callback.

参数:

params - Indicates the initialization result data represented by a key-value pair. The key is the string "error_code", and the value is a result code defined in AsrError.

从以下版本开始:

3

onBeginningOfSpeech

void onBeginningOfSpeech()

Called when the ASR engine detects that a user starts to speak.

从以下版本开始:

3

onRmsChanged

void onRmsChanged(float rms)

Called when the ASR engine detects any changes to the root mean square (RMS) energy of the input audio.

The ASR server invokes this callback to process the RMS energy.

参数:

rms - Indicates the RMS energy. The value is proportional to the RMS energy.

从以下版本开始:

3

onBufferReceived

void onBufferReceived(byte[] buffer)

Called when the ASR engine receives a new audio stream.

This callback is invoked to process the received audio stream. Based on the callback result, the caller can observe whether the ASR server has received any audio input.

参数:

buffer - Indicates the audio stream received by the ASR server.

从以下版本开始:

3

onEndOfSpeech

void onEndOfSpeech()

Called when the ASR engine detects that the user stops speaking.

从以下版本开始:

3

onError

void onError(int error)

Called when an error occurs during ASR.

参数:

error - Indicates the ASR error code.

从以下版本开始:

3

另请参阅:

AsrError

onResults

void onResults(PacMap results)

Called when the ASR engine delivers the finally parsed speech recognition results. This callback is invoked to return and process the results.

参数:

results - Indicates the ASR results represented by key-value pairs. For the possible keywords in the results, see AsrResultKey.

从以下版本开始:

3

onIntermediateResults

void onIntermediateResults(PacMap intermediateResults)

Called when the ASR engine delivers intermediate speech recognition results. This callback is invoked to return and process the results.

This callback may be invoked at any time between invocations of onBeginningOfSpeech() and onResults(ohos.utils.PacMap).

参数:

intermediateResults - Indicates the intermediate ASR results represented by key-value pairs. For the possible keywords in the results, see AsrResultKey.

从以下版本开始:

3

onEnd

void onEnd()

Called when the ASR ends.

If speech recognition is interrupted due to invocation of AsrClient#stopListening() or AsrClient#cancel(), this callback will not be invoked.

从以下版本开始:

3

onEvent

void onEvent(int eventType,
             PacMap params)

Called when the ASR engine detects certain events to report them to the caller.

This callback is used for monitoring scenarios not specified by particular callbacks.

参数:

eventType - Indicates the event type, as defined in AsrEvent.

params - Indicates event-specific results represented by key-value pairs, which vary according to event types.

从以下版本开始:

3

onAudioStart

void onAudioStart()

Called when the audio starts.

从以下版本开始:

3

onAudioEnd

void onAudioEnd()

Called when the audio ends.

从以下版本开始:

3