RecognitionService.Callback

Kotlin |Java

public class RecognitionService.Callback
extends Object

java.lang.Object
↳	android.speech.RecognitionService.Callback

This class receives callbacks from the speech recognition service and forwards them to the user. An instance of this class is passed to the RecognitionService.onStartListening(Intent,Callback) method. Recognizers may call these methods on any thread.

Summary

Public methods
`void`	`beginningOfSpeech()` The service should call this method when the user has started to speak.
`void`	`bufferReceived(byte[] buffer)` The service should call this method when sound has been received.
`void`	`endOfSegmentedSession()` The service should call this method to end a segmented session.
`void`	`endOfSpeech()` The service should call this method after the user stops speaking.
`void`	`error(int error)` The service should call this method when a network or recognition error occurred.
`AttributionSource`	`getCallingAttributionSource()` Gets the permission identity of the calling app.
`int`	`getCallingUid()` Return the Linux uid assigned to the process that sent you the current transaction that is being processed.
`void`	`languageDetection(Bundle results)` The service should call this method when the language detection (and switching) results are available.
`void`	`partialResults(Bundle partialResults)` The service should call this method when partial recognition results are available.
`void`	`readyForSpeech(Bundle params)` The service should call this method when the endpointer is ready for the user to start speaking.
`void`	`results(Bundle results)` The service should call this method when recognition results are ready.
`void`	`rmsChanged(float rmsdB)` The service should call this method when the sound level in the audio stream has changed.
`void`	`segmentResults(Bundle results)` The service should call this method for each ready segment of a long recognition session.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

beginningOfSpeech

Added in API level 8

public void beginningOfSpeech ()

The service should call this method when the user has started to speak.

Throws
`RemoteException`

bufferReceived

Added in API level 8

public void bufferReceived (byte[] buffer)

The service should call this method when sound has been received. The purpose of this function is to allow giving feedback to the user regarding the captured audio.

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.

Throws
`RemoteException`

endOfSegmentedSession

Added in API level 33

public void endOfSegmentedSession ()

The service should call this method to end a segmented session.

Throws
`RemoteException`

endOfSpeech

Added in API level 8

public void endOfSpeech ()

The service should call this method after the user stops speaking.

Throws
`RemoteException`

error

The service should call this method when a network or recognition error occurred.

Returns
`AttributionSource`	The permission identity of the calling app. This value cannot be `null`.

Returns
`int`

languageDetection

Added in API level 34

public void languageDetection (Bundle results)

The service should call this method when the language detection (and switching) results are available. This method can be called on any number of occasions at any time between beginningOfSpeech() and endOfSpeech(), depending on the speech recognition service implementation.

Parameters

Parameters
`results`	`Bundle`: the returned language detection (and switching) results. To retrieve the most confidently detected language IETF tag (as defined by BCP 47, e.g., "en-US", "de-DE"), use `Bundle.getString(String)` with `SpeechRecognizer.DETECTED_LANGUAGE` as the parameter. To retrieve the language detection confidence level represented by a value prefixed by `LANGUAGE_DETECTION_CONFIDENCE_LEVEL_` defined in `SpeechRecognizer`, use `Bundle.getInt(String)` with `SpeechRecognizer.LANGUAGE_DETECTION_CONFIDENCE_LEVEL` as the parameter. To retrieve the alternative locales for the same language retrieved by the key `SpeechRecognizer.DETECTED_LANGUAGE`, use `Bundle.getStringArrayList(String)` with `SpeechRecognizer.TOP_LOCALE_ALTERNATIVES` as the parameter. To retrieve the language switching results represented by a value prefixed by `LANGUAGE_SWITCH_RESULT_` and defined in `SpeechRecognizer`, use `Bundle.getInt(String)` with `SpeechRecognizer.LANGUAGE_SWITCH_RESULT` as the parameter. This value cannot be `null`.

results

Bundle: the returned language detection (and switching) results.

To retrieve the most confidently detected language IETF tag (as defined by BCP 47, e.g., "en-US", "de-DE"), use Bundle.getString(String) with SpeechRecognizer.DETECTED_LANGUAGE as the parameter.

To retrieve the language detection confidence level represented by a value prefixed by LANGUAGE_DETECTION_CONFIDENCE_LEVEL_ defined in SpeechRecognizer, use Bundle.getInt(String) with SpeechRecognizer.LANGUAGE_DETECTION_CONFIDENCE_LEVEL as the parameter.

To retrieve the alternative locales for the same language retrieved by the key SpeechRecognizer.DETECTED_LANGUAGE, use Bundle.getStringArrayList(String) with SpeechRecognizer.TOP_LOCALE_ALTERNATIVES as the parameter.

To retrieve the language switching results represented by a value prefixed by LANGUAGE_SWITCH_RESULT_ and defined in SpeechRecognizer, use Bundle.getInt(String) with SpeechRecognizer.LANGUAGE_SWITCH_RESULT as the parameter.
This value cannot be null.

RecognitionService.Callback

Summary

Public methods

Inherited methods

Public methods

beginningOfSpeech

bufferReceived

endOfSegmentedSession

endOfSpeech

error

getCallingAttributionSource

getCallingUid

languageDetection

partialResults

readyForSpeech

results

rmsChanged

segmentResults