Mark some unreleased IntDefs as TYPE_USE only
The longer list of targets is only necessary for backwards compatibility with existing Kotlin code that will stop compiling if the position of the annotation becomes 'wrong' by marking it only TYPE_USE. Since none of these IntDefs have been released (except in media3 alpha1) we don't need to maintain this compatibility. Also add a comment to all the places that *do* need the longer list of targets, in order to explain why it's there and discourage copy-pasting when defining new IntDefs in future. Also fix some single-element arrays to remove the array notation. #minor-release PiperOrigin-RevId: 426108537
This commit is contained in:
parent
1521e50307
commit
92a6cc10a4
@ -37,6 +37,8 @@ public final class AdOverlayInfo {
|
|||||||
* The purpose of the overlay. One of {@link #PURPOSE_CONTROLS}, {@link #PURPOSE_CLOSE_AD}, {@link
|
* The purpose of the overlay. One of {@link #PURPOSE_CONTROLS}, {@link #PURPOSE_CLOSE_AD}, {@link
|
||||||
* #PURPOSE_OTHER} or {@link #PURPOSE_NOT_VISIBLE}.
|
* #PURPOSE_OTHER} or {@link #PURPOSE_NOT_VISIBLE}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -279,7 +279,7 @@ public final class C {
|
|||||||
/** Represents the behavior affecting whether spatialization will be used. */
|
/** Represents the behavior affecting whether spatialization will be used. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({SPATIALIZATION_BEHAVIOR_AUTO, SPATIALIZATION_BEHAVIOR_NEVER})
|
@IntDef({SPATIALIZATION_BEHAVIOR_AUTO, SPATIALIZATION_BEHAVIOR_NEVER})
|
||||||
public @interface SpatializationBehavior {}
|
public @interface SpatializationBehavior {}
|
||||||
|
|
||||||
@ -333,6 +333,8 @@ public final class C {
|
|||||||
* #CONTENT_TYPE_MUSIC}, {@link #CONTENT_TYPE_SONIFICATION}, {@link #CONTENT_TYPE_SPEECH} or
|
* #CONTENT_TYPE_MUSIC}, {@link #CONTENT_TYPE_SONIFICATION}, {@link #CONTENT_TYPE_SPEECH} or
|
||||||
* {@link #CONTENT_TYPE_UNKNOWN}.
|
* {@link #CONTENT_TYPE_UNKNOWN}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -362,6 +364,8 @@ public final class C {
|
|||||||
* <p>Note that {@code FLAG_HW_AV_SYNC} is not available because the player takes care of setting
|
* <p>Note that {@code FLAG_HW_AV_SYNC} is not available because the player takes care of setting
|
||||||
* the flag when tunneling is enabled via a track selector.
|
* the flag when tunneling is enabled via a track selector.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -383,6 +387,8 @@ public final class C {
|
|||||||
* #USAGE_NOTIFICATION_RINGTONE}, {@link #USAGE_UNKNOWN}, {@link #USAGE_VOICE_COMMUNICATION} or
|
* #USAGE_NOTIFICATION_RINGTONE}, {@link #USAGE_UNKNOWN}, {@link #USAGE_VOICE_COMMUNICATION} or
|
||||||
* {@link #USAGE_VOICE_COMMUNICATION_SIGNALLING}.
|
* {@link #USAGE_VOICE_COMMUNICATION_SIGNALLING}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -452,6 +458,8 @@ public final class C {
|
|||||||
* Capture policies for audio attributes. One of {@link #ALLOW_CAPTURE_BY_ALL}, {@link
|
* Capture policies for audio attributes. One of {@link #ALLOW_CAPTURE_BY_ALL}, {@link
|
||||||
* #ALLOW_CAPTURE_BY_NONE} or {@link #ALLOW_CAPTURE_BY_SYSTEM}.
|
* #ALLOW_CAPTURE_BY_NONE} or {@link #ALLOW_CAPTURE_BY_SYSTEM}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -618,6 +626,8 @@ public final class C {
|
|||||||
* Track selection flags. Possible flag values are {@link #SELECTION_FLAG_DEFAULT}, {@link
|
* Track selection flags. Possible flag values are {@link #SELECTION_FLAG_DEFAULT}, {@link
|
||||||
* #SELECTION_FLAG_FORCED} and {@link #SELECTION_FLAG_AUTOSELECT}.
|
* #SELECTION_FLAG_FORCED} and {@link #SELECTION_FLAG_AUTOSELECT}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1044,6 +1054,8 @@ public final class C {
|
|||||||
* Mode specifying whether the player should hold a WakeLock and a WifiLock. One of {@link
|
* Mode specifying whether the player should hold a WakeLock and a WifiLock. One of {@link
|
||||||
* #WAKE_MODE_NONE}, {@link #WAKE_MODE_LOCAL} or {@link #WAKE_MODE_NETWORK}.
|
* #WAKE_MODE_NONE}, {@link #WAKE_MODE_LOCAL} or {@link #WAKE_MODE_NETWORK}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1081,6 +1093,8 @@ public final class C {
|
|||||||
* {@link #ROLE_FLAG_TRANSCRIBES_DIALOG}, {@link #ROLE_FLAG_EASY_TO_READ} and {@link
|
* {@link #ROLE_FLAG_TRANSCRIBES_DIALOG}, {@link #ROLE_FLAG_EASY_TO_READ} and {@link
|
||||||
* #ROLE_FLAG_TRICK_PLAY}.
|
* #ROLE_FLAG_TRICK_PLAY}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -15,12 +15,13 @@
|
|||||||
*/
|
*/
|
||||||
package androidx.media3.common;
|
package androidx.media3.common;
|
||||||
|
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.os.Bundle;
|
import android.os.Bundle;
|
||||||
import androidx.annotation.IntDef;
|
import androidx.annotation.IntDef;
|
||||||
import androidx.annotation.Nullable;
|
import androidx.annotation.Nullable;
|
||||||
import androidx.media3.common.util.UnstableApi;
|
import androidx.media3.common.util.UnstableApi;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
@ -31,7 +32,7 @@ public final class DeviceInfo implements Bundleable {
|
|||||||
/** Types of playback. One of {@link #PLAYBACK_TYPE_LOCAL} or {@link #PLAYBACK_TYPE_REMOTE}. */
|
/** Types of playback. One of {@link #PLAYBACK_TYPE_LOCAL} or {@link #PLAYBACK_TYPE_REMOTE}. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({
|
@IntDef({
|
||||||
PLAYBACK_TYPE_LOCAL,
|
PLAYBACK_TYPE_LOCAL,
|
||||||
PLAYBACK_TYPE_REMOTE,
|
PLAYBACK_TYPE_REMOTE,
|
||||||
|
@ -521,6 +521,8 @@ public final class MediaMetadata implements Bundleable {
|
|||||||
* href="https://www.bluetooth.com/specifications/specs/a-v-remote-control-profile-1-6-2/">Bluetooth
|
* href="https://www.bluetooth.com/specifications/specs/a-v-remote-control-profile-1-6-2/">Bluetooth
|
||||||
* AVRCP 1.6.2</a>).
|
* AVRCP 1.6.2</a>).
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -559,6 +561,8 @@ public final class MediaMetadata implements Bundleable {
|
|||||||
* <p>Values sourced from the ID3 v2.4 specification (See section 4.14 of
|
* <p>Values sourced from the ID3 v2.4 specification (See section 4.14 of
|
||||||
* https://id3.org/id3v2.4.0-frames).
|
* https://id3.org/id3v2.4.0-frames).
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -46,6 +46,8 @@ public class PlaybackException extends Exception implements Bundleable {
|
|||||||
* <p>This list of errors may be extended in future versions, and {@link Player} implementations
|
* <p>This list of errors may be extended in future versions, and {@link Player} implementations
|
||||||
* may define custom error codes.
|
* may define custom error codes.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -1086,6 +1086,8 @@ public interface Player {
|
|||||||
* Playback state. One of {@link #STATE_IDLE}, {@link #STATE_BUFFERING}, {@link #STATE_READY} or
|
* Playback state. One of {@link #STATE_IDLE}, {@link #STATE_BUFFERING}, {@link #STATE_READY} or
|
||||||
* {@link #STATE_ENDED}.
|
* {@link #STATE_ENDED}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1118,6 +1120,8 @@ public interface Player {
|
|||||||
* #PLAY_WHEN_READY_CHANGE_REASON_REMOTE} or {@link
|
* #PLAY_WHEN_READY_CHANGE_REASON_REMOTE} or {@link
|
||||||
* #PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM}.
|
* #PLAY_WHEN_READY_CHANGE_REASON_END_OF_MEDIA_ITEM}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1145,6 +1149,8 @@ public interface Player {
|
|||||||
* of {@link #PLAYBACK_SUPPRESSION_REASON_NONE} or {@link
|
* of {@link #PLAYBACK_SUPPRESSION_REASON_NONE} or {@link
|
||||||
* #PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS}.
|
* #PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1162,6 +1168,8 @@ public interface Player {
|
|||||||
* Repeat modes for playback. One of {@link #REPEAT_MODE_OFF}, {@link #REPEAT_MODE_ONE} or {@link
|
* Repeat modes for playback. One of {@link #REPEAT_MODE_OFF}, {@link #REPEAT_MODE_ONE} or {@link
|
||||||
* #REPEAT_MODE_ALL}.
|
* #REPEAT_MODE_ALL}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1194,6 +1202,8 @@ public interface Player {
|
|||||||
* #DISCONTINUITY_REASON_SKIP}, {@link #DISCONTINUITY_REASON_REMOVE} or {@link
|
* #DISCONTINUITY_REASON_SKIP}, {@link #DISCONTINUITY_REASON_REMOVE} or {@link
|
||||||
* #DISCONTINUITY_REASON_INTERNAL}.
|
* #DISCONTINUITY_REASON_INTERNAL}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1233,6 +1243,8 @@ public interface Player {
|
|||||||
* Reasons for timeline changes. One of {@link #TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED} or {@link
|
* Reasons for timeline changes. One of {@link #TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED} or {@link
|
||||||
* #TIMELINE_CHANGE_REASON_SOURCE_UPDATE}.
|
* #TIMELINE_CHANGE_REASON_SOURCE_UPDATE}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1254,6 +1266,8 @@ public interface Player {
|
|||||||
* #MEDIA_ITEM_TRANSITION_REASON_AUTO}, {@link #MEDIA_ITEM_TRANSITION_REASON_SEEK} or {@link
|
* #MEDIA_ITEM_TRANSITION_REASON_AUTO}, {@link #MEDIA_ITEM_TRANSITION_REASON_SEEK} or {@link
|
||||||
* #MEDIA_ITEM_TRANSITION_REASON_PLAYLIST_CHANGED}.
|
* #MEDIA_ITEM_TRANSITION_REASON_PLAYLIST_CHANGED}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1287,6 +1301,8 @@ public interface Player {
|
|||||||
*
|
*
|
||||||
* <p>One of the {@link Player}{@code .EVENT_*} values.
|
* <p>One of the {@link Player}{@code .EVENT_*} values.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -1373,6 +1389,8 @@ public interface Player {
|
|||||||
* #COMMAND_SET_VIDEO_SURFACE}, {@link #COMMAND_GET_TEXT}, {@link
|
* #COMMAND_SET_VIDEO_SURFACE}, {@link #COMMAND_GET_TEXT}, {@link
|
||||||
* #COMMAND_SET_TRACK_SELECTION_PARAMETERS} or {@link #COMMAND_GET_TRACK_INFOS}.
|
* #COMMAND_SET_TRACK_SELECTION_PARAMETERS} or {@link #COMMAND_GET_TRACK_INFOS}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -15,10 +15,11 @@
|
|||||||
*/
|
*/
|
||||||
package androidx.media3.common;
|
package androidx.media3.common;
|
||||||
|
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import androidx.annotation.IntDef;
|
import androidx.annotation.IntDef;
|
||||||
import androidx.media3.common.util.UnstableApi;
|
import androidx.media3.common.util.UnstableApi;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
@ -38,7 +39,7 @@ public interface TrackSelection {
|
|||||||
*/
|
*/
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef(
|
@IntDef(
|
||||||
open = true,
|
open = true,
|
||||||
value = {TYPE_UNSET})
|
value = {TYPE_UNSET})
|
||||||
|
@ -59,6 +59,8 @@ public final class Cue implements Bundleable {
|
|||||||
* The type of anchor, which may be unset. One of {@link #TYPE_UNSET}, {@link #ANCHOR_TYPE_START},
|
* The type of anchor, which may be unset. One of {@link #TYPE_UNSET}, {@link #ANCHOR_TYPE_START},
|
||||||
* {@link #ANCHOR_TYPE_MIDDLE} or {@link #ANCHOR_TYPE_END}.
|
* {@link #ANCHOR_TYPE_MIDDLE} or {@link #ANCHOR_TYPE_END}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -87,6 +89,8 @@ public final class Cue implements Bundleable {
|
|||||||
* The type of line, which may be unset. One of {@link #TYPE_UNSET}, {@link #LINE_TYPE_FRACTION}
|
* The type of line, which may be unset. One of {@link #TYPE_UNSET}, {@link #LINE_TYPE_FRACTION}
|
||||||
* or {@link #LINE_TYPE_NUMBER}.
|
* or {@link #LINE_TYPE_NUMBER}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -104,6 +108,8 @@ public final class Cue implements Bundleable {
|
|||||||
* {@link #TEXT_SIZE_TYPE_FRACTIONAL}, {@link #TEXT_SIZE_TYPE_FRACTIONAL_IGNORE_PADDING} or {@link
|
* {@link #TEXT_SIZE_TYPE_FRACTIONAL}, {@link #TEXT_SIZE_TYPE_FRACTIONAL_IGNORE_PADDING} or {@link
|
||||||
* #TEXT_SIZE_TYPE_ABSOLUTE}.
|
* #TEXT_SIZE_TYPE_ABSOLUTE}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
@ -128,6 +134,8 @@ public final class Cue implements Bundleable {
|
|||||||
* The type of vertical layout for this cue, which may be unset (i.e. horizontal). One of {@link
|
* The type of vertical layout for this cue, which may be unset (i.e. horizontal). One of {@link
|
||||||
* #TYPE_UNSET}, {@link #VERTICAL_TYPE_RL} or {@link #VERTICAL_TYPE_LR}.
|
* #TYPE_UNSET}, {@link #VERTICAL_TYPE_RL} or {@link #VERTICAL_TYPE_LR}.
|
||||||
*/
|
*/
|
||||||
|
// @Target list includes both 'default' targets and TYPE_USE, to ensure backwards compatibility
|
||||||
|
// with Kotlin usages from before TYPE_USE was added.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
||||||
|
@ -17,6 +17,7 @@ package androidx.media3.exoplayer.analytics;
|
|||||||
|
|
||||||
import static java.lang.Math.max;
|
import static java.lang.Math.max;
|
||||||
import static java.lang.Math.min;
|
import static java.lang.Math.min;
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.os.SystemClock;
|
import android.os.SystemClock;
|
||||||
import androidx.annotation.IntDef;
|
import androidx.annotation.IntDef;
|
||||||
@ -26,7 +27,6 @@ import androidx.media3.common.Format;
|
|||||||
import androidx.media3.common.util.UnstableApi;
|
import androidx.media3.common.util.UnstableApi;
|
||||||
import androidx.media3.exoplayer.analytics.AnalyticsListener.EventTime;
|
import androidx.media3.exoplayer.analytics.AnalyticsListener.EventTime;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
@ -174,7 +174,7 @@ public final class PlaybackStats {
|
|||||||
*/
|
*/
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({
|
@IntDef({
|
||||||
PLAYBACK_STATE_NOT_STARTED,
|
PLAYBACK_STATE_NOT_STARTED,
|
||||||
PLAYBACK_STATE_JOINING_BACKGROUND,
|
PLAYBACK_STATE_JOINING_BACKGROUND,
|
||||||
|
@ -16,10 +16,6 @@
|
|||||||
package androidx.media3.exoplayer.audio;
|
package androidx.media3.exoplayer.audio;
|
||||||
|
|
||||||
import static androidx.media3.common.util.Assertions.checkStateNotNull;
|
import static androidx.media3.common.util.Assertions.checkStateNotNull;
|
||||||
import static java.lang.annotation.ElementType.FIELD;
|
|
||||||
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;
|
|
||||||
import static java.lang.annotation.ElementType.METHOD;
|
|
||||||
import static java.lang.annotation.ElementType.PARAMETER;
|
|
||||||
import static java.lang.annotation.ElementType.TYPE_USE;
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.content.Context;
|
import android.content.Context;
|
||||||
@ -52,7 +48,7 @@ import java.util.concurrent.Executor;
|
|||||||
/** Level of support for audio spatialization. */
|
/** Level of support for audio spatialization. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({
|
@IntDef({
|
||||||
SPATIALIZER_IMMERSIVE_LEVEL_MULTICHANNEL,
|
SPATIALIZER_IMMERSIVE_LEVEL_MULTICHANNEL,
|
||||||
SPATIALIZER_IMMERSIVE_LEVEL_NONE,
|
SPATIALIZER_IMMERSIVE_LEVEL_NONE,
|
||||||
|
@ -16,6 +16,7 @@
|
|||||||
package androidx.media3.exoplayer.hls;
|
package androidx.media3.exoplayer.hls;
|
||||||
|
|
||||||
import static androidx.media3.common.util.Assertions.checkNotNull;
|
import static androidx.media3.common.util.Assertions.checkNotNull;
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
import static java.lang.annotation.RetentionPolicy.SOURCE;
|
import static java.lang.annotation.RetentionPolicy.SOURCE;
|
||||||
|
|
||||||
import android.os.Looper;
|
import android.os.Looper;
|
||||||
@ -57,7 +58,6 @@ import androidx.media3.exoplayer.upstream.LoadErrorHandlingPolicy;
|
|||||||
import androidx.media3.extractor.Extractor;
|
import androidx.media3.extractor.Extractor;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
@ -85,7 +85,7 @@ public final class HlsMediaSource extends BaseMediaSource
|
|||||||
*/
|
*/
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(SOURCE)
|
@Retention(SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({METADATA_TYPE_ID3, METADATA_TYPE_EMSG})
|
@IntDef({METADATA_TYPE_ID3, METADATA_TYPE_EMSG})
|
||||||
public @interface MetadataType {}
|
public @interface MetadataType {}
|
||||||
|
|
||||||
|
@ -17,6 +17,7 @@ package androidx.media3.extractor.wav;
|
|||||||
|
|
||||||
import static java.lang.Math.max;
|
import static java.lang.Math.max;
|
||||||
import static java.lang.Math.min;
|
import static java.lang.Math.min;
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.util.Pair;
|
import android.util.Pair;
|
||||||
import androidx.annotation.IntDef;
|
import androidx.annotation.IntDef;
|
||||||
@ -38,7 +39,6 @@ import androidx.media3.extractor.TrackOutput;
|
|||||||
import androidx.media3.extractor.WavUtil;
|
import androidx.media3.extractor.WavUtil;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
@ -65,7 +65,7 @@ public final class WavExtractor implements Extractor {
|
|||||||
/** Parser state. */
|
/** Parser state. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({
|
@IntDef({
|
||||||
STATE_READING_FILE_TYPE,
|
STATE_READING_FILE_TYPE,
|
||||||
STATE_READING_RF64_SAMPLE_DATA_SIZE,
|
STATE_READING_RF64_SAMPLE_DATA_SIZE,
|
||||||
|
@ -17,6 +17,7 @@ package androidx.media3.session;
|
|||||||
|
|
||||||
import static androidx.media3.common.util.Assertions.checkArgument;
|
import static androidx.media3.common.util.Assertions.checkArgument;
|
||||||
import static androidx.media3.common.util.Assertions.checkNotNull;
|
import static androidx.media3.common.util.Assertions.checkNotNull;
|
||||||
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.os.Bundle;
|
import android.os.Bundle;
|
||||||
import android.text.TextUtils;
|
import android.text.TextUtils;
|
||||||
@ -29,7 +30,6 @@ import androidx.media3.session.MediaLibraryService.LibraryParams;
|
|||||||
import com.google.common.base.Objects;
|
import com.google.common.base.Objects;
|
||||||
import com.google.common.collect.ImmutableList;
|
import com.google.common.collect.ImmutableList;
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
@ -46,7 +46,7 @@ public final class SessionCommand implements Bundleable {
|
|||||||
/** Command codes of session commands. */
|
/** Command codes of session commands. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({ElementType.TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef({
|
@IntDef({
|
||||||
COMMAND_CODE_CUSTOM,
|
COMMAND_CODE_CUSTOM,
|
||||||
COMMAND_CODE_SESSION_SET_MEDIA_URI,
|
COMMAND_CODE_SESSION_SET_MEDIA_URI,
|
||||||
|
@ -17,12 +17,7 @@ package androidx.media3.session;
|
|||||||
|
|
||||||
import static androidx.media3.common.util.Assertions.checkArgument;
|
import static androidx.media3.common.util.Assertions.checkArgument;
|
||||||
import static androidx.media3.common.util.Assertions.checkNotNull;
|
import static androidx.media3.common.util.Assertions.checkNotNull;
|
||||||
import static java.lang.annotation.ElementType.CONSTRUCTOR;
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
import static java.lang.annotation.ElementType.FIELD;
|
|
||||||
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;
|
|
||||||
import static java.lang.annotation.ElementType.METHOD;
|
|
||||||
import static java.lang.annotation.ElementType.PARAMETER;
|
|
||||||
import static java.lang.annotation.ElementType.TYPE_PARAMETER;
|
|
||||||
|
|
||||||
import android.content.ComponentName;
|
import android.content.ComponentName;
|
||||||
import android.content.Context;
|
import android.content.Context;
|
||||||
@ -78,7 +73,7 @@ public final class SessionToken implements Bundleable {
|
|||||||
/** Types of {@link SessionToken}. */
|
/** Types of {@link SessionToken}. */
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, TYPE_PARAMETER})
|
@Target(TYPE_USE)
|
||||||
@IntDef(value = {TYPE_SESSION, TYPE_SESSION_SERVICE, TYPE_LIBRARY_SERVICE})
|
@IntDef(value = {TYPE_SESSION, TYPE_SESSION_SERVICE, TYPE_LIBRARY_SERVICE})
|
||||||
public @interface TokenType {}
|
public @interface TokenType {}
|
||||||
|
|
||||||
|
@ -15,10 +15,6 @@
|
|||||||
*/
|
*/
|
||||||
package androidx.media3.transformer;
|
package androidx.media3.transformer;
|
||||||
|
|
||||||
import static java.lang.annotation.ElementType.FIELD;
|
|
||||||
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;
|
|
||||||
import static java.lang.annotation.ElementType.METHOD;
|
|
||||||
import static java.lang.annotation.ElementType.PARAMETER;
|
|
||||||
import static java.lang.annotation.ElementType.TYPE_USE;
|
import static java.lang.annotation.ElementType.TYPE_USE;
|
||||||
|
|
||||||
import android.media.MediaCodec;
|
import android.media.MediaCodec;
|
||||||
@ -51,7 +47,7 @@ public final class TransformationException extends Exception {
|
|||||||
// TODO(b/209469847): Update the javadoc once the underlying values are fixed.
|
// TODO(b/209469847): Update the javadoc once the underlying values are fixed.
|
||||||
@Documented
|
@Documented
|
||||||
@Retention(RetentionPolicy.SOURCE)
|
@Retention(RetentionPolicy.SOURCE)
|
||||||
@Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE})
|
@Target(TYPE_USE)
|
||||||
@IntDef(
|
@IntDef(
|
||||||
open = true,
|
open = true,
|
||||||
value = {
|
value = {
|
||||||
|
Loading…
x
Reference in New Issue
Block a user