Document MergingMediaSource tag contract

Issue: #883 #minor-release PiperOrigin-RevId: 613970048 (cherry picked from commit eb6f607)
androidx · Mar 8, 2024 · a72a232 · a72a232
1 parent 4db96ac
commit a72a232
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/MergingMediaSource.java b/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/MergingMediaSource.java
@@ -44,6 +44,11 @@
  * Merges multiple {@link MediaSource}s.
  *
  * <p>The {@link Timeline}s of the sources being merged must have the same number of periods.
+ *
+ * <p>The values of {@link androidx.media3.common.TrackGroup#id} and {@link
+ * androidx.media3.common.Format#id} are modified to start with {@code i:}, where {@code i} is the
+ * 0-based index of the {@link MediaSource} passed to the constructor that created this {@link
+ * androidx.media3.common.TrackGroup} or {@link androidx.media3.common.Format}.
  */
 @UnstableApi
 public final class MergingMediaSource extends CompositeMediaSource<Integer> {