Update MediaMetadata javadoc to clarify nuances.

Samrobbo · ojw28 · commit 74fb05cfbe41 · 2021-10-26T14:12:10.000+01:00
PiperOrigin-RevId: 405616711
diff --git a/library/common/src/main/java/com/google/android/exoplayer2/Player.java b/library/common/src/main/java/com/google/android/exoplayer2/Player.java
@@ -141,7 +141,11 @@ default void onTracksInfoChanged(TracksInfo tracksInfo) {}
      *
      * <p>The provided {@link MediaMetadata} is a combination of the {@link MediaItem#mediaMetadata}
      * and the static and dynamic metadata from the {@link TrackSelection#getFormat(int) track
-     * selections' formats} and {@link Listener#onMetadata(Metadata)}.
+     * selections' formats} and {@link Listener#onMetadata(Metadata)}. If a field is populated in
+     * the {@link MediaItem#mediaMetadata}, it will be prioritised above the same field coming from
+     * static or dynamic metadata.
+     *
+     * <p>This method may be called multiple times in quick succession.
      *
      * <p>{@link #onEvents(Player, Events)} will also be called to report this event along with
      * other events that happen in the same {@link Looper} message queue iteration.

Original file line number	Diff line number	Diff line change
`@@ -141,7 +141,11 @@ default void onTracksInfoChanged(TracksInfo tracksInfo) {}`
`141`	`141`	`*`
`142`	`142`	`* The provided {@link MediaMetadata} is a combination of the {@link MediaItem#mediaMetadata}`
`143`	`143`	`* and the static and dynamic metadata from the {@link TrackSelection#getFormat(int) track`
`144`		`- * selections' formats} and {@link Listener#onMetadata(Metadata)}.`
	`144`	`+ * selections' formats} and {@link Listener#onMetadata(Metadata)}. If a field is populated in`
	`145`	`+ * the {@link MediaItem#mediaMetadata}, it will be prioritised above the same field coming from`
	`146`	`+ * static or dynamic metadata.`
	`147`	`+ *`
	`148`	`+ * This method may be called multiple times in quick succession.`
`145`	`149`	`*`
`146`	`150`	`* {@link #onEvents(Player, Events)} will also be called to report this event along with`
`147`	`151`	`* other events that happen in the same {@link Looper} message queue iteration.`