public class RecognizerResultsIntent extends Object
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.Modifier and Type | Field and Description |
---|---|
static 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.
|
static 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 . |
static 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 . |
static String |
EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS
|
static String |
EXTRA_VOICE_SEARCH_RESULT_STRINGS
|
static 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 . |
static String |
URI_SCHEME_INLINE
The scheme used currently for html content in
EXTRA_VOICE_SEARCH_RESULT_HTML . |
public static final String ACTION_VOICE_SEARCH_RESULTS
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
.public static final String EXTRA_VOICE_SEARCH_RESULT_STRINGS
ArrayList
of String
s that contains the list of
recognition alternates from voice search, in order from highest to lowest confidence.public static final String EXTRA_VOICE_SEARCH_RESULT_URLS
ArrayList
of String
s 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.public static final String EXTRA_VOICE_SEARCH_RESULT_HTML
ArrayList
of String
s 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.public static final String EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS
ArrayList
of String
s 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.public static final String EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS
ArrayList
of Bundle
s that contains key/value pairs.
All the values and the keys are String
s. 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.public static final String URI_SCHEME_INLINE
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.