Skip to content

Most visited

Recently visited

navigation
Added in API level 8

SpeechRecognizer

public class SpeechRecognizer
extends Object

java.lang.Object
   ↳ android.speech.SpeechRecognizer


This class provides access to the speech recognition service. This service allows access to the speech recognizer. Do not instantiate this class directly, instead, call createSpeechRecognizer(Context). This class's methods must be invoked only from the main application thread.

The implementation of this API is likely to stream audio to remote servers to perform speech recognition. As such this API is not intended to be used for continuous recognition, which would consume a significant amount of battery and bandwidth.

Please note that the application must have RECORD_AUDIO permission to use this class.

Summary

Constants

String CONFIDENCE_SCORES

Key used to retrieve a float array from the Bundle passed to the onResults(Bundle) and onPartialResults(Bundle) methods.

int ERROR_AUDIO

Audio recording error.

int ERROR_CLIENT

Other client side errors.

int ERROR_INSUFFICIENT_PERMISSIONS

Insufficient permissions

int ERROR_NETWORK

Other network related errors.

int ERROR_NETWORK_TIMEOUT

Network operation timed out.

int ERROR_NO_MATCH

No recognition result matched.

int ERROR_RECOGNIZER_BUSY

RecognitionService busy.

int ERROR_SERVER

Server sends error status.

int ERROR_SPEECH_TIMEOUT

No speech input

String RESULTS_RECOGNITION

Key used to retrieve an ArrayList<String> from the Bundle passed to the onResults(Bundle) and onPartialResults(Bundle) methods.

Public methods

void cancel()

Cancels the speech recognition.

static SpeechRecognizer createSpeechRecognizer(Context context)

Factory method to create a new SpeechRecognizer.

static SpeechRecognizer createSpeechRecognizer(Context context, ComponentName serviceComponent)

Factory method to create a new SpeechRecognizer.

void destroy()

Destroys the SpeechRecognizer object.

static boolean isRecognitionAvailable(Context context)

Checks whether a speech recognition service is available on the system.

void setRecognitionListener(RecognitionListener listener)

Sets the listener that will receive all the callbacks.

void startListening(Intent recognizerIntent)

Starts listening for speech.

void stopListening()

Stops listening for speech.

Inherited methods

From class java.lang.Object

Constants

CONFIDENCE_SCORES

Added in API level 14
String CONFIDENCE_SCORES

Key used to retrieve a float array from the Bundle passed to the onResults(Bundle) and onPartialResults(Bundle) methods. The array should be the same size as the ArrayList provided in RESULTS_RECOGNITION, and should contain values ranging from 0.0 to 1.0, or -1 to represent an unavailable confidence score.

Confidence values close to 1.0 indicate high confidence (the speech recognizer is confident that the recognition result is correct), while values close to 0.0 indicate low confidence.

This value is optional and might not be provided.

Constant Value: "confidence_scores"

ERROR_AUDIO

Added in API level 8
int ERROR_AUDIO

Audio recording error.

Constant Value: 3 (0x00000003)

ERROR_CLIENT

Added in API level 8
int ERROR_CLIENT

Other client side errors.

Constant Value: 5 (0x00000005)

ERROR_INSUFFICIENT_PERMISSIONS

Added in API level 8
int ERROR_INSUFFICIENT_PERMISSIONS

Insufficient permissions

Constant Value: 9 (0x00000009)

ERROR_NETWORK

Added in API level 8
int ERROR_NETWORK

Other network related errors.

Constant Value: 2 (0x00000002)

ERROR_NETWORK_TIMEOUT

Added in API level 8
int ERROR_NETWORK_TIMEOUT

Network operation timed out.

Constant Value: 1 (0x00000001)

ERROR_NO_MATCH

Added in API level 8
int ERROR_NO_MATCH

No recognition result matched.

Constant Value: 7 (0x00000007)

ERROR_RECOGNIZER_BUSY

Added in API level 8
int ERROR_RECOGNIZER_BUSY

RecognitionService busy.

Constant Value: 8 (0x00000008)

ERROR_SERVER

Added in API level 8
int ERROR_SERVER

Server sends error status.

Constant Value: 4 (0x00000004)

ERROR_SPEECH_TIMEOUT

Added in API level 8
int ERROR_SPEECH_TIMEOUT

No speech input

Constant Value: 6 (0x00000006)

RESULTS_RECOGNITION

Added in API level 8
String RESULTS_RECOGNITION

Key used to retrieve an ArrayList<String> from the Bundle passed to the onResults(Bundle) and onPartialResults(Bundle) methods. These strings are the possible recognition results, where the first element is the most likely candidate.

Constant Value: "results_recognition"

Public methods

cancel

Added in API level 8
void cancel ()

Cancels the speech recognition. Please note that setRecognitionListener(RecognitionListener) should be called beforehand, otherwise no notifications will be received.

createSpeechRecognizer

Added in API level 8
SpeechRecognizer createSpeechRecognizer (Context context)

Factory method to create a new SpeechRecognizer. Please note that setRecognitionListener(RecognitionListener) should be called before dispatching any command to the created SpeechRecognizer, otherwise no notifications will be received.

Parameters
context Context: in which to create SpeechRecognizer
Returns
SpeechRecognizer a new SpeechRecognizer

createSpeechRecognizer

Added in API level 8
SpeechRecognizer createSpeechRecognizer (Context context, 
                ComponentName serviceComponent)

Factory method to create a new SpeechRecognizer. Please note that setRecognitionListener(RecognitionListener) should be called before dispatching any command to the created SpeechRecognizer, otherwise no notifications will be received. Use this version of the method to specify a specific service to direct this SpeechRecognizer to. Normally you would not use this; use createSpeechRecognizer(Context) instead to use the system default recognition service.

Parameters
context Context: in which to create SpeechRecognizer
serviceComponent ComponentName: the ComponentName of a specific service to direct this SpeechRecognizer to
Returns
SpeechRecognizer a new SpeechRecognizer

destroy

Added in API level 8
void destroy ()

Destroys the SpeechRecognizer object.

isRecognitionAvailable

Added in API level 8
boolean isRecognitionAvailable (Context context)

Checks whether a speech recognition service is available on the system. If this method returns false, createSpeechRecognizer(Context) will fail.

Parameters
context Context: with which SpeechRecognizer will be created
Returns
boolean true if recognition is available, false otherwise

setRecognitionListener

Added in API level 8
void setRecognitionListener (RecognitionListener listener)

Sets the listener that will receive all the callbacks. The previous unfinished commands will be executed with the old listener, while any following command will be executed with the new listener.

Parameters
listener RecognitionListener: listener that will receive all the callbacks from the created SpeechRecognizer, this must not be null.

startListening

Added in API level 8
void startListening (Intent recognizerIntent)

Starts listening for speech. Please note that setRecognitionListener(RecognitionListener) should be called beforehand, otherwise no notifications will be received.

Parameters
recognizerIntent Intent: contains parameters for the recognition to be performed. The intent may also contain optional extras, see RecognizerIntent. If these values are not set explicitly, default values will be used by the recognizer.

stopListening

Added in API level 8
void stopListening ()

Stops listening for speech. Speech captured so far will be recognized as if the user had stopped speaking at this point. Note that in the default case, this does not need to be called, as the speech endpointer will automatically stop the recognizer listening when it determines speech has completed. However, you can manipulate endpointer parameters directly using the intent extras defined in RecognizerIntent, in which case you may sometimes want to manually call this method to stop listening sooner. Please note that setRecognitionListener(RecognitionListener) should be called beforehand, otherwise no notifications will be received.

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.