将语音搜索集成到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》一书。