From 6200266917dbd000bac0ebf9f5a623ded37ddb7a Mon Sep 17 00:00:00 2001
From: Hyundo Moon <hdmoon@google.com>
Date: Fri, 21 Feb 2020 09:48:11 +0900
Subject: [PATCH] Add javadoc for the difference between transfer and select

Bug: 149912538
Test: Builds successfully
Change-Id: I5282bf6572a6ef281028e0a2368e9385c7564f46
---
 media/java/android/media/MediaRouter2.java | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/media/java/android/media/MediaRouter2.java b/media/java/android/media/MediaRouter2.java
index 079fee8ce20a7..34109194acbab 100644
--- a/media/java/android/media/MediaRouter2.java
+++ b/media/java/android/media/MediaRouter2.java
@@ -976,8 +976,12 @@ public class MediaRouter2 {
         }
 
         /**
-         * Selects a route for the remote session. The given route must satisfy all of the
-         * following conditions:
+         * Selects a route for the remote session. After a route is selected, the media is expected
+         * to be played to the all the selected routes. This is different from {@link
+         * MediaRouter2#transferTo(MediaRoute2Info)} transferring to a route},
+         * where the media is expected to 'move' from one route to another.
+         * <p>
+         * The given route must satisfy all of the following conditions:
          * <ul>
          * <li>ID should not be included in {@link #getSelectedRoutes()}</li>
          * <li>ID should be included in {@link #getSelectableRoutes()}</li>
@@ -1024,8 +1028,10 @@ public class MediaRouter2 {
         }
 
         /**
-         * Deselects a route from the remote session. The given route must satisfy all of the
-         * following conditions:
+         * Deselects a route from the remote session. After a route is deselected, the media is
+         * expected to be stopped on the deselected routes.
+         * <p>
+         * The given route must satisfy all of the following conditions:
          * <ul>
          * <li>ID should be included in {@link #getSelectedRoutes()}</li>
          * <li>ID should be included in {@link #getDeselectableRoutes()}</li>