From 57ab7c770756e9d9fd375829d7325fa588f4d3ca Mon Sep 17 00:00:00 2001
From: Hongwei Wang <hwwang@google.com>
Date: Mon, 6 Apr 2020 17:04:45 -0700
Subject: [PATCH] Updates enterPictureInPicture API doc

enterPictureInPicture doc is updated with the instruction on how to
override the picture-in-picture window size.

Bug: 144849584
Change-Id: Ia36b307d8620924848dfee6856c90b68edc22f35
---
 core/java/android/app/Activity.java | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/core/java/android/app/Activity.java b/core/java/android/app/Activity.java
index 6480a6abeb785..00b7dd1d53af1 100644
--- a/core/java/android/app/Activity.java
+++ b/core/java/android/app/Activity.java
@@ -2823,6 +2823,11 @@ public class Activity extends ContextThemeWrapper
      * The system may disallow entering picture-in-picture in various cases, including when the
      * activity is not visible, if the screen is locked or if the user has an activity pinned.
      *
+     * <p>By default, system calculates the dimension of picture-in-picture window based on the
+     * given {@param params}.
+     * See <a href="{@docRoot}guide/topics/ui/picture-in-picture">Picture-in-picture Support</a>
+     * on how to override this behavior.</p>
+     *
      * @see android.R.attr#supportsPictureInPicture
      * @see PictureInPictureParams
      *