将语音搜索集成到Google Now中

原文标题：Use Voice Search to integrate with Google Now

原文链接：http://antonioleiva.com/voice_search_google_now/

原文作者：Antonio Leiva（http://antonioleiva.com/about/）

原文发布：2015-10-14

Android最棒的能力之一就是可以将我们的APP以不同的方式集成到它的生态链中。APP相互之间可以进行“交流”，这给予我们极大的灵活性来创建独特的应用体验。

集成Google应用就是一个典型的例子。有很多不同的特性可以帮助我们提升APP的知名度，如APP索引或一组强大的语音功能。

语音搜索

尽管，在APP中实现语音搜索的过程与任何其他语音功能类似，但是，在这篇文章中，我还是会聚焦在怎样在APP中实现语音搜索功能。你也可以在Play Music中尝试这个例子：

好，Google在Play Music中，搜索Beatles

这句指令将在Play Music APP中开启搜索Beatles。

怎样实现语音搜索

当语音搜索启动后，我们的APP将收到一个查询文字的Intent，我们必须捕捉和分析这段文字。所以，这第一部分是指定哪个Activity接收这条Intent：

<activity android:name=".MainActivity" android:launchMode="singleTask" >
<intent-filter>
<action android:name="com.google.android.gms.actions.SEARCH_ACTION"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</activity>

这个动作（action）称为com.google.android.gms.actions.SEARCH_ACTION，所以我们说MainActivity是处理这类Intent。另外，我用singleTask启动模式，这样MainActivity就仅仅创建一次。否则，每次收到这条Intent就要创建一个新的Activity实例。

接下来的一步是要在MainActivity内进行处理它。当我们用singleTask模式时，在Activity的两个不同位置上可以接收Intent：首先是用getIntent()创建Activity，接着是onNewIntent方法中。这样就要创建一个处理方法在需要它的时候调用它：

private static final String ACTION_VOICE_SEARCH = "com.google.android.gms.actions.SEARCH_ACTION";
　　...
private void handleVoiceSearch(Intent intent) {
if (intent != null && ACTION_VOICE_SEARCH.equals(intent.getAction())) {
String query = intent.getStringExtra(SearchManager.QUERY);
setSearchViewVisible(true);
searchView.setQuery(query, true);
}
}

这个方法检查Intent是否为空（null）或者是否是在收到查询文字前要检测的动作，它是Intent内部的额外动作。查询的额外动作关键字是SearchManager.QUERY。

在searchView后，设置查询，提交执行查询。其方法是onNewIntent：

@Override protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
handleVoiceSearch(intent);
}

UI也准备好（在我们的例子中，当菜单弹出时，我们访问SearchView），你稍后将看到。

在我的例子中，UI是基于工具栏（Toolbar）内部的SearchView。你可以在前面的文章中看到怎样实现SearchView，不过我还是稍作解释怎样做。首先，产生菜单动作（menu action）：

<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/action_search"
android:title="@string/action_search"
android:icon="@drawable/ic_search"
app:actionViewClass="android.support.v7.widget.SearchView"
app:showAsAction="ifRoom" />
</menu>

然后，在菜单弹出时，你请求SearchView：

@Override public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.main, menu);

MenuItem searchItem = menu.findItem(R.id.action_search);
searchView = (SearchView) MenuItemCompat.getActionView(searchItem);

searchView.setOnSearchClickListener(new View.OnClickListener() {
@Override public void onClick(View v) {
setSearchViewVisible(true);
}
});

searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
@Override public boolean onQueryTextSubmit(String query) {
Toast.makeText(MainActivity.this, query, Toast.LENGTH_LONG).show();
searchView.clearFocus();
return true;
}

@Override public boolean onQueryTextChange(String newText) {
return false;
}
});

handleVoiceSearch(getIntent());

return true;
}

private void setSearchViewVisible(boolean visible) {

if (searchView.isIconified() == visible) {
searchView.setIconified(!visible);
}

if (getSupportActionBar() != null) {
getSupportActionBar().setDisplayHomeAsUpEnabled(visible);
}
}

怎样尝试

由于APP需要发布到Play商店中，Google Now才能检测到APP，所以我们还不能直接从Google Now尝试这个例子。但是，我们可以用ADB来调试它。这条命令是：

adb shell am start -a com.google.android.gms.actions.SEARCH_ACTION -e query searchquery app_package

对于从我的代码库下载的例子，就可以这样做：

adb shell am start -a com.google.android.gms.actions.SEARCH_ACTION -e query VoiceSearch com.antonioleiva.googlenowsearch

在APP完全关闭和启动时，都可以尝试本例了。这样，就可以测试两种可能的途径了。

附加说明：Kotlin语言的实现

你可能知道，因为我认为Kotlin语言可以非常好替代Java语言，Kotlin可以使我们的代码更简洁、可读性更好，所以这些天讨论了许多Kotlin语言的特性。作为例子，我将简化onCreateOptionsMenu，你可以在同一个代码库中找到完整的代码。

实现扩展函数的能力可以帮助我们减少冗长代码。例如，可以为Menu创建一个扩展函数，基于action id找到ActionView，返回层级视图：

inline fun <reified T : View?> Menu.findCompatActionView(actionRes: Int): T {
val searchItem = findItem(actionRes)
return MenuItemCompat.getActionView(searchItem) as T
}

现在可以这样做：

searchView = menu.findCompatActionView(R.id.action_search)

另一个扩展函数可以以清晰的方式帮助我们编写OueryTextListener：

fun SearchView.onQueryText(submit: (String) -> Boolean = { false }, textChange: (String) -> Boolean = { false }) {

this.setOnQueryTextListener(object : SearchView.OnQueryTextListener {

override fun onQueryTextSubmit(query: String): Boolean = submit(query)

override fun onQueryTextChange(newText: String): Boolean = textChange(newText)

})
}

这个函数接收一对函数，一个用于侦听器中的每个方法，并给出它们的默认值。这样我们仅需要定义我们要用的。如果我们仅仅要第一个函数（对于第二个我们用默认的），现在我就可以这样做：

searchView.onQueryText ({
longToast(it)
searchView.clearFocus()
true
})

最终，这个函数就是这样的：

override fun onCreateOptionsMenu(menu: Menu): Boolean {
menuInflater.inflate(R.menu.main, menu)

searchView = menu.findCompatActionView(R.id.action_search)
searchView.setOnSearchClickListener { setSearchViewVisible(true) }

searchView.onQueryText ({
longToast(it)
searchView.clearFocus()
true
})

intent?.let { handleVoiceSearch(it) }

return true
}

如你所见，如果在这个位置上（例如：在一个常规activity创建上），Intent可以为null，就必须在使用它之前检查它是否为null。用let函数，可以避免if条件的创建，在对象调用时不为null，就可只进入对象内部。

如果你对Kotlin有兴趣，可以搜索Kotlin文章，或购买我编写的《Android开发者的Kotlin》一书。