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

Commit ff88e582 authored by Simon Bowden's avatar Simon Bowden
Browse files

Introduce RingtoneSelection for carrying ringtone preference information. 

Notably, this class isn't intended to support setting a VibrationEffect -
such an effect should only be set via a Uri pointing to a serialized one.
The "effect" setting on the vibration source refers to a contextual one
(such as one set on a notification channel).

Bug: 272282867
Test: cts
Change-Id: Ide5cccbd3fbee4553885eaa8b80accd1169a9cd7
parent ece5be62

core/api/test-current.txt

+33 −0
Original line number Diff line number Diff line
@@ -1971,6 +1971,39 @@ package android.media { 
    method public android.media.PlaybackParams setAudioStretchMode(int);

  }



  public final class RingtoneSelection {

    method @NonNull public static android.media.RingtoneSelection fromUri(@Nullable android.net.Uri, int);

    method public int getSoundSource();

    method @Nullable public android.net.Uri getSoundUri();

    method public int getVibrationSource();

    method @Nullable public android.net.Uri getVibrationUri();

    method public static boolean isRingtoneSelectionUri(@Nullable android.net.Uri);

    method @NonNull public android.net.Uri toUri();

    field public static final String DEFAULT_SELECTION_URI_STRING = "content://media/ringtone";

    field public static final int FROM_URI_RINGTONE_SELECTION_ONLY = 3; // 0x3

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

    field public static final int FROM_URI_RINGTONE_SELECTION_OR_VIBRATION = 2; // 0x2

    field public static final int SOUND_SOURCE_DEFAULT = 0; // 0x0

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

    field public static final int SOUND_SOURCE_URI = 2; // 0x2

    field public static final int VIBRATION_SOURCE_APPLICATION_PROVIDED = 3; // 0x3

    field public static final int VIBRATION_SOURCE_AUDIO_CHANNEL = 10; // 0xa

    field public static final int VIBRATION_SOURCE_DEFAULT = 0; // 0x0

    field public static final int VIBRATION_SOURCE_HAPTIC_GENERATOR = 11; // 0xb

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

    field public static final int VIBRATION_SOURCE_URI = 2; // 0x2

  }



  public static final class RingtoneSelection.Builder {

    ctor public RingtoneSelection.Builder();

    ctor public RingtoneSelection.Builder(@NonNull android.media.RingtoneSelection);

    method @NonNull public android.media.RingtoneSelection build();

    method @NonNull public android.media.RingtoneSelection.Builder setSoundSource(int);

    method @NonNull public android.media.RingtoneSelection.Builder setSoundSource(@NonNull android.net.Uri);

    method @NonNull public android.media.RingtoneSelection.Builder setVibrationSource(int);

    method @NonNull public android.media.RingtoneSelection.Builder setVibrationSource(@NonNull android.net.Uri);

  }



  public static final class VolumeShaper.Configuration.Builder {

    method @NonNull public android.media.VolumeShaper.Configuration.Builder setOptionFlags(int);

  }