Added in API level 10

RecognizerResultsIntent

Kotlin |Java

public class RecognizerResultsIntent
extends Object

java.lang.Object
↳	android.speech.RecognizerResultsIntent

Constants for intents related to showing speech recognition results. These constants should not be needed for normal utilization of speech recognition. They would only be called if you wanted to trigger a view of voice search results in your application, or implemented if you wanted to offer a different view for voice search results with your application. The standard behavior here for someone receiving an ACTION_VOICE_SEARCH_RESULTS is to first retrieve the list of EXTRA_VOICE_SEARCH_RESULT_STRINGS, and use any provided HTML for that result in EXTRA_VOICE_SEARCH_RESULT_HTML, if available, to display the search results. If that is not available, then the corresponding url for that result in EXTRA_VOICE_SEARCH_RESULT_URLS should be used. And if even that is not available, then a search url should be constructed from the actual recognition result string.

Summary

Constants
`String`	`ACTION_VOICE_SEARCH_RESULTS` Intent that can be sent by implementations of voice search to display the results of a search in, for example, a web browser.
`String`	`EXTRA_VOICE_SEARCH_RESULT_HTML` The key to an extra `ArrayList` of `String`s that contains the html content to use, if available, for the recognition alternates provided in `EXTRA_VOICE_SEARCH_RESULT_STRINGS`.
`String`	`EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS` The key to an extra `ArrayList` of `String`s that contains the base url to assume when interpreting html provided in `EXTRA_VOICE_SEARCH_RESULT_HTML`.
`String`	`EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS` The key to an extra `ArrayList` of `Bundle`s that contains key/value pairs.
`String`	`EXTRA_VOICE_SEARCH_RESULT_STRINGS` The key to an extra `ArrayList` of `String`s that contains the list of recognition alternates from voice search, in order from highest to lowest confidence.
`String`	`EXTRA_VOICE_SEARCH_RESULT_URLS` The key to an extra `ArrayList` of `String`s that contains the search urls to use, if available, for the recognition alternates provided in `EXTRA_VOICE_SEARCH_RESULT_STRINGS`.
`String`	`URI_SCHEME_INLINE` The scheme used currently for html content in `EXTRA_VOICE_SEARCH_RESULT_HTML`.

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.

Constants

ACTION_VOICE_SEARCH_RESULTS

Added in API level 10

public static final String ACTION_VOICE_SEARCH_RESULTS

Intent that can be sent by implementations of voice search to display the results of a search in, for example, a web browser. This intent should always be accompanied by at least EXTRA_VOICE_SEARCH_RESULT_STRINGS, and optionally but recommended, EXTRA_VOICE_SEARCH_RESULT_URLS, and sometimes EXTRA_VOICE_SEARCH_RESULT_HTML and EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS. These are parallel arrays, where a recognition result string at index N of EXTRA_VOICE_SEARCH_RESULT_STRINGS should be accompanied by a url to use for searching based on that string at index N of EXTRA_VOICE_SEARCH_RESULT_URLS, and, possibly, the full html to display for that result at index N of EXTRA_VOICE_SEARCH_RESULT_HTML. If full html is provided, a base url (or list of base urls) should be provided with EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS.

Constant Value: "android.speech.action.VOICE_SEARCH_RESULTS"

EXTRA_VOICE_SEARCH_RESULT_HTML

Added in API level 10

public static final String EXTRA_VOICE_SEARCH_RESULT_HTML

The key to an extra ArrayList of Strings that contains the html content to use, if available, for the recognition alternates provided in EXTRA_VOICE_SEARCH_RESULT_STRINGS. This list should always be the same size as the one provided in EXTRA_VOICE_SEARCH_RESULT_STRINGS - if a result cannot provide html, that entry in this list should be null, and the implementor of ACTION_VOICE_SEARCH_RESULTS should back off to the corresponding url provided in EXTRA_VOICE_SEARCH_RESULT_URLS, if available, or else should execute a search of its own choosing, based on the recognition result string. Currently this html content should be expected in the form of a uri with scheme URI_SCHEME_INLINE for the Browser. In the future this may change to a "content://" uri or some other identifier. Anyone who reads this extra should confirm that a result is in fact an "inline:" uri and back off to the urls or strings gracefully if it is not, thus maintaining future backwards compatibility if this changes.

Constant Value: "android.speech.extras.VOICE_SEARCH_RESULT_HTML"

EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS

Added in API level 10

public static final String EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS

The key to an extra ArrayList of Strings that contains the base url to assume when interpreting html provided in EXTRA_VOICE_SEARCH_RESULT_HTML. A list of size 1 may be provided to apply the same base url to all html results. A list of the same size as EXTRA_VOICE_SEARCH_RESULT_STRINGS may be provided to apply different base urls to each different html result in the EXTRA_VOICE_SEARCH_RESULT_HTML list.

Constant Value: "android.speech.extras.VOICE_SEARCH_RESULT_HTML_BASE_URLS"

EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS

Added in API level 10

public static final String EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS

The key to an extra ArrayList of Bundles that contains key/value pairs. All the values and the keys are Strings. Each key/value pair represents an extra HTTP header. The keys can't be the standard HTTP headers as they are set by the WebView. A list of size 1 may be provided to apply the same HTTP headers to all web results. A list of the same size as EXTRA_VOICE_SEARCH_RESULT_STRINGS may be provided to apply different HTTP headers to each different web result in the list. These headers will only be used in the case that the url for a particular web result (from EXTRA_VOICE_SEARCH_RESULT_URLS) is loaded.

Constant Value: "android.speech.extras.EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS"

EXTRA_VOICE_SEARCH_RESULT_STRINGS

Added in API level 10

public static final String EXTRA_VOICE_SEARCH_RESULT_STRINGS

The key to an extra ArrayList of Strings that contains the list of recognition alternates from voice search, in order from highest to lowest confidence.

Constant Value: "android.speech.extras.VOICE_SEARCH_RESULT_STRINGS"

EXTRA_VOICE_SEARCH_RESULT_URLS

Added in API level 10

public static final String EXTRA_VOICE_SEARCH_RESULT_URLS

The key to an extra ArrayList of Strings that contains the search urls to use, if available, for the recognition alternates provided in EXTRA_VOICE_SEARCH_RESULT_STRINGS. This list should always be the same size as the one provided in EXTRA_VOICE_SEARCH_RESULT_STRINGS - if a result cannot provide a search url, that entry in this ArrayList should be null, and the implementor of ACTION_VOICE_SEARCH_RESULTS should execute a search of its own choosing, based on the recognition result string.

Constant Value: "android.speech.extras.VOICE_SEARCH_RESULT_URLS"

URI_SCHEME_INLINE

Added in API level 10

public static final String URI_SCHEME_INLINE

The scheme used currently for html content in EXTRA_VOICE_SEARCH_RESULT_HTML. Note that this should only be used in tandem with this particular extra; it should NOT be used for generic URIs such as those found in the data field of an Intent.

Constant Value: "inline"