/*
* Copyright (C) 2017 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.googlecode.android_scripting.facade;
import android.content.Intent;
import android.speech.RecognizerIntent;
import com.googlecode.android_scripting.jsonrpc.RpcReceiver;
import com.googlecode.android_scripting.rpc.Rpc;
import com.googlecode.android_scripting.rpc.RpcOptional;
import com.googlecode.android_scripting.rpc.RpcParameter;
import java.util.ArrayList;
/**
* A facade containing RPC implementations related to the speech-to-text functionality of Android.
*
*
*/
public class SpeechRecognitionFacade extends RpcReceiver {
private final AndroidFacade mAndroidFacade;
/**
* @param activityLauncher
* a helper object that launches activities in a blocking manner
*/
public SpeechRecognitionFacade(FacadeManager manager) {
super(manager);
mAndroidFacade = manager.getReceiver(AndroidFacade.class);
}
@Rpc(description = "Recognizes user's speech and returns the most likely result.", returns = "An empty string in case the speech cannot be recongnized.")
public String recognizeSpeech(
@RpcParameter(name = "prompt", description = "text prompt to show to the user when asking them to speak") @RpcOptional final String prompt,
@RpcParameter(name = "language", description = "language override to inform the recognizer that it should expect speech in a language different than the one set in the java.util.Locale.getDefault()") @RpcOptional final String language,
@RpcParameter(name = "languageModel", description = "informs the recognizer which speech model to prefer (see android.speech.RecognizeIntent)") @RpcOptional final String languageModel) {
final Intent recognitionIntent =
new Intent(android.speech.RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
// Setup intent parameters (if provided).
if (language != null) {
recognitionIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE, "");
}
if (languageModel != null) {
recognitionIntent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, "");
}
if (prompt != null) {
recognitionIntent.putExtra(RecognizerIntent.EXTRA_PROMPT, "");
}
// Run the activity an retrieve the result.
final Intent data = mAndroidFacade.startActivityForResult(recognitionIntent);
if (data.hasExtra(android.speech.RecognizerIntent.EXTRA_RESULTS)) {
// The result consists of an array-list containing one entry for each
// possible result. The most likely result is the first entry.
ArrayList<String> results =
data.getStringArrayListExtra(android.speech.RecognizerIntent.EXTRA_RESULTS);
return results.get(0);
}
return "";
}
@Override
public void shutdown() {
}
}