1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.example.android.apis.app;
18 
19 import com.example.android.apis.R;
20 
21 import android.app.Activity;
22 import android.content.BroadcastReceiver;
23 import android.content.Context;
24 import android.content.Intent;
25 import android.content.pm.PackageManager;
26 import android.content.pm.ResolveInfo;
27 import android.os.Bundle;
28 import android.os.Handler;
29 import android.speech.RecognizerIntent;
30 import android.util.Log;
31 import android.view.View;
32 import android.view.View.OnClickListener;
33 import android.widget.ArrayAdapter;
34 import android.widget.Button;
35 import android.widget.ListView;
36 import android.widget.Spinner;
37 import android.widget.SpinnerAdapter;
38 import android.widget.TextView;
39 import android.widget.Toast;
40 
41 import java.util.ArrayList;
42 import java.util.List;
43 
44 /**
45  * Sample code that invokes the speech recognition intent API.
46  */
47 public class VoiceRecognition extends Activity implements OnClickListener {
48 
49     private static final String TAG = "VoiceRecognition";
50 
51     private static final int VOICE_RECOGNITION_REQUEST_CODE = 1234;
52 
53     private ListView mList;
54 
55     private Handler mHandler;
56 
57     private Spinner mSupportedLanguageView;
58 
59     /**
60      * Called with the activity is first created.
61      */
62     @Override
onCreate(Bundle savedInstanceState)63     public void onCreate(Bundle savedInstanceState) {
64         super.onCreate(savedInstanceState);
65         mHandler = new Handler();
66 
67         // Inflate our UI from its XML layout description.
68         setContentView(R.layout.voice_recognition);
69 
70         // Get display items for later interaction
71         Button speakButton = (Button) findViewById(R.id.btn_speak);
72 
73         mList = (ListView) findViewById(R.id.list);
74 
75         mSupportedLanguageView = (Spinner) findViewById(R.id.supported_languages);
76 
77         // Check to see if a recognition activity is present
78         PackageManager pm = getPackageManager();
79         List<ResolveInfo> activities = pm.queryIntentActivities(
80                 new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH), 0);
81         if (activities.size() != 0) {
82             speakButton.setOnClickListener(this);
83         } else {
84             speakButton.setEnabled(false);
85             speakButton.setText("Recognizer not present");
86         }
87 
88         // Most of the applications do not have to handle the voice settings. If the application
89         // does not require a recognition in a specific language (i.e., different from the system
90         // locale), the application does not need to read the voice settings.
91         refreshVoiceSettings();
92     }
93 
94     /**
95      * Handle the click on the start recognition button.
96      */
onClick(View v)97     public void onClick(View v) {
98         if (v.getId() == R.id.btn_speak) {
99             startVoiceRecognitionActivity();
100         }
101     }
102 
103     /**
104      * Fire an intent to start the speech recognition activity.
105      */
startVoiceRecognitionActivity()106     private void startVoiceRecognitionActivity() {
107         Intent intent = new Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH);
108 
109         // Specify the calling package to identify your application
110         intent.putExtra(RecognizerIntent.EXTRA_CALLING_PACKAGE, getClass().getPackage().getName());
111 
112         // Display an hint to the user about what they should say.
113         intent.putExtra(RecognizerIntent.EXTRA_PROMPT, "Speech recognition demo");
114 
115         // Given an hint to the recognizer about what the user is going to say
116         intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL,
117                 RecognizerIntent.LANGUAGE_MODEL_FREE_FORM);
118 
119         // Specify how many results you want to receive. The results will be sorted
120         // where the first result is the one with higher confidence.
121         intent.putExtra(RecognizerIntent.EXTRA_MAX_RESULTS, 5);
122 
123         // Specify the recognition language. This parameter has to be specified only if the
124         // recognition has to be done in a specific language and not the default one (i.e., the
125         // system locale). Most of the applications do not have to set this parameter.
126         if (!mSupportedLanguageView.getSelectedItem().toString().equals("Default")) {
127             intent.putExtra(RecognizerIntent.EXTRA_LANGUAGE,
128                     mSupportedLanguageView.getSelectedItem().toString());
129         }
130 
131         startActivityForResult(intent, VOICE_RECOGNITION_REQUEST_CODE);
132     }
133 
134     /**
135      * Handle the results from the recognition activity.
136      */
137     @Override
onActivityResult(int requestCode, int resultCode, Intent data)138     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
139         if (requestCode == VOICE_RECOGNITION_REQUEST_CODE && resultCode == RESULT_OK) {
140             // Fill the list view with the strings the recognizer thought it could have heard
141             ArrayList<String> matches = data.getStringArrayListExtra(
142                     RecognizerIntent.EXTRA_RESULTS);
143             mList.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1,
144                     matches));
145         }
146 
147         super.onActivityResult(requestCode, resultCode, data);
148     }
149 
refreshVoiceSettings()150     private void refreshVoiceSettings() {
151         Log.i(TAG, "Sending broadcast");
152         sendOrderedBroadcast(RecognizerIntent.getVoiceDetailsIntent(this), null,
153                 new SupportedLanguageBroadcastReceiver(), null, Activity.RESULT_OK, null, null);
154     }
155 
updateSupportedLanguages(List<String> languages)156     private void updateSupportedLanguages(List<String> languages) {
157         // We add "Default" at the beginning of the list to simulate default language.
158         languages.add(0, "Default");
159 
160         SpinnerAdapter adapter = new ArrayAdapter<CharSequence>(this,
161                 android.R.layout.simple_spinner_item, languages.toArray(
162                         new String[languages.size()]));
163         mSupportedLanguageView.setAdapter(adapter);
164     }
165 
updateLanguagePreference(String language)166     private void updateLanguagePreference(String language) {
167         TextView textView = (TextView) findViewById(R.id.language_preference);
168         textView.setText(language);
169     }
170 
171     /**
172      * Handles the response of the broadcast request about the recognizer supported languages.
173      *
174      * The receiver is required only if the application wants to do recognition in a specific
175      * language.
176      */
177     private class SupportedLanguageBroadcastReceiver extends BroadcastReceiver {
178 
179         @Override
onReceive(Context context, final Intent intent)180         public void onReceive(Context context, final Intent intent) {
181             Log.i(TAG, "Receiving broadcast " + intent);
182 
183             final Bundle extra = getResultExtras(false);
184 
185             if (getResultCode() != Activity.RESULT_OK) {
186                 mHandler.post(new Runnable() {
187                     @Override
188                     public void run() {
189                         showToast("Error code:" + getResultCode());
190                     }
191                 });
192             }
193 
194             if (extra == null) {
195                 mHandler.post(new Runnable() {
196                     @Override
197                     public void run() {
198                         showToast("No extra");
199                     }
200                 });
201             }
202 
203             if (extra.containsKey(RecognizerIntent.EXTRA_SUPPORTED_LANGUAGES)) {
204                 mHandler.post(new Runnable() {
205 
206                     @Override
207                     public void run() {
208                         updateSupportedLanguages(extra.getStringArrayList(
209                                 RecognizerIntent.EXTRA_SUPPORTED_LANGUAGES));
210                     }
211                 });
212             }
213 
214             if (extra.containsKey(RecognizerIntent.EXTRA_LANGUAGE_PREFERENCE)) {
215                 mHandler.post(new Runnable() {
216 
217                     @Override
218                     public void run() {
219                         updateLanguagePreference(
220                                 extra.getString(RecognizerIntent.EXTRA_LANGUAGE_PREFERENCE));
221                     }
222                 });
223             }
224         }
225 
showToast(String text)226         private void showToast(String text) {
227             Toast.makeText(VoiceRecognition.this, text, 1000).show();
228         }
229     }
230 }
231