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.
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. |
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. |
void onError (int error)
A network or recognition error occurred.
Parameters | |
---|---|
error |
int : code is defined in SpeechRecognizer |
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 |
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 |
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. |
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 . |
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 |