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

Commit 0c8855d0 authored by Jean-Michel Trivi's avatar Jean-Michel Trivi
Browse files

New AudioAttributes usage for "assistant" use case 

Define USAGE_ASSISTANT for new use cases involving audio help,
  query responses and more.

Test: make offline-sdk-docs
Bug: 30947943

Change-Id: Idf93ce4c0f014dbc9b491244cbad9e643cc03413
parent 17f739d9

api/current.txt

+1 −0
Original line number Diff line number Diff line
@@ -19948,6 +19948,7 @@ package android.media { 
    field public static final int USAGE_ASSISTANCE_ACCESSIBILITY = 11; // 0xb

    field public static final int USAGE_ASSISTANCE_NAVIGATION_GUIDANCE = 12; // 0xc

    field public static final int USAGE_ASSISTANCE_SONIFICATION = 13; // 0xd

    field public static final int USAGE_ASSISTANT = 16; // 0x10

    field public static final int USAGE_GAME = 14; // 0xe

    field public static final int USAGE_MEDIA = 1; // 0x1

    field public static final int USAGE_NOTIFICATION = 5; // 0x5

api/system-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -21442,6 +21442,7 @@ package android.media { 
    field public static final int USAGE_ASSISTANCE_ACCESSIBILITY = 11; // 0xb

    field public static final int USAGE_ASSISTANCE_NAVIGATION_GUIDANCE = 12; // 0xc

    field public static final int USAGE_ASSISTANCE_SONIFICATION = 13; // 0xd

    field public static final int USAGE_ASSISTANT = 16; // 0x10

    field public static final int USAGE_GAME = 14; // 0xe

    field public static final int USAGE_MEDIA = 1; // 0x1

    field public static final int USAGE_NOTIFICATION = 5; // 0x5

api/test-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -20035,6 +20035,7 @@ package android.media { 
    field public static final int USAGE_ASSISTANCE_ACCESSIBILITY = 11; // 0xb

    field public static final int USAGE_ASSISTANCE_NAVIGATION_GUIDANCE = 12; // 0xc

    field public static final int USAGE_ASSISTANCE_SONIFICATION = 13; // 0xd

    field public static final int USAGE_ASSISTANT = 16; // 0x10

    field public static final int USAGE_GAME = 14; // 0xe

    field public static final int USAGE_MEDIA = 1; // 0x1

    field public static final int USAGE_NOTIFICATION = 5; // 0x5

media/java/android/media/AudioAttributes.java

+14 −2
Original line number Diff line number Diff line
@@ -169,6 +169,11 @@ public final class AudioAttributes implements Parcelable { 
     * source, such as audio capture devices.

     */

    public final static int USAGE_VIRTUAL_SOURCE = 15;

    /**

     * Usage value to use for audio responses to user queries, audio instructions or help

     * utterances.

     */

    public final static int USAGE_ASSISTANT = 16;



    /**

     * IMPORTANT: when adding new usage types, add them to SDK_USAGES and update SUPPRESSIBLE_USAGES
@@ -227,7 +232,8 @@ public final class AudioAttributes implements Parcelable { 
            USAGE_ASSISTANCE_ACCESSIBILITY,

            USAGE_ASSISTANCE_NAVIGATION_GUIDANCE,

            USAGE_ASSISTANCE_SONIFICATION,

            USAGE_GAME

            USAGE_GAME,

            USAGE_ASSISTANT,

    };



    /**
@@ -473,6 +479,7 @@ public final class AudioAttributes implements Parcelable { 
         *     {@link AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT},

         *     {@link AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED},

         *     {@link AudioAttributes#USAGE_NOTIFICATION_EVENT},

         *     {@link AudioAttributes#USAGE_ASSISTANT},

         *     {@link AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY},

         *     {@link AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE},

         *     {@link AudioAttributes#USAGE_ASSISTANCE_SONIFICATION},
@@ -497,6 +504,7 @@ public final class AudioAttributes implements Parcelable { 
                case USAGE_ASSISTANCE_SONIFICATION:

                case USAGE_GAME:

                case USAGE_VIRTUAL_SOURCE:

                case USAGE_ASSISTANT:

                     mUsage = usage;

                     break;

                default:
@@ -844,6 +852,8 @@ public final class AudioAttributes implements Parcelable { 
                return new String("USAGE_ASSISTANCE_SONIFICATION");

            case USAGE_GAME:

                return new String("USAGE_GAME");

            case USAGE_ASSISTANT:

                return new String("USAGE_ASSISTANT");

            default:

                return new String("unknown usage " + usage);

        }
@@ -923,6 +933,7 @@ public final class AudioAttributes implements Parcelable { 
            case USAGE_MEDIA:

            case USAGE_GAME:

            case USAGE_ASSISTANCE_NAVIGATION_GUIDANCE:

            case USAGE_ASSISTANT:

                return AudioSystem.STREAM_MUSIC;

            case USAGE_ASSISTANCE_SONIFICATION:

                return AudioSystem.STREAM_SYSTEM;
@@ -972,7 +983,8 @@ public final class AudioAttributes implements Parcelable { 
        USAGE_ASSISTANCE_ACCESSIBILITY,

        USAGE_ASSISTANCE_NAVIGATION_GUIDANCE,

        USAGE_ASSISTANCE_SONIFICATION,

        USAGE_GAME

        USAGE_GAME,

        USAGE_ASSISTANT,

    })

    @Retention(RetentionPolicy.SOURCE)

    public @interface AttributeUsage {}