添加语音功能
编写: kesenhoo - 原文: http://developer.android.com/training/wearables/apps/voice.html
语音指令是可穿戴体验的一个重要的部分。这使得用户可以释放双手,快速发出指令。穿戴提供了2种类型的语音操作:
系统提供的
这些语音指令都是基于任务的,并且内置在Wear的平台内。我们在activity中过滤我们想要接收的指令。例如包含”Take a note” 或者 “Set an alarm”的指令。
应用提供的
这些语音指令都是基于应用的,我们需要像声明一个Launcher Icon一样声明这些指令。用户通过说”Start “来使用那些语音指令,然后会启动我们指定启动的activity。
声明系统提供的语音指令
Android Wear平台基于用户的操作提供了一些语音指令,例如”Take a note” 或者 “Set an alarm”。用户发出想要做的操作指令,让系统启动最合适的activity。
当用户说出语音指令时,我们的应用能够过滤出用于启动activity的intent。如果我们想要启动一个在后台执行任务的service,需要显示一个activity作为视觉线索,并且在该activity中启动service。当我们想要废弃这个视觉线索时,需要确保执行了finish()。
例如,对于”Take a note”的指令,声明下面这个intent filter来启动一个名为MyNoteActivity
的activity:
<activity android:name="MyNoteActivity">
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="com.google.android.voicesearch.SELF_NOTE" />
</intent-filter>
</activity>
下面列出了Wear平台支持的语音指令:
关于注册intent与获取intent extra的信息,请参考Common intents.
声明应用提供的语音指令
如果系统提供的语音指令无法满足我们的需求,我们可以使用”Start MyActivityName”语音指令来直接启动我们的应用。
注册一个”Start”指令的方法和注册手持应用上的Launcher Icon是一样的。除了在launcher里面需要一个应用图标,而我们的应用需要一个语音指令。
为了指定在”Start”指令之后需要说出的文本, 我们需要指定想要启动的activity的label
属性。例如,下面的intent filter能够识别”Start MyRunningApp”语音指令并启动StartRunActivity
。
<application>
<activity android:name="StartRunActivity" android:label="MyRunningApp">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
获取自由格式的语音输入
除了使用语音指令来启动activity之外,我们也可以执行系统内置的语言识别activity来获取用户的语音输入。这对于获取用户的输入信息非常有帮助,例如执行搜索或者发送一个消息。
在我们的应用中,使用ACTION_RECOGNIZE_SPEECH action并调用startActivityForResult()。这样可以启动系统语音识别应用,并且我们可以在onActivityResult()中处理返回的结果:
private static final int SPEECH_REQUEST_CODE = 0;
// Create an intent that can start the Speech Recognizer activity
private void displaySpeechRecognizer() {
Intent intent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL,
RecognizerIntent.LANGUAGE_MODEL_FREE_FORM);
// Start the activity, the intent will be populated with the speech text
startActivityForResult(intent, SPEECH_REQUEST_CODE);
}
// This callback is invoked when the Speech Recognizer returns.
// This is where you process the intent and extract the speech text from the intent.
@Override
protected void onActivityResult(int requestCode, int resultCode,
Intent data) {
if (requestCode == SPEECH_REQUEST && resultCode == RESULT_OK) {
List<String> results = data.getStringArrayListExtra(
RecognizerIntent.EXTRA_RESULTS);
String spokenText = results.get(0);
// Do something with spokenText
}
super.onActivityResult(requestCode, resultCode, data);
}