From bd6c16908d922ecaf672d5f9a6d701fccb95b3ff Mon Sep 17 00:00:00 2001 From: Jae Seo Date: Thu, 19 May 2016 14:17:27 -0700 Subject: [PATCH] MediaBrowserService: Add more explanation on getBrowserRootHints() Bug: 28840985 Change-Id: If4dbcaaa23093b2e6d5ab6158db67b1248464fb8 --- media/java/android/service/media/MediaBrowserService.java | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/media/java/android/service/media/MediaBrowserService.java b/media/java/android/service/media/MediaBrowserService.java index 7eb91884e8d41..c0d950323db5f 100644 --- a/media/java/android/service/media/MediaBrowserService.java +++ b/media/java/android/service/media/MediaBrowserService.java @@ -489,9 +489,15 @@ public abstract class MediaBrowserService extends Service { /** * Gets the root hints sent from the currently connected {@link MediaBrowser}. + * The root hints are service-specific arguments included in an optional bundle sent to the + * media browser service when connecting and retrieving the root id for browsing, or null if + * none. The contents of this bundle may affect the information returned when browsing. * * @throws IllegalStateException If this method is called outside of {@link #onLoadChildren} * or {@link #onLoadItem} + * @see MediaBrowserService.BrowserRoot#EXTRA_RECENT + * @see MediaBrowserService.BrowserRoot#EXTRA_OFFLINE + * @see MediaBrowserService.BrowserRoot#EXTRA_SUGGESTED */ public final Bundle getBrowserRootHints() { if (mCurConnection == null) {