The default implementation does not allow decoder reuse. * + * @param decoderName The name of the decoder. * @param oldFormat The previous format. * @param newFormat The new format. * @return The result of the evaluation. diff --git a/libraries/exoplayer_dash/src/main/java/androidx/media3/exoplayer/dash/DashChunkSource.java b/libraries/exoplayer_dash/src/main/java/androidx/media3/exoplayer/dash/DashChunkSource.java index 11c18a39700..f26c8fd734b 100644 --- a/libraries/exoplayer_dash/src/main/java/androidx/media3/exoplayer/dash/DashChunkSource.java +++ b/libraries/exoplayer_dash/src/main/java/androidx/media3/exoplayer/dash/DashChunkSource.java @@ -50,6 +50,8 @@ interface Factory { * if unknown. * @param enableEventMessageTrack Whether to output an event message track. * @param closedCaptionFormats The {@link Format Formats} of closed caption tracks to be output. + * @param playerEmsgHandler The track output to write emsg messages to, or null if emsgs + * shouldn't be written. * @param transferListener The transfer listener which should be informed of any data transfers. * May be null if no listener is available. * @param playerId The {@link PlayerId} of the player using this chunk source. @@ -75,8 +77,9 @@ DashChunkSource createDashChunkSource( * Updates the manifest. * * @param newManifest The new manifest. + * @param newPeriodIndex The index of the period covered by {@code newManifest}. */ - void updateManifest(DashManifest newManifest, int periodIndex); + void updateManifest(DashManifest newManifest, int newPeriodIndex); /** * Updates the track selection. diff --git a/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/HlsMediaPeriod.java b/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/HlsMediaPeriod.java index c4bcfc50ecd..63d2b931d19 100644 --- a/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/HlsMediaPeriod.java +++ b/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/HlsMediaPeriod.java @@ -104,13 +104,17 @@ public final class HlsMediaPeriod implements MediaPeriod, HlsPlaylistTracker.Pla * be null if no listener is available. * @param drmSessionManager The {@link DrmSessionManager} to acquire {@link DrmSession * DrmSessions} with. + * @param drmEventDispatcher A {@link DrmSessionEventListener.EventDispatcher} used to distribute + * DRM-related events. * @param loadErrorHandlingPolicy A {@link LoadErrorHandlingPolicy}. * @param eventDispatcher A dispatcher to notify of events. * @param allocator An {@link Allocator} from which to obtain media buffer allocations. * @param compositeSequenceableLoaderFactory A factory to create composite {@link * SequenceableLoader}s for when this media source loads data from multiple streams. * @param allowChunklessPreparation Whether chunkless preparation is allowed. + * @param metadataType The type of metadata to extract from the period. * @param useSessionKeys Whether to use #EXT-X-SESSION-KEY tags. + * @param playerId The ID of the current player. */ public HlsMediaPeriod( HlsExtractorFactory extractorFactory, diff --git a/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/playlist/HlsMediaPlaylist.java b/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/playlist/HlsMediaPlaylist.java index fb2444d4bb1..5e6baec46be 100644 --- a/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/playlist/HlsMediaPlaylist.java +++ b/libraries/exoplayer_hls/src/main/java/androidx/media3/exoplayer/hls/playlist/HlsMediaPlaylist.java @@ -462,16 +462,20 @@ public RenditionReport(Uri playlistUri, long lastMediaSequence, int lastPartInde public final ServerControl serverControl; /** + * Constructs an instance. + * * @param playlistType See {@link #playlistType}. * @param baseUri See {@link #baseUri}. * @param tags See {@link #tags}. * @param startOffsetUs See {@link #startOffsetUs}. + * @param preciseStart See {@link #preciseStart}. * @param startTimeUs See {@link #startTimeUs}. * @param hasDiscontinuitySequence See {@link #hasDiscontinuitySequence}. * @param discontinuitySequence See {@link #discontinuitySequence}. * @param mediaSequence See {@link #mediaSequence}. * @param version See {@link #version}. * @param targetDurationUs See {@link #targetDurationUs}. + * @param partTargetDurationUs See {@link #partTargetDurationUs}. * @param hasIndependentSegments See {@link #hasIndependentSegments}. * @param hasEndTag See {@link #hasEndTag}. * @param hasProgramDateTime See {@link #hasProgramDateTime}. diff --git a/libraries/extractor/src/main/java/androidx/media3/extractor/FlacFrameReader.java b/libraries/extractor/src/main/java/androidx/media3/extractor/FlacFrameReader.java index 078982c6f0e..79123d3c691 100644 --- a/libraries/extractor/src/main/java/androidx/media3/extractor/FlacFrameReader.java +++ b/libraries/extractor/src/main/java/androidx/media3/extractor/FlacFrameReader.java @@ -132,6 +132,7 @@ public static boolean checkFrameHeaderFromPeek( * there is no guarantee on the peek position. * * @param input Input stream to get the sample number from (starting from the read position). + * @param flacStreamMetadata The FLAC metadata of the stream. * @return The frame first sample number. * @throws ParserException If an error occurs parsing the sample number. * @throws IOException If peeking from the input fails. diff --git a/libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttCssStyle.java b/libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttCssStyle.java index e27eefdb0fe..9908fe5a7bc 100644 --- a/libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttCssStyle.java +++ b/libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttCssStyle.java @@ -152,12 +152,13 @@ public void setTargetVoice(String targetVoice) { *
See also CSS Cascading.
+ *
* @param id The id of the cue if present, {@code null} otherwise.
* @param tag Name of the tag, {@code null} if it refers to the entire cue.
* @param classes An array containing the classes the tag belongs to. Must not be null.
* @param voice Annotated voice if present, {@code null} otherwise.
* @return The score of the match, zero if there is no match.
- * @see CSS Cascading
*/
public int getSpecificityScore(
@Nullable String id, @Nullable String tag, Set A command is not accepted if it is not a custom command or the command is not in the list of
+ * {@linkplain #getAvailableSessionCommands() available session commands}.
+ *
* Interoperability: When connected to {@link
* android.support.v4.media.session.MediaSessionCompat}, {@link SessionResult#resultCode} will
* return the custom result code from the {@code android.os.ResultReceiver#onReceiveResult(int,
* Bundle)} instead of the standard result codes defined in the {@link SessionResult}.
*
- * A command is not accepted if it is not a custom command.
- *
* @param command The custom command.
* @param args The additional arguments. May be empty.
* @return A {@link ListenableFuture} of {@link SessionResult} representing the pending
diff --git a/libraries/session/src/main/java/androidx/media3/session/MediaSession.java b/libraries/session/src/main/java/androidx/media3/session/MediaSession.java
index c1cd0c6e4aa..3c82ec75d2e 100644
--- a/libraries/session/src/main/java/androidx/media3/session/MediaSession.java
+++ b/libraries/session/src/main/java/androidx/media3/session/MediaSession.java
@@ -816,6 +816,7 @@ public BitmapLoader getBitmapLoader() {
*
* A command is not accepted if it is not a custom command.
*
+ * @param controller The controller to send the custom command to.
* @param command A custom command.
* @param args A {@link Bundle} for additional arguments. May be empty.
* @return A {@link ListenableFuture} of {@link SessionResult} from the controller.
@@ -1041,6 +1042,10 @@ default ListenableFuture {@link MediaController} instances are only allowed to send a command if the command has
+ * been added to the {@link MediaSession.ConnectionResult#availableSessionCommands list of
+ * available session commands} in {@link #onConnect} or set via {@link #setAvailableCommands}.
+ *
* Interoperability: This will be also called by {@link
* android.support.v4.media.MediaBrowserCompat#sendCustomAction}. If so, {@code extras} from
* {@link android.support.v4.media.MediaBrowserCompat#sendCustomAction} will be considered as
diff --git a/libraries/test_utils/src/main/java/androidx/media3/test/utils/Action.java b/libraries/test_utils/src/main/java/androidx/media3/test/utils/Action.java
index 5b5ed5b678a..ac5aff56115 100644
--- a/libraries/test_utils/src/main/java/androidx/media3/test/utils/Action.java
+++ b/libraries/test_utils/src/main/java/androidx/media3/test/utils/Action.java
@@ -1098,7 +1098,10 @@ public static final class ExecuteRunnable extends Action {
private final Runnable runnable;
/**
+ * Constructs an instance.
+ *
* @param tag A tag to use for logging.
+ * @param runnable The runnable to run.
*/
public ExecuteRunnable(@Size(max = 23) String tag, Runnable runnable) {
super(tag, "ExecuteRunnable");
diff --git a/libraries/test_utils/src/main/java/androidx/media3/test/utils/ActionSchedule.java b/libraries/test_utils/src/main/java/androidx/media3/test/utils/ActionSchedule.java
index 019b9c46993..beafa0419e3 100644
--- a/libraries/test_utils/src/main/java/androidx/media3/test/utils/ActionSchedule.java
+++ b/libraries/test_utils/src/main/java/androidx/media3/test/utils/ActionSchedule.java
@@ -349,7 +349,7 @@ public Builder setAudioAttributes(AudioAttributes audioAttributes, boolean handl
}
/**
- * Schedules a set media items action to be executed.
+ * Schedules a set media source actions to be executed.
*
* @param mediaItemIndex The media item index to start playback from or {@link C#INDEX_UNSET} if
* the playback position should not be reset.
@@ -357,6 +357,7 @@ public Builder setAudioAttributes(AudioAttributes audioAttributes, boolean handl
* C#TIME_UNSET} is passed the default position is used. In any case, if {@code
* mediaItemIndex} is set to {@link C#INDEX_UNSET} the position is not reset at all and this
* parameter is ignored.
+ * @param sources The media sources to be set on the player.
* @return The builder, for convenience.
*/
@CanIgnoreReturnValue
@@ -365,9 +366,10 @@ public Builder setMediaSources(int mediaItemIndex, long positionMs, MediaSource.
}
/**
- * Schedules a set media items action to be executed.
+ * Schedules a set media sources action to be executed.
*
* @param resetPosition Whether the playback position should be reset.
+ * @param sources The media sources to be set on the player.
* @return The builder, for convenience.
*/
@CanIgnoreReturnValue
@@ -490,6 +492,7 @@ public Builder setShuffleModeEnabled(boolean shuffleModeEnabled) {
/**
* Schedules sending a {@link PlayerMessage}.
*
+ * @param target A message target.
* @param positionMs The position in the current media item at which the message should be sent,
* in milliseconds.
* @return The builder, for convenience.
diff --git a/libraries/test_utils/src/main/java/androidx/media3/test/utils/ExtractorAsserts.java b/libraries/test_utils/src/main/java/androidx/media3/test/utils/ExtractorAsserts.java
index 3ed82c380a9..979ac9d0972 100644
--- a/libraries/test_utils/src/main/java/androidx/media3/test/utils/ExtractorAsserts.java
+++ b/libraries/test_utils/src/main/java/androidx/media3/test/utils/ExtractorAsserts.java
@@ -360,6 +360,9 @@ public static void assertBehavior(
*
* The output of the extractor is compared against prerecorded dump files.
*
+ * @param factory An {@link ExtractorFactory} which creates instances of the {@link Extractor}
+ * class which is to be tested.
+ * @param file The input file to pass to the extractor.
* @param assertionConfig Details of how to read and process the source and dump files.
* @param simulationConfig Details on the environment to simulate and behaviours to assert.
* @throws IOException If reading from the input fails.
diff --git a/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaPeriod.java b/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaPeriod.java
index cd804fe5fe8..7ec904028e6 100644
--- a/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaPeriod.java
+++ b/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaPeriod.java
@@ -375,6 +375,7 @@ public boolean isLoading() {
/**
* Creates a new {@link FakeSampleStream}.
*
+ * @param allocator An {@link Allocator} from which to obtain media buffer allocations.
* @param mediaSourceEventDispatcher A {@link MediaSourceEventListener.EventDispatcher} to notify
* of media events.
* @param drmSessionManager A {@link DrmSessionManager} for DRM interactions.
diff --git a/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaSource.java b/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaSource.java
index c1c206ebf10..ee34c7db658 100644
--- a/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaSource.java
+++ b/libraries/test_utils/src/main/java/androidx/media3/test/utils/FakeMediaSource.java
@@ -339,6 +339,7 @@ public List