/* * 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() { } }