Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
Added in API level 8
public interface

RecognitionListener

android.speech.RecognitionListener

Class Overview

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

public abstract void onBeginningOfSpeech ()

Added in API level 8

The user has started to speak.

public abstract void onBufferReceived (byte[] buffer)

Added in API level 8

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 a buffer containing a sequence of big-endian 16-bit integers representing a single channel audio stream. The sample rate is implementation dependent.

public abstract void onEndOfSpeech ()

Added in API level 8

Called after the user stops speaking.

public abstract void onError (int error)

Added in API level 8

A network or recognition error occurred.

Parameters
error code is defined in SpeechRecognizer

public abstract void onEvent (int eventType, Bundle params)

Added in API level 8

Reserved for adding future events.

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

public abstract void onPartialResults ( Bundle partialResults)

Added in API level 8

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 the returned results. To retrieve the results in ArrayList<String> format use getStringArrayList(String) with RESULTS_RECOGNITION as a parameter

public abstract void onReadyForSpeech ( Bundle params)

Added in API level 8

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

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

public abstract void onResults ( Bundle results)

Added in API level 8

Called when recognition results are ready.

Parameters
results 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 .

public abstract void onRmsChanged (float rmsdB)

Added in API level 8

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

Parameters
rmsdB the new RMS dB value