public class RecognizerResultsIntent
extends Object
| java.lang.Object | |
| ↳ | android.speech.RecognizerResultsIntent |
与显示语音识别结果有关的意图常量。 正常使用语音识别时，不需要这些常量。 只有在您想要在应用程序中触发语音搜索结果时才会调用它们，或者如果您希望为应用程序为语音搜索结果提供不同的视图，就会执行它们。 对于接收ACTION_VOICE_SEARCH_RESULTS用户，此处的标准行为是首先检索EXTRA_VOICE_SEARCH_RESULT_STRINGS的列表，并使用任何提供的HTML代替EXTRA_VOICE_SEARCH_RESULT_HTML中的结果（如果有），以显示搜索结果。 如果不可用，那么应使用EXTRA_VOICE_SEARCH_RESULT_URLS相应的结果url。 如果连这个都不可用，那么应该从实际的识别结果字符串中构建一个搜索URL。
Constants |
|
|---|---|
String |
ACTION_VOICE_SEARCH_RESULTS 意图可以通过语音搜索的实现来发送，以便在例如网络浏览器中显示搜索结果。 |
String |
EXTRA_VOICE_SEARCH_RESULT_HTML
|
String |
EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS
|
String |
EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS |
String |
EXTRA_VOICE_SEARCH_RESULT_STRINGS 一个额外的 |
String |
EXTRA_VOICE_SEARCH_RESULT_URLS 一个额外的 |
String |
URI_SCHEME_INLINE 该方案目前用于HTML内容 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String ACTION_VOICE_SEARCH_RESULTS
意图可以通过语音搜索的实现来发送，以便在例如网络浏览器中显示搜索结果。 这个意图应该总是伴随着至少EXTRA_VOICE_SEARCH_RESULT_STRINGS ，并且可选地但是推荐的， EXTRA_VOICE_SEARCH_RESULT_URLS ，并且有时EXTRA_VOICE_SEARCH_RESULT_HTML和EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS 。 这些是并行数组，其中索引N为EXTRA_VOICE_SEARCH_RESULT_STRINGS的识别结果字符串应该附带一个url，用于基于索引N处的那个字符串搜索EXTRA_VOICE_SEARCH_RESULT_URLS ，并且可能需要在索引N处显示该结果的完整html EXTRA_VOICE_SEARCH_RESULT_HTML 。 如果提供了完整的html，则应该提供EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS的基本url（或基本url的列表）。
常量值：“android.speech.action.VOICE_SEARCH_RESULTS”
String EXTRA_VOICE_SEARCH_RESULT_HTML
ArrayList的附加ArrayList的String ，其中包含要使用的HTML内容（如果可用）用于EXTRA_VOICE_SEARCH_RESULT_STRINGS提供的识别替换EXTRA_VOICE_SEARCH_RESULT_STRINGS 。 此列表应始终与EXTRA_VOICE_SEARCH_RESULT_STRINGS提供的列表大小相同 - 如果结果不能提供html，则此列表中的该条目应该为null ，并且实现者ACTION_VOICE_SEARCH_RESULTS应退回到EXTRA_VOICE_SEARCH_RESULT_URLS提供的相应url（如果可用）否则应根据识别结果字符串执行自己选择的搜索。 目前这个html内容应该以浏览器的方案URI_SCHEME_INLINE为uri的形式。 将来可能会变成“content：//”uri或其他标识符。 任何读取此额外内容的人都应确认结果实际上是“inline：”uri，如果不是，则优雅地返回到url或字符串，从而保持未来的向后兼容性（如果此更改）。
常量值：“android.speech.extras.VOICE_SEARCH_RESULT_HTML”
String EXTRA_VOICE_SEARCH_RESULT_HTML_BASE_URLS
ArrayList的附加ArrayList的String ，包含在解释EXTRA_VOICE_SEARCH_RESULT_HTML提供的html时假定的基础url。 可以提供大小为1的列表以将相同的基本URL应用于所有html结果。 与EXTRA_VOICE_SEARCH_RESULT_STRINGS相同大小的列表可以被提供以将不同的基址应用于EXTRA_VOICE_SEARCH_RESULT_HTML列表中的每个不同的html结果。
常量值：“android.speech.extras.VOICE_SEARCH_RESULT_HTML_BASE_URLS”
String EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS
一个额外的关键ArrayList的Bundle包含键/值对秒。 所有的值和密钥都是String 。 每个键/值对代表一个额外的HTTP头。 这些密钥不能是标准HTTP标头，因为它们是由WebView设置的。 可以提供大小为1的列表以将相同的HTTP报头应用于所有网络结果。 可以提供与EXTRA_VOICE_SEARCH_RESULT_STRINGS相同大小的列表，以将不同的HTTP报头应用于列表中的每个不同的web结果。 这些标题仅在加载特定Web结果的URL（来自EXTRA_VOICE_SEARCH_RESULT_URLS ）的情况下使用。
常量值：“android.speech.extras.EXTRA_VOICE_SEARCH_RESULT_HTTP_HEADERS”
String EXTRA_VOICE_SEARCH_RESULT_STRINGS
一个额外的 ArrayList的关键是 String s，其中包含来自语音搜索的识别交替列表，从最高到最低的置信度。
常量值：“android.speech.extras.VOICE_SEARCH_RESULT_STRINGS”
String EXTRA_VOICE_SEARCH_RESULT_URLS
ArrayList的额外ArrayList的String ，其中包含搜索网址（如果可用）用于EXTRA_VOICE_SEARCH_RESULT_STRINGS提供的识别备选项。 此列表应始终与EXTRA_VOICE_SEARCH_RESULT_STRINGS提供的列表大小相同 - 如果结果无法提供搜索url，则此ArrayList中的该条目应该为null ，并且实现者ACTION_VOICE_SEARCH_RESULTS应执行基于其自身选择的搜索识别结果字符串。
常量值：“android.speech.extras.VOICE_SEARCH_RESULT_URLS”
String URI_SCHEME_INLINE
该方案目前用于HTML内容EXTRA_VOICE_SEARCH_RESULT_HTML 。 请注意，这只能与这个特定的额外配合使用; 它不应该用于通用URI，例如在Intent的数据字段中找到的通用URI。
常量值：“内联”
Android开发手册