diff options
| author | Dirk Dougherty <ddougherty@google.com> | 2013-09-14 02:50:15 +0000 |
|---|---|---|
| committer | Android (Google) Code Review <android-gerrit@google.com> | 2013-09-14 02:50:16 +0000 |
| commit | 6212f6b3c5c92298fedbb37f5ceb0094b770549b (patch) | |
| tree | 6e81effb4c090e763ff5b0266b8f89179e967102 | |
| parent | 1294a8f9a2ccc4e19d218dbe8645ddac533706d8 (diff) | |
| parent | 76b02e4e14f5326a0cf507ae27525be575ab42ba (diff) | |
| download | frameworks_base-6212f6b3c5c92298fedbb37f5ceb0094b770549b.zip frameworks_base-6212f6b3c5c92298fedbb37f5ceb0094b770549b.tar.gz frameworks_base-6212f6b3c5c92298fedbb37f5ceb0094b770549b.tar.bz2 | |
Merge "Update documentation for speech APIs." into jb-mr2-docs
| -rw-r--r-- | core/java/android/speech/RecognizerIntent.java | 5 | ||||
| -rw-r--r-- | core/java/android/speech/SpeechRecognizer.java | 10 |
2 files changed, 12 insertions, 3 deletions
diff --git a/core/java/android/speech/RecognizerIntent.java b/core/java/android/speech/RecognizerIntent.java index 457e66c..e991d84 100644 --- a/core/java/android/speech/RecognizerIntent.java +++ b/core/java/android/speech/RecognizerIntent.java @@ -55,7 +55,10 @@ public class RecognizerIntent { * <p>Starting this intent with just {@link Activity#startActivity(Intent)} is not supported. * You must either use {@link Activity#startActivityForResult(Intent, int)}, or provide a * PendingIntent, to receive recognition results. - * + * + * <p>The implementation of this API is likely to stream audio to remote servers to perform + * speech recognition which can use a substantial amount of bandwidth. + * * <p>Required extras: * <ul> * <li>{@link #EXTRA_LANGUAGE_MODEL} diff --git a/core/java/android/speech/SpeechRecognizer.java b/core/java/android/speech/SpeechRecognizer.java index 8fee41d..94aedbd 100644 --- a/core/java/android/speech/SpeechRecognizer.java +++ b/core/java/android/speech/SpeechRecognizer.java @@ -39,8 +39,14 @@ import java.util.Queue; * This class provides access to the speech recognition service. This service allows access to the * speech recognizer. Do not instantiate this class directly, instead, call * {@link SpeechRecognizer#createSpeechRecognizer(Context)}. This class's methods must be - * invoked only from the main application thread. Please note that the application must have - * {@link android.Manifest.permission#RECORD_AUDIO} permission to use this class. + * invoked only from the main application thread. + * + * <p>The implementation of this API is likely to stream audio to remote servers to perform speech + * recognition. As such this API is not intended to be used for continuous recognition, which would + * consume a significant amount of battery and bandwidth. + * + * <p>Please note that the application must have {@link android.Manifest.permission#RECORD_AUDIO} + * permission to use this class. */ public class SpeechRecognizer { /** DEBUG value to enable verbose debug prints */ |