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

Commit fb71314a authored by Mike LeBeau's avatar Mike LeBeau Committed by Android (Google) Code Review
Browse files

Merge "Add the API constants to support providing hint strings in the response... 

Merge "Add the API constants to support providing hint strings in the response to RecognizerIntent.ACTION_GET_LANGUAGE_DETAILS."
parents e55691e3 e49afd86

common/java/com/android/common/speech/Recognition.java

+35 −2
Original line number Diff line number Diff line
@@ -19,7 +19,8 @@ package com.android.common.speech; 
/**

 * Utilities for voice recognition implementations.

 *

 * @see android.app.RecognitionService

 * @see android.speech.RecognitionService

 * @see android.speech.RecognizerIntent

 */

public class Recognition {
@@ -30,7 +31,39 @@ public class Recognition { 
     * is set by anyone but the system process, it should be overridden by the voice search

     * implementation.

     */

    public final static String EXTRA_CALLING_PACKAGE = "calling_package";

    public static final String EXTRA_CALLING_PACKAGE = "calling_package";

    

    /**

     * The key to the extra in the Bundle returned by

     * android.speech.RecognizerIntent#ACTION_GET_LANGUAGE_DETAILS

     * which is an ArrayList of CharSequences which are hints that can be shown to

     * the user for voice actions currently supported by voice search for the user's current

     * language preference for voice search (i.e., the one defined in the extra

     * android.speech.RecognizerIntent#EXTRA_LANGUAGE_PREFERENCE).

     *

     * If this is paired with EXTRA_HINT_CONTEXT, should return a set of hints that are

     * appropriate for the provided context.

     *

     * The CharSequences are SpannedStrings and will contain segments wrapped in

     * <annotation action="true"></annotation>. This is to indicate the section of the text

     * which represents the voice action, to be highlighted in the UI if so desired.

     */

    public static final String EXTRA_HINT_STRINGS = "android.speech.extra.HINT_STRINGS";

    

    /**

     * The key to an extra to be included in the request intent for

     * android.speech.RecognizerIntent#ACTION_GET_LANGUAGE_DETAILS.

     * Should be an int of one of the values defined below. If an

     * unknown int value is provided, it should be ignored.

     */

    public static final String EXTRA_HINT_CONTEXT = "android.speech.extra.HINT_CONTEXT";

    

    /**

     * A set of values for EXTRA_HINT_CONTEXT.

     */

    public static final int HINT_CONTEXT_UNKNOWN = 0;

    public static final int HINT_CONTEXT_VOICE_SEARCH_HELP = 1;

    public static final int HINT_CONTEXT_CAR_HOME = 2;



    private Recognition() { }   // don't instantiate

}