Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2921cee3 authored by Marc Wilson's avatar Marc Wilson
Browse files

Update documentation for speech APIs. 

Makes it clear that the intent and service APIs are likely to stream
audio over the network and notes that impact this has on bandwidth and
battery life.
Also clarifies that the service API should not be used for continuous
recognition as a result. The intent API only runs when the activity is
in the foreground so I didn't mention continuous recognition for it.

Bug: 10674392
Change-Id: Ib5e0c16b3124f4b7d892ef5bd4167f23662d2ca3
parent e3d0f022

core/java/android/speech/RecognizerIntent.java

+4 −1
Original line number Diff line number Diff line
@@ -56,6 +56,9 @@ public class RecognizerIntent { 
     * 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}

core/java/android/speech/SpeechRecognizer.java

+8 −2
Original line number Diff line number Diff line
@@ -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 */