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. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef( flag = true, value = {FLAG_AUDIBILITY_ENFORCED}) public @interface AudioFlags {} /** @see android.media.AudioAttributes#FLAG_AUDIBILITY_ENFORCED */ public static final int FLAG_AUDIBILITY_ENFORCED = android.media.AudioAttributes.FLAG_AUDIBILITY_ENFORCED; /** * Usage types for audio attributes. One of {@link #USAGE_ALARM}, {@link * #USAGE_ASSISTANCE_ACCESSIBILITY}, {@link #USAGE_ASSISTANCE_NAVIGATION_GUIDANCE}, {@link * #USAGE_ASSISTANCE_SONIFICATION}, {@link #USAGE_ASSISTANT}, {@link #USAGE_GAME}, {@link * #USAGE_MEDIA}, {@link #USAGE_NOTIFICATION}, {@link #USAGE_NOTIFICATION_COMMUNICATION_DELAYED}, * {@link #USAGE_NOTIFICATION_COMMUNICATION_INSTANT}, {@link * #USAGE_NOTIFICATION_COMMUNICATION_REQUEST}, {@link #USAGE_NOTIFICATION_EVENT}, {@link * #USAGE_NOTIFICATION_RINGTONE}, {@link #USAGE_UNKNOWN}, {@link #USAGE_VOICE_COMMUNICATION} or * {@link #USAGE_VOICE_COMMUNICATION_SIGNALLING}. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef({ USAGE_ALARM, USAGE_ASSISTANCE_ACCESSIBILITY, USAGE_ASSISTANCE_NAVIGATION_GUIDANCE, USAGE_ASSISTANCE_SONIFICATION, USAGE_ASSISTANT, USAGE_GAME, USAGE_MEDIA, USAGE_NOTIFICATION, USAGE_NOTIFICATION_COMMUNICATION_DELAYED, USAGE_NOTIFICATION_COMMUNICATION_INSTANT, USAGE_NOTIFICATION_COMMUNICATION_REQUEST, USAGE_NOTIFICATION_EVENT, USAGE_NOTIFICATION_RINGTONE, USAGE_UNKNOWN, USAGE_VOICE_COMMUNICATION, USAGE_VOICE_COMMUNICATION_SIGNALLING }) public @interface AudioUsage {} /** @see android.media.AudioAttributes#USAGE_ALARM */ public static final int USAGE_ALARM = android.media.AudioAttributes.USAGE_ALARM; /** @see android.media.AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY */ public static final int USAGE_ASSISTANCE_ACCESSIBILITY = android.media.AudioAttributes.USAGE_ASSISTANCE_ACCESSIBILITY; /** @see android.media.AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE */ public static final int USAGE_ASSISTANCE_NAVIGATION_GUIDANCE = android.media.AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE; /** @see android.media.AudioAttributes#USAGE_ASSISTANCE_SONIFICATION */ public static final int USAGE_ASSISTANCE_SONIFICATION = android.media.AudioAttributes.USAGE_ASSISTANCE_SONIFICATION; /** @see android.media.AudioAttributes#USAGE_ASSISTANT */ public static final int USAGE_ASSISTANT = android.media.AudioAttributes.USAGE_ASSISTANT; /** @see android.media.AudioAttributes#USAGE_GAME */ public static final int USAGE_GAME = android.media.AudioAttributes.USAGE_GAME; /** @see android.media.AudioAttributes#USAGE_MEDIA */ public static final int USAGE_MEDIA = android.media.AudioAttributes.USAGE_MEDIA; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION */ public static final int USAGE_NOTIFICATION = android.media.AudioAttributes.USAGE_NOTIFICATION; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED */ public static final int USAGE_NOTIFICATION_COMMUNICATION_DELAYED = android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_DELAYED; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT */ public static final int USAGE_NOTIFICATION_COMMUNICATION_INSTANT = android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_INSTANT; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST */ public static final int USAGE_NOTIFICATION_COMMUNICATION_REQUEST = android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_REQUEST; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION_EVENT */ public static final int USAGE_NOTIFICATION_EVENT = android.media.AudioAttributes.USAGE_NOTIFICATION_EVENT; /** @see android.media.AudioAttributes#USAGE_NOTIFICATION_RINGTONE */ public static final int USAGE_NOTIFICATION_RINGTONE = android.media.AudioAttributes.USAGE_NOTIFICATION_RINGTONE; /** @see android.media.AudioAttributes#USAGE_UNKNOWN */ public static final int USAGE_UNKNOWN = android.media.AudioAttributes.USAGE_UNKNOWN; /** @see android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION */ public static final int USAGE_VOICE_COMMUNICATION = android.media.AudioAttributes.USAGE_VOICE_COMMUNICATION; /** @see android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING */ public static final int USAGE_VOICE_COMMUNICATION_SIGNALLING = android.media.AudioAttributes.USAGE_VOICE_COMMUNICATION_SIGNALLING; /** * Capture policies for audio attributes. One of {@link #ALLOW_CAPTURE_BY_ALL}, {@link * #ALLOW_CAPTURE_BY_NONE} or {@link #ALLOW_CAPTURE_BY_SYSTEM}. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef({ALLOW_CAPTURE_BY_ALL, ALLOW_CAPTURE_BY_NONE, ALLOW_CAPTURE_BY_SYSTEM}) public @interface AudioAllowedCapturePolicy {} /** See {@link android.media.AudioAttributes#ALLOW_CAPTURE_BY_ALL}. */ public static final int ALLOW_CAPTURE_BY_ALL = AudioAttributes.ALLOW_CAPTURE_BY_ALL; /** See {@link android.media.AudioAttributes#ALLOW_CAPTURE_BY_NONE}. */ public static final int ALLOW_CAPTURE_BY_NONE = AudioAttributes.ALLOW_CAPTURE_BY_NONE; /** See {@link android.media.AudioAttributes#ALLOW_CAPTURE_BY_SYSTEM}. */ public static final int ALLOW_CAPTURE_BY_SYSTEM = AudioAttributes.ALLOW_CAPTURE_BY_SYSTEM; /** * Audio focus types. One of {@link #AUDIOFOCUS_NONE}, {@link #AUDIOFOCUS_GAIN}, {@link * #AUDIOFOCUS_GAIN_TRANSIENT}, {@link #AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK} or {@link * #AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ AUDIOFOCUS_NONE, AUDIOFOCUS_GAIN, AUDIOFOCUS_GAIN_TRANSIENT, AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK, AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE }) public @interface AudioFocusGain {} /** @see AudioManager#AUDIOFOCUS_NONE */ public static final int AUDIOFOCUS_NONE = AudioManager.AUDIOFOCUS_NONE; /** @see AudioManager#AUDIOFOCUS_GAIN */ public static final int AUDIOFOCUS_GAIN = AudioManager.AUDIOFOCUS_GAIN; /** @see AudioManager#AUDIOFOCUS_GAIN_TRANSIENT */ public static final int AUDIOFOCUS_GAIN_TRANSIENT = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT; /** @see AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK */ public static final int AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK; /** @see AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE */ public static final int AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE = AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE; /** * Playback offload mode. One of {@link #PLAYBACK_OFFLOAD_NOT_SUPPORTED},{@link * #PLAYBACK_OFFLOAD_SUPPORTED} or {@link #PLAYBACK_OFFLOAD_GAPLESS_SUPPORTED}. */ @IntDef({ PLAYBACK_OFFLOAD_NOT_SUPPORTED, PLAYBACK_OFFLOAD_SUPPORTED, PLAYBACK_OFFLOAD_GAPLESS_SUPPORTED }) @Retention(RetentionPolicy.SOURCE) public @interface AudioManagerOffloadMode {} /** See AudioManager#PLAYBACK_OFFLOAD_NOT_SUPPORTED */ public static final int PLAYBACK_OFFLOAD_NOT_SUPPORTED = AudioManager.PLAYBACK_OFFLOAD_NOT_SUPPORTED; /** See AudioManager#PLAYBACK_OFFLOAD_SUPPORTED */ public static final int PLAYBACK_OFFLOAD_SUPPORTED = AudioManager.PLAYBACK_OFFLOAD_SUPPORTED; /** See AudioManager#PLAYBACK_OFFLOAD_GAPLESS_SUPPORTED */ public static final int PLAYBACK_OFFLOAD_GAPLESS_SUPPORTED = AudioManager.PLAYBACK_OFFLOAD_GAPLESS_SUPPORTED; /** * Flags which can apply to a buffer containing a media sample. Possible flag values are {@link * #BUFFER_FLAG_KEY_FRAME}, {@link #BUFFER_FLAG_END_OF_STREAM}, {@link #BUFFER_FLAG_LAST_SAMPLE}, * {@link #BUFFER_FLAG_ENCRYPTED} and {@link #BUFFER_FLAG_DECODE_ONLY}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef( flag = true, value = { BUFFER_FLAG_KEY_FRAME, BUFFER_FLAG_END_OF_STREAM, BUFFER_FLAG_HAS_SUPPLEMENTAL_DATA, BUFFER_FLAG_LAST_SAMPLE, BUFFER_FLAG_ENCRYPTED, BUFFER_FLAG_DECODE_ONLY }) public @interface BufferFlags {} /** Indicates that a buffer holds a synchronization sample. */ public static final int BUFFER_FLAG_KEY_FRAME = MediaCodec.BUFFER_FLAG_KEY_FRAME; /** Flag for empty buffers that signal that the end of the stream was reached. */ public static final int BUFFER_FLAG_END_OF_STREAM = MediaCodec.BUFFER_FLAG_END_OF_STREAM; /** Indicates that a buffer has supplemental data. */ public static final int BUFFER_FLAG_HAS_SUPPLEMENTAL_DATA = 1 << 28; // 0x10000000 /** Indicates that a buffer is known to contain the last media sample of the stream. */ public static final int BUFFER_FLAG_LAST_SAMPLE = 1 << 29; // 0x20000000 /** Indicates that a buffer is (at least partially) encrypted. */ public static final int BUFFER_FLAG_ENCRYPTED = 1 << 30; // 0x40000000 /** Indicates that a buffer should be decoded but not rendered. */ public static final int BUFFER_FLAG_DECODE_ONLY = 1 << 31; // 0x80000000 /** * Video decoder output modes. Possible modes are {@link #VIDEO_OUTPUT_MODE_NONE}, {@link * #VIDEO_OUTPUT_MODE_YUV} and {@link #VIDEO_OUTPUT_MODE_SURFACE_YUV}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef(value = {VIDEO_OUTPUT_MODE_NONE, VIDEO_OUTPUT_MODE_YUV, VIDEO_OUTPUT_MODE_SURFACE_YUV}) public @interface VideoOutputMode {} /** Video decoder output mode is not set. */ public static final int VIDEO_OUTPUT_MODE_NONE = -1; /** Video decoder output mode that outputs raw 4:2:0 YUV planes. */ public static final int VIDEO_OUTPUT_MODE_YUV = 0; /** Video decoder output mode that renders 4:2:0 YUV planes directly to a surface. */ public static final int VIDEO_OUTPUT_MODE_SURFACE_YUV = 1; /** * Video scaling modes for {@link MediaCodec}-based renderers. One of {@link * #VIDEO_SCALING_MODE_SCALE_TO_FIT}, {@link #VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING} or * {@link #VIDEO_SCALING_MODE_DEFAULT}. */ @SuppressLint("UniqueConstants") // Intentional duplication to set VIDEO_SCALING_MODE_DEFAULT. @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ VIDEO_SCALING_MODE_SCALE_TO_FIT, VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING, VIDEO_SCALING_MODE_DEFAULT }) public @interface VideoScalingMode {} /** See {@link MediaCodec#VIDEO_SCALING_MODE_SCALE_TO_FIT}. */ public static final int VIDEO_SCALING_MODE_SCALE_TO_FIT = MediaCodec.VIDEO_SCALING_MODE_SCALE_TO_FIT; /** See {@link MediaCodec#VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING}. */ public static final int VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING = MediaCodec.VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING; /** A default video scaling mode for {@link MediaCodec}-based renderers. */ public static final int VIDEO_SCALING_MODE_DEFAULT = VIDEO_SCALING_MODE_SCALE_TO_FIT; /** Strategies for calling {@link Surface#setFrameRate}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({VIDEO_CHANGE_FRAME_RATE_STRATEGY_OFF, VIDEO_CHANGE_FRAME_RATE_STRATEGY_ONLY_IF_SEAMLESS}) public @interface VideoChangeFrameRateStrategy {} /** * Strategy to never call {@link Surface#setFrameRate}. Use this strategy if you prefer to call * {@link Surface#setFrameRate} directly from application code. */ public static final int VIDEO_CHANGE_FRAME_RATE_STRATEGY_OFF = Integer.MIN_VALUE; /** * Strategy to call {@link Surface#setFrameRate} with {@link * Surface#CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS} when the output frame rate is known. */ public static final int VIDEO_CHANGE_FRAME_RATE_STRATEGY_ONLY_IF_SEAMLESS = Surface.CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS; /** * Track selection flags. Possible flag values are {@link #SELECTION_FLAG_DEFAULT}, {@link * #SELECTION_FLAG_FORCED} and {@link #SELECTION_FLAG_AUTOSELECT}. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef( flag = true, value = {SELECTION_FLAG_DEFAULT, SELECTION_FLAG_FORCED, SELECTION_FLAG_AUTOSELECT}) public @interface SelectionFlags {} // LINT.IfChange(selection_flags) /** Indicates that the track should be selected if user preferences do not state otherwise. */ public static final int SELECTION_FLAG_DEFAULT = 1; /** * Indicates that the track should be selected if its language matches the language of the * selected audio track and user preferences do not state otherwise. Only applies to text tracks. * *
Tracks with this flag generally provide translation for elements that don't match the * declared language of the selected audio track (e.g. speech in an alien language). See Netflix's summary * for more info. */ public static final int SELECTION_FLAG_FORCED = 1 << 1; // 2 /** * Indicates that the player may choose to play the track in absence of an explicit user * preference. */ public static final int SELECTION_FLAG_AUTOSELECT = 1 << 2; // 4 /** Represents an undetermined language as an ISO 639-2 language code. */ public static final String LANGUAGE_UNDETERMINED = "und"; /** * Represents a streaming or other media type. One of {@link #TYPE_DASH}, {@link #TYPE_SS}, {@link * #TYPE_HLS}, {@link #TYPE_RTSP} or {@link #TYPE_OTHER}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({TYPE_DASH, TYPE_SS, TYPE_HLS, TYPE_RTSP, TYPE_OTHER}) public @interface ContentType {} /** Value returned by {@link Util#inferContentType(String)} for DASH manifests. */ public static final int TYPE_DASH = 0; /** Value returned by {@link Util#inferContentType(String)} for Smooth Streaming manifests. */ public static final int TYPE_SS = 1; /** Value returned by {@link Util#inferContentType(String)} for HLS manifests. */ public static final int TYPE_HLS = 2; /** Value returned by {@link Util#inferContentType(String)} for RTSP. */ public static final int TYPE_RTSP = 3; /** * Value returned by {@link Util#inferContentType(String)} for files other than DASH, HLS or * Smooth Streaming manifests, or RTSP URIs. */ public static final int TYPE_OTHER = 4; /** A return value for methods where the end of an input was encountered. */ public static final int RESULT_END_OF_INPUT = -1; /** * A return value for methods where the length of parsed data exceeds the maximum length allowed. */ public static final int RESULT_MAX_LENGTH_EXCEEDED = -2; /** A return value for methods where nothing was read. */ public static final int RESULT_NOTHING_READ = -3; /** A return value for methods where a buffer was read. */ public static final int RESULT_BUFFER_READ = -4; /** A return value for methods where a format was read. */ public static final int RESULT_FORMAT_READ = -5; /** * Represents a type of data. May be one of {@link #DATA_TYPE_UNKNOWN}, {@link #DATA_TYPE_MEDIA}, * {@link #DATA_TYPE_MEDIA_INITIALIZATION}, {@link #DATA_TYPE_DRM}, {@link #DATA_TYPE_MANIFEST}, * {@link #DATA_TYPE_TIME_SYNCHRONIZATION}, {@link #DATA_TYPE_AD}, or {@link * #DATA_TYPE_MEDIA_PROGRESSIVE_LIVE}. May also be an app-defined value (see {@link * #DATA_TYPE_CUSTOM_BASE}). */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef( open = true, value = { DATA_TYPE_UNKNOWN, DATA_TYPE_MEDIA, DATA_TYPE_MEDIA_INITIALIZATION, DATA_TYPE_DRM, DATA_TYPE_MANIFEST, DATA_TYPE_TIME_SYNCHRONIZATION, DATA_TYPE_AD, DATA_TYPE_MEDIA_PROGRESSIVE_LIVE }) public @interface DataType {} /** A data type constant for data of unknown or unspecified type. */ public static final int DATA_TYPE_UNKNOWN = 0; /** A data type constant for media, typically containing media samples. */ public static final int DATA_TYPE_MEDIA = 1; /** A data type constant for media, typically containing only initialization data. */ public static final int DATA_TYPE_MEDIA_INITIALIZATION = 2; /** A data type constant for drm or encryption data. */ public static final int DATA_TYPE_DRM = 3; /** A data type constant for a manifest file. */ public static final int DATA_TYPE_MANIFEST = 4; /** A data type constant for time synchronization data. */ public static final int DATA_TYPE_TIME_SYNCHRONIZATION = 5; /** A data type constant for ads loader data. */ public static final int DATA_TYPE_AD = 6; /** * A data type constant for live progressive media streams, typically containing media samples. */ public static final int DATA_TYPE_MEDIA_PROGRESSIVE_LIVE = 7; /** * Applications or extensions may define custom {@code DATA_TYPE_*} constants greater than or * equal to this value. */ public static final int DATA_TYPE_CUSTOM_BASE = 10000; /** * Represents a type of media track. May be one of {@link #TRACK_TYPE_UNKNOWN}, {@link * #TRACK_TYPE_DEFAULT}, {@link #TRACK_TYPE_AUDIO}, {@link #TRACK_TYPE_VIDEO}, {@link * #TRACK_TYPE_TEXT}, {@link #TRACK_TYPE_IMAGE}, {@link #TRACK_TYPE_METADATA}, {@link * #TRACK_TYPE_CAMERA_MOTION} or {@link #TRACK_TYPE_NONE}. May also be an app-defined value (see * {@link #TRACK_TYPE_CUSTOM_BASE}). */ @Documented @Retention(RetentionPolicy.SOURCE) @Target(TYPE_USE) @IntDef( open = true, value = { TRACK_TYPE_UNKNOWN, TRACK_TYPE_DEFAULT, TRACK_TYPE_AUDIO, TRACK_TYPE_VIDEO, TRACK_TYPE_TEXT, TRACK_TYPE_IMAGE, TRACK_TYPE_METADATA, TRACK_TYPE_CAMERA_MOTION, TRACK_TYPE_NONE, }) public @interface TrackType {} /** A type constant for a fake or empty track. */ public static final int TRACK_TYPE_NONE = -2; /** A type constant for tracks of unknown type. */ public static final int TRACK_TYPE_UNKNOWN = -1; /** A type constant for tracks of some default type, where the type itself is unknown. */ public static final int TRACK_TYPE_DEFAULT = 0; /** A type constant for audio tracks. */ public static final int TRACK_TYPE_AUDIO = 1; /** A type constant for video tracks. */ public static final int TRACK_TYPE_VIDEO = 2; /** A type constant for text tracks. */ public static final int TRACK_TYPE_TEXT = 3; /** A type constant for image tracks. */ public static final int TRACK_TYPE_IMAGE = 4; /** A type constant for metadata tracks. */ public static final int TRACK_TYPE_METADATA = 5; /** A type constant for camera motion tracks. */ public static final int TRACK_TYPE_CAMERA_MOTION = 6; /** * Applications or extensions may define custom {@code TRACK_TYPE_*} constants greater than or * equal to this value. */ public static final int TRACK_TYPE_CUSTOM_BASE = 10000; /** * Represents a reason for selection. May be one of {@link #SELECTION_REASON_UNKNOWN}, {@link * #SELECTION_REASON_INITIAL}, {@link #SELECTION_REASON_MANUAL}, {@link * #SELECTION_REASON_ADAPTIVE} or {@link #SELECTION_REASON_TRICK_PLAY}. May also be an app-defined * value (see {@link #SELECTION_REASON_CUSTOM_BASE}). */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef( open = true, value = { SELECTION_REASON_UNKNOWN, SELECTION_REASON_INITIAL, SELECTION_REASON_MANUAL, SELECTION_REASON_ADAPTIVE, SELECTION_REASON_TRICK_PLAY }) public @interface SelectionReason {} /** A selection reason constant for selections whose reasons are unknown or unspecified. */ public static final int SELECTION_REASON_UNKNOWN = 0; /** A selection reason constant for an initial track selection. */ public static final int SELECTION_REASON_INITIAL = 1; /** A selection reason constant for an manual (i.e. user initiated) track selection. */ public static final int SELECTION_REASON_MANUAL = 2; /** A selection reason constant for an adaptive track selection. */ public static final int SELECTION_REASON_ADAPTIVE = 3; /** A selection reason constant for a trick play track selection. */ public static final int SELECTION_REASON_TRICK_PLAY = 4; /** * Applications or extensions may define custom {@code SELECTION_REASON_*} constants greater than * or equal to this value. */ public static final int SELECTION_REASON_CUSTOM_BASE = 10000; /** A default size in bytes for an individual allocation that forms part of a larger buffer. */ public static final int DEFAULT_BUFFER_SEGMENT_SIZE = 64 * 1024; /** A default seek back increment, in milliseconds. */ public static final long DEFAULT_SEEK_BACK_INCREMENT_MS = 5_000; /** A default seek forward increment, in milliseconds. */ public static final long DEFAULT_SEEK_FORWARD_INCREMENT_MS = 15_000; /** * A default maximum position for which a seek to previous will seek to the previous window, in * milliseconds. */ public static final long DEFAULT_MAX_SEEK_TO_PREVIOUS_POSITION_MS = 3_000; /** "cenc" scheme type name as defined in ISO/IEC 23001-7:2016. */ @SuppressWarnings("ConstantField") public static final String CENC_TYPE_cenc = "cenc"; /** "cbc1" scheme type name as defined in ISO/IEC 23001-7:2016. */ @SuppressWarnings("ConstantField") public static final String CENC_TYPE_cbc1 = "cbc1"; /** "cens" scheme type name as defined in ISO/IEC 23001-7:2016. */ @SuppressWarnings("ConstantField") public static final String CENC_TYPE_cens = "cens"; /** "cbcs" scheme type name as defined in ISO/IEC 23001-7:2016. */ @SuppressWarnings("ConstantField") public static final String CENC_TYPE_cbcs = "cbcs"; /** * The Nil UUID as defined by RFC4122. */ public static final UUID UUID_NIL = new UUID(0L, 0L); /** * UUID for the W3C Common PSSH * box. */ public static final UUID COMMON_PSSH_UUID = new UUID(0x1077EFECC0B24D02L, 0xACE33C1E52E2FB4BL); /** * UUID for the ClearKey DRM scheme. * *
ClearKey is supported on Android devices running Android 5.0 (API Level 21) and up. */ public static final UUID CLEARKEY_UUID = new UUID(0xE2719D58A985B3C9L, 0x781AB030AF78D30EL); /** * UUID for the Widevine DRM scheme. * *
Widevine is supported on Android devices running Android 4.3 (API Level 18) and up. */ public static final UUID WIDEVINE_UUID = new UUID(0xEDEF8BA979D64ACEL, 0xA3C827DCD51D21EDL); /** * UUID for the PlayReady DRM scheme. * *
PlayReady is supported on all AndroidTV devices. Note that most other Android devices do not * provide PlayReady support. */ public static final UUID PLAYREADY_UUID = new UUID(0x9A04F07998404286L, 0xAB92E65BE0885F95L); /** * The stereo mode for 360/3D/VR videos. One of {@link Format#NO_VALUE}, {@link * #STEREO_MODE_MONO}, {@link #STEREO_MODE_TOP_BOTTOM}, {@link #STEREO_MODE_LEFT_RIGHT} or {@link * #STEREO_MODE_STEREO_MESH}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ Format.NO_VALUE, STEREO_MODE_MONO, STEREO_MODE_TOP_BOTTOM, STEREO_MODE_LEFT_RIGHT, STEREO_MODE_STEREO_MESH }) public @interface StereoMode {} /** Indicates Monoscopic stereo layout, used with 360/3D/VR videos. */ public static final int STEREO_MODE_MONO = 0; /** Indicates Top-Bottom stereo layout, used with 360/3D/VR videos. */ public static final int STEREO_MODE_TOP_BOTTOM = 1; /** Indicates Left-Right stereo layout, used with 360/3D/VR videos. */ public static final int STEREO_MODE_LEFT_RIGHT = 2; /** * Indicates a stereo layout where the left and right eyes have separate meshes, used with * 360/3D/VR videos. */ public static final int STEREO_MODE_STEREO_MESH = 3; /** * Video colorspaces. One of {@link Format#NO_VALUE}, {@link #COLOR_SPACE_BT709}, {@link * #COLOR_SPACE_BT601} or {@link #COLOR_SPACE_BT2020}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({Format.NO_VALUE, COLOR_SPACE_BT709, COLOR_SPACE_BT601, COLOR_SPACE_BT2020}) public @interface ColorSpace {} /** @see MediaFormat#COLOR_STANDARD_BT709 */ public static final int COLOR_SPACE_BT709 = MediaFormat.COLOR_STANDARD_BT709; /** @see MediaFormat#COLOR_STANDARD_BT601_PAL */ public static final int COLOR_SPACE_BT601 = MediaFormat.COLOR_STANDARD_BT601_PAL; /** @see MediaFormat#COLOR_STANDARD_BT2020 */ public static final int COLOR_SPACE_BT2020 = MediaFormat.COLOR_STANDARD_BT2020; /** * Video color transfer characteristics. One of {@link Format#NO_VALUE}, {@link * #COLOR_TRANSFER_SDR}, {@link #COLOR_TRANSFER_ST2084} or {@link #COLOR_TRANSFER_HLG}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({Format.NO_VALUE, COLOR_TRANSFER_SDR, COLOR_TRANSFER_ST2084, COLOR_TRANSFER_HLG}) public @interface ColorTransfer {} /** @see MediaFormat#COLOR_TRANSFER_SDR_VIDEO */ public static final int COLOR_TRANSFER_SDR = MediaFormat.COLOR_TRANSFER_SDR_VIDEO; /** @see MediaFormat#COLOR_TRANSFER_ST2084 */ public static final int COLOR_TRANSFER_ST2084 = MediaFormat.COLOR_TRANSFER_ST2084; /** @see MediaFormat#COLOR_TRANSFER_HLG */ public static final int COLOR_TRANSFER_HLG = MediaFormat.COLOR_TRANSFER_HLG; /** * Video color range. One of {@link Format#NO_VALUE}, {@link #COLOR_RANGE_LIMITED} or {@link * #COLOR_RANGE_FULL}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({Format.NO_VALUE, COLOR_RANGE_LIMITED, COLOR_RANGE_FULL}) public @interface ColorRange {} /** @see MediaFormat#COLOR_RANGE_LIMITED */ public static final int COLOR_RANGE_LIMITED = MediaFormat.COLOR_RANGE_LIMITED; /** @see MediaFormat#COLOR_RANGE_FULL */ public static final int COLOR_RANGE_FULL = MediaFormat.COLOR_RANGE_FULL; /** Video projection types. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ Format.NO_VALUE, PROJECTION_RECTANGULAR, PROJECTION_EQUIRECTANGULAR, PROJECTION_CUBEMAP, PROJECTION_MESH }) public @interface Projection {} /** Conventional rectangular projection. */ public static final int PROJECTION_RECTANGULAR = 0; /** Equirectangular spherical projection. */ public static final int PROJECTION_EQUIRECTANGULAR = 1; /** Cube map projection. */ public static final int PROJECTION_CUBEMAP = 2; /** 3-D mesh projection. */ public static final int PROJECTION_MESH = 3; /** * Priority for media playback. * *
Larger values indicate higher priorities. */ public static final int PRIORITY_PLAYBACK = 0; /** * Priority for media downloading. * *
Larger values indicate higher priorities. */ public static final int PRIORITY_DOWNLOAD = PRIORITY_PLAYBACK - 1000; /** * Network connection type. One of {@link #NETWORK_TYPE_UNKNOWN}, {@link #NETWORK_TYPE_OFFLINE}, * {@link #NETWORK_TYPE_WIFI}, {@link #NETWORK_TYPE_2G}, {@link #NETWORK_TYPE_3G}, {@link * #NETWORK_TYPE_4G}, {@link #NETWORK_TYPE_5G_SA}, {@link #NETWORK_TYPE_5G_NSA}, {@link * #NETWORK_TYPE_CELLULAR_UNKNOWN}, {@link #NETWORK_TYPE_ETHERNET} or {@link #NETWORK_TYPE_OTHER}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ NETWORK_TYPE_UNKNOWN, NETWORK_TYPE_OFFLINE, NETWORK_TYPE_WIFI, NETWORK_TYPE_2G, NETWORK_TYPE_3G, NETWORK_TYPE_4G, NETWORK_TYPE_5G_SA, NETWORK_TYPE_5G_NSA, NETWORK_TYPE_CELLULAR_UNKNOWN, NETWORK_TYPE_ETHERNET, NETWORK_TYPE_OTHER }) public @interface NetworkType {} /** Unknown network type. */ public static final int NETWORK_TYPE_UNKNOWN = 0; /** No network connection. */ public static final int NETWORK_TYPE_OFFLINE = 1; /** Network type for a Wifi connection. */ public static final int NETWORK_TYPE_WIFI = 2; /** Network type for a 2G cellular connection. */ public static final int NETWORK_TYPE_2G = 3; /** Network type for a 3G cellular connection. */ public static final int NETWORK_TYPE_3G = 4; /** Network type for a 4G cellular connection. */ public static final int NETWORK_TYPE_4G = 5; /** Network type for a 5G stand-alone (SA) cellular connection. */ public static final int NETWORK_TYPE_5G_SA = 9; /** Network type for a 5G non-stand-alone (NSA) cellular connection. */ public static final int NETWORK_TYPE_5G_NSA = 10; /** * Network type for cellular connections which cannot be mapped to one of {@link * #NETWORK_TYPE_2G}, {@link #NETWORK_TYPE_3G}, or {@link #NETWORK_TYPE_4G}. */ public static final int NETWORK_TYPE_CELLULAR_UNKNOWN = 6; /** Network type for an Ethernet connection. */ public static final int NETWORK_TYPE_ETHERNET = 7; /** Network type for other connections which are not Wifi or cellular (e.g. VPN, Bluetooth). */ public static final int NETWORK_TYPE_OTHER = 8; /** * 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}. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef({WAKE_MODE_NONE, WAKE_MODE_LOCAL, WAKE_MODE_NETWORK}) public @interface WakeMode {} /** * A wake mode that will not cause the player to hold any locks. * *
This is suitable for applications that do not play media with the screen off. */ public static final int WAKE_MODE_NONE = 0; /** * A wake mode that will cause the player to hold a {@link android.os.PowerManager.WakeLock} * during playback. * *
This is suitable for applications that play media with the screen off and do not load media * over wifi. */ public static final int WAKE_MODE_LOCAL = 1; /** * A wake mode that will cause the player to hold a {@link android.os.PowerManager.WakeLock} and a * {@link android.net.wifi.WifiManager.WifiLock} during playback. * *
This is suitable for applications that play media with the screen off and may load media * over wifi. */ public static final int WAKE_MODE_NETWORK = 2; /** * Track role flags. Possible flag values are {@link #ROLE_FLAG_MAIN}, {@link * #ROLE_FLAG_ALTERNATE}, {@link #ROLE_FLAG_SUPPLEMENTARY}, {@link #ROLE_FLAG_COMMENTARY}, {@link * #ROLE_FLAG_DUB}, {@link #ROLE_FLAG_EMERGENCY}, {@link #ROLE_FLAG_CAPTION}, {@link * #ROLE_FLAG_SUBTITLE}, {@link #ROLE_FLAG_SIGN}, {@link #ROLE_FLAG_DESCRIBES_VIDEO}, {@link * #ROLE_FLAG_DESCRIBES_MUSIC_AND_SOUND}, {@link #ROLE_FLAG_ENHANCED_DIALOG_INTELLIGIBILITY}, * {@link #ROLE_FLAG_TRANSCRIBES_DIALOG}, {@link #ROLE_FLAG_EASY_TO_READ} and {@link * #ROLE_FLAG_TRICK_PLAY}. */ @Documented @Retention(RetentionPolicy.SOURCE) @Target({FIELD, METHOD, PARAMETER, LOCAL_VARIABLE, TYPE_USE}) @IntDef( flag = true, value = { ROLE_FLAG_MAIN, ROLE_FLAG_ALTERNATE, ROLE_FLAG_SUPPLEMENTARY, ROLE_FLAG_COMMENTARY, ROLE_FLAG_DUB, ROLE_FLAG_EMERGENCY, ROLE_FLAG_CAPTION, ROLE_FLAG_SUBTITLE, ROLE_FLAG_SIGN, ROLE_FLAG_DESCRIBES_VIDEO, ROLE_FLAG_DESCRIBES_MUSIC_AND_SOUND, ROLE_FLAG_ENHANCED_DIALOG_INTELLIGIBILITY, ROLE_FLAG_TRANSCRIBES_DIALOG, ROLE_FLAG_EASY_TO_READ, ROLE_FLAG_TRICK_PLAY }) public @interface RoleFlags {} // LINT.IfChange(role_flags) /** Indicates a main track. */ public static final int ROLE_FLAG_MAIN = 1; /** * Indicates an alternate track. For example a video track recorded from an different view point * than the main track(s). */ public static final int ROLE_FLAG_ALTERNATE = 1 << 1; /** * Indicates a supplementary track, meaning the track has lower importance than the main track(s). * For example a video track that provides a visual accompaniment to a main audio track. */ public static final int ROLE_FLAG_SUPPLEMENTARY = 1 << 2; /** Indicates the track contains commentary, for example from the director. */ public static final int ROLE_FLAG_COMMENTARY = 1 << 3; /** * Indicates the track is in a different language from the original, for example dubbed audio or * translated captions. */ public static final int ROLE_FLAG_DUB = 1 << 4; /** Indicates the track contains information about a current emergency. */ public static final int ROLE_FLAG_EMERGENCY = 1 << 5; /** * Indicates the track contains captions. This flag may be set on video tracks to indicate the * presence of burned in captions. */ public static final int ROLE_FLAG_CAPTION = 1 << 6; /** * Indicates the track contains subtitles. This flag may be set on video tracks to indicate the * presence of burned in subtitles. */ public static final int ROLE_FLAG_SUBTITLE = 1 << 7; /** Indicates the track contains a visual sign-language interpretation of an audio track. */ public static final int ROLE_FLAG_SIGN = 1 << 8; /** Indicates the track contains an audio or textual description of a video track. */ public static final int ROLE_FLAG_DESCRIBES_VIDEO = 1 << 9; /** Indicates the track contains a textual description of music and sound. */ public static final int ROLE_FLAG_DESCRIBES_MUSIC_AND_SOUND = 1 << 10; /** Indicates the track is designed for improved intelligibility of dialogue. */ public static final int ROLE_FLAG_ENHANCED_DIALOG_INTELLIGIBILITY = 1 << 11; /** Indicates the track contains a transcription of spoken dialog. */ public static final int ROLE_FLAG_TRANSCRIBES_DIALOG = 1 << 12; /** Indicates the track contains a text that has been edited for ease of reading. */ public static final int ROLE_FLAG_EASY_TO_READ = 1 << 13; /** Indicates the track is intended for trick play. */ public static final int ROLE_FLAG_TRICK_PLAY = 1 << 14; /** * Level of renderer support for a format. One of {@link #FORMAT_HANDLED}, {@link * #FORMAT_EXCEEDS_CAPABILITIES}, {@link #FORMAT_UNSUPPORTED_DRM}, {@link * #FORMAT_UNSUPPORTED_SUBTYPE} or {@link #FORMAT_UNSUPPORTED_TYPE}. */ @Documented @Retention(RetentionPolicy.SOURCE) @IntDef({ FORMAT_HANDLED, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE }) public @interface FormatSupport {} // TODO(b/172315872) Renderer was a link. Link to equivalent concept or remove @code. /** The {@code Renderer} is capable of rendering the format. */ public static final int FORMAT_HANDLED = 0b100; /** * The {@code Renderer} is capable of rendering formats with the same MIME type, but the * properties of the format exceed the renderer's capabilities. There is a chance the renderer * will be able to play the format in practice because some renderers report their capabilities * conservatively, but the expected outcome is that playback will fail. * *
Example: The {@code Renderer} is capable of rendering H264 and the format's MIME type is * {@code MimeTypes#VIDEO_H264}, but the format's resolution exceeds the maximum limit supported * by the underlying H264 decoder. */ public static final int FORMAT_EXCEEDS_CAPABILITIES = 0b011; /** * The {@code Renderer} is capable of rendering formats with the same MIME type, but is not * capable of rendering the format because the format's drm protection is not supported. * *
Example: The {@code Renderer} is capable of rendering H264 and the format's MIME type is * {@link MimeTypes#VIDEO_H264}, but the format indicates PlayReady drm protection whereas the * renderer only supports Widevine. */ public static final int FORMAT_UNSUPPORTED_DRM = 0b010; /** * The {@code Renderer} is a general purpose renderer for formats of the same top-level type, but * is not capable of rendering the format or any other format with the same MIME type because the * sub-type is not supported. * *
Example: The {@code Renderer} is a general purpose audio renderer and the format's MIME type * matches audio/[subtype], but there does not exist a suitable decoder for [subtype]. */ public static final int FORMAT_UNSUPPORTED_SUBTYPE = 0b001; /** * The {@code Renderer} is not capable of rendering the format, either because it does not support * the format's top-level type, or because it's a specialized renderer for a different MIME type. * *
Example: The {@code Renderer} is a general purpose video renderer, but the format has an * audio MIME type. */ public static final int FORMAT_UNSUPPORTED_TYPE = 0b000; /** @deprecated Use {@link Util#usToMs(long)}. */ @InlineMe( replacement = "Util.usToMs(timeUs)", imports = {"com.google.android.exoplayer2.util.Util"}) @Deprecated public static long usToMs(long timeUs) { return Util.usToMs(timeUs); } /** @deprecated Use {@link Util#msToUs(long)}. */ @InlineMe( replacement = "Util.msToUs(timeMs)", imports = {"com.google.android.exoplayer2.util.Util"}) @Deprecated public static long msToUs(long timeMs) { return Util.msToUs(timeMs); } /** @deprecated Use {@link Util#generateAudioSessionIdV21(Context)}. */ @InlineMe( replacement = "Util.generateAudioSessionIdV21(context)", imports = {"com.google.android.exoplayer2.util.Util"}) @Deprecated @RequiresApi(21) public static int generateAudioSessionIdV21(Context context) { return Util.generateAudioSessionIdV21(context); } /** @deprecated Use {@link Util#getFormatSupportString(int)}. */ @InlineMe( replacement = "Util.getFormatSupportString(formatSupport)", imports = {"com.google.android.exoplayer2.util.Util"}) @Deprecated public static String getFormatSupportString(@FormatSupport int formatSupport) { return Util.getFormatSupportString(formatSupport); } /** @deprecated Use {@link Util#getErrorCodeForMediaDrmErrorCode(int)}. */ @InlineMe( replacement = "Util.getErrorCodeForMediaDrmErrorCode(mediaDrmErrorCode)", imports = {"com.google.android.exoplayer2.util.Util"}) @Deprecated @PlaybackException.ErrorCode public static int getErrorCodeForMediaDrmErrorCode(int mediaDrmErrorCode) { return Util.getErrorCodeForMediaDrmErrorCode(mediaDrmErrorCode); } }