Revert "AudioAttributes: remove static getVolumeControlStream method"

This reverts commit e0b5bf50d6.

Change-Id: I2f3f10c149b205d22c41d5c9767ea10b0dee7682
This commit is contained in:
Jean-Michel Trivi
2017-04-04 18:26:44 +00:00
parent e0b5bf50d6
commit e4a9911b68
4 changed files with 26 additions and 0 deletions

View File

@@ -20888,6 +20888,7 @@ package android.media {
method public int getContentType();
method public int getFlags();
method public int getUsage();
method public static deprecated int getVolumeControlStream(android.media.AudioAttributes);
method public int getVolumeControlStream();
method public void writeToParcel(android.os.Parcel, int);
field public static final int CONTENT_TYPE_MOVIE = 3; // 0x3

View File

@@ -22628,6 +22628,7 @@ package android.media {
method public int getContentType();
method public int getFlags();
method public int getUsage();
method public static deprecated int getVolumeControlStream(android.media.AudioAttributes);
method public int getVolumeControlStream();
method public void writeToParcel(android.os.Parcel, int);
field public static final int CONTENT_TYPE_MOVIE = 3; // 0x3

View File

@@ -21001,6 +21001,7 @@ package android.media {
method public int getContentType();
method public int getFlags();
method public int getUsage();
method public static deprecated int getVolumeControlStream(android.media.AudioAttributes);
method public int getVolumeControlStream();
method public void writeToParcel(android.os.Parcel, int);
field public static final int CONTENT_TYPE_MOVIE = 3; // 0x3

View File

@@ -913,6 +913,29 @@ public final class AudioAttributes implements Parcelable {
}
}
// TODO remove, replaced by non-static API getVolumeControlStream()
/**
* Returns the stream type matching the given attributes for volume control.
* Use this method to derive the stream type needed to configure the volume
* control slider in an {@link android.app.Activity} with
* {@link android.app.Activity#setVolumeControlStream(int)}.
* <BR>Do not use this method to set the stream type on an audio player object
* (e.g. {@link AudioTrack}, {@link MediaPlayer}) as this is deprecated,
* use <code>AudioAttributes</code> instead.
* @param aa non-null AudioAttributes.
* @return a valid stream type for <code>Activity</code> or stream volume control that matches
* the attributes, or {@link AudioManager#USE_DEFAULT_STREAM_TYPE} if there isn't a direct
* match. Note that <code>USE_DEFAULT_STREAM_TYPE</code> is not a valid value
* for {@link AudioManager#setStreamVolume(int, int, int)}.
* @deprecated use {@link #getVolumeControlStream()}
*/
public static int getVolumeControlStream(@NonNull AudioAttributes aa) {
if (aa == null) {
throw new IllegalArgumentException("Invalid null audio attributes");
}
return toVolumeStreamType(true /*fromGetVolumeControlStream*/, aa);
}
/**
* Returns the stream type matching this {@code AudioAttributes} instance for volume control.
* Use this method to derive the stream type needed to configure the volume