Skip to content

Most visited

Recently visited

navigation
Added in API level 8

RecognitionListener

public interface RecognitionListener

android.speech.RecognitionListener


Used for receiving notifications from the SpeechRecognizer when the recognition related events occur. All the callbacks are executed on the Application main thread.

Summary

Public methods

abstract void onBeginningOfSpeech()

The user has started to speak.

abstract void onBufferReceived(byte[] buffer)

More sound has been received.

abstract void onEndOfSpeech()

Called after the user stops speaking.

abstract void onError(int error)

A network or recognition error occurred.

abstract void onEvent(int eventType, Bundle params)

Reserved for adding future events.

abstract void onPartialResults(Bundle partialResults)

Called when partial recognition results are available.

abstract void onReadyForSpeech(Bundle params)

Called when the endpointer is ready for the user to start speaking.

abstract void onResults(Bundle results)

Called when recognition results are ready.

abstract void onRmsChanged(float rmsdB)

The sound level in the audio stream has changed.

Public methods

onBeginningOfSpeech

Added in API level 8
void onBeginningOfSpeech ()

The user has started to speak.

onBufferReceived

Added in API level 8
void onBufferReceived (byte[] buffer)

More sound has been received. The purpose of this function is to allow giving feedback to the user regarding the captured audio. There is no guarantee that this method will be called.

Parameters
buffer byte: a buffer containing a sequence of big-endian 16-bit integers representing a single channel audio stream. The sample rate is implementation dependent.

onEndOfSpeech

Added in API level 8
void onEndOfSpeech ()

Called after the user stops speaking.

onError

Added in API level 8
void onError (int error)

A network or recognition error occurred.

Parameters
error int: code is defined in SpeechRecognizer

onEvent

Added in API level 8
void onEvent (int eventType, 
                Bundle params)

Reserved for adding future events.

Parameters
eventType int: the type of the occurred event
params Bundle: a Bundle containing the passed parameters

onPartialResults

Added in API level 8
void onPartialResults (Bundle partialResults)

Called when partial recognition results are available. The callback might be called at any time between onBeginningOfSpeech() and onResults(Bundle) when partial results are ready. This method may be called zero, one or multiple times for each call to startListening(Intent), depending on the speech recognition service implementation. To request partial results, use EXTRA_PARTIAL_RESULTS

Parameters
partialResults Bundle: the returned results. To retrieve the results in ArrayList<String> format use getStringArrayList(String) with RESULTS_RECOGNITION as a parameter

onReadyForSpeech

Added in API level 8
void onReadyForSpeech (Bundle params)

Called when the endpointer is ready for the user to start speaking.

Parameters
params Bundle: parameters set by the recognition service. Reserved for future use.

onResults

Added in API level 8
void onResults (Bundle results)

Called when recognition results are ready.

Parameters
results Bundle: the recognition results. To retrieve the results in ArrayList<String> format use getStringArrayList(String) with RESULTS_RECOGNITION as a parameter. A float array of confidence values might also be given in CONFIDENCE_SCORES.

onRmsChanged

Added in API level 8
void onRmsChanged (float rmsdB)

The sound level in the audio stream has changed. There is no guarantee that this method will be called.

Parameters
rmsdB float: the new RMS dB value
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.