From 31e69d2daca143326d9fbf907fb1695a3a31b6d8 Mon Sep 17 00:00:00 2001
From: Niklas Baudy <niklas.baudy@vanniktech.de>
Date: Fri, 19 Aug 2022 15:35:59 +0200
Subject: [PATCH] MediaSession.Callback: Document an example when
 onAddMediaItems is called.

---
 .../src/main/java/androidx/media3/session/MediaSession.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

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 69fb1c83b7..3e2f8c0837 100644
--- a/libraries/session/src/main/java/androidx/media3/session/MediaSession.java
+++ b/libraries/session/src/main/java/androidx/media3/session/MediaSession.java
@@ -993,7 +993,7 @@ public class MediaSession {
     /**
      * Called when a controller requested to add new {@linkplain MediaItem media items} to the
      * playlist via one of the {@code Player.addMediaItem(s)} or {@code Player.setMediaItem(s)}
-     * methods.
+     * methods. For instance when selecting an item on Android Auto, which should then be played.
      *
      * <p>Note that the requested {@linkplain MediaItem media items} don't have a {@link
      * MediaItem.LocalConfiguration} (for example, a URI) and need to be updated to make them