Imagen en imagen

La función de pantalla en pantalla (PIP) para dispositivos portátiles Android permite a los usuarios cambiar el tamaño de una app con una actividad en curso en una ventana pequeña. El PIP es especialmente útil para las apps de video, ya que el contenido sigue reproduciéndose mientras el usuario puede realizar otras acciones. Los usuarios pueden manipular la posición de esta ventana a través de SystemUI y también interactuar con la aplicación que se encuentra en pantalla en pantalla con hasta tres acciones proporcionadas por la app.

El PIP requiere la habilitación explícita de las aplicaciones que lo admiten y funciona por actividad. (Una sola aplicación puede tener varias actividades, de las cuales solo una está en PIP). Las actividades solicitan ingresar al modo de pantalla en pantalla llamando a enterPictureInPictureMode() y reciben devoluciones de llamada de actividad en forma de onPictureInPictureModeChanged().

El método setPictureInPictureParams() permite que las actividades controlen su relación de aspecto mientras están en el modo PIP y en las acciones personalizadas, lo que permite que los usuarios interactúen con la actividad sin tener que expandirla. En el modo PIP, la actividad está en un estado en pausa, pero renderizado, y no recibe directamente la entrada táctil ni el enfoque de la ventana. Solo se puede realizar una tarea en PIP a la vez.

Hay más información disponible en la documentación de Pantalla en pantalla de Android Developers.

Requisitos del dispositivo

Para admitir PIP, habilita la función del sistema PackageManager#FEATURE_PICTURE_IN_PICTURE en /android/frameworks/base/core/java/android/content/pm/PackageManager.java. Los dispositivos que admiten PIP deben tener una pantalla que sea mayor que 220 dp en su ancho más pequeño. Al igual que el modo multiventana de pantalla dividida, el PIP permite que varias actividades se ejecuten en pantalla al mismo tiempo. Por lo tanto, los dispositivos deben tener suficiente CPU y RAM para admitir este caso de uso.

Implementación

La mayor parte de la administración del ciclo de vida de la actividad se realiza en el sistema entre ActivityManager y WindowManager. La implementación de la IU de referencia se encuentra en el paquete SystemUI.

Las modificaciones en el sistema no deben afectar su comportamiento intrínseco, según lo definido por las pruebas del conjunto de pruebas de compatibilidad (CTS). La lógica del sistema para PIP se centra principalmente en la administración de tareas y actividades dentro de la pila “fijada”. Esta es una breve descripción general de la clase:

  • ActivityRecord: Hace un seguimiento del estado de pantalla en pantalla de cada actividad. Para evitar que los usuarios ingresen al modo PIP en ciertas circunstancias, como desde la pantalla de bloqueo o durante la realidad virtual, agrega casos a checkEnterPictureInPictureState().
  • ActivityManagerService: Es la interfaz principal de la actividad para solicitar el ingreso al modo PIP y la interfaz para las llamadas de WindowManager y SystemUI para cambiar el estado de la actividad de PIP.
  • ActivityStackSupervisor: Se llama desde ActivityManagerService para mover tareas dentro o fuera de la pila fija, y actualizar WindowManager según sea necesario.
  • PinnedStackWindowController: Es la interfaz WindowManager de ActivityManager.
  • PinnedStackController: Informa los cambios en el sistema a SystemUI, como la visualización o ocultación del IME, el cambio de la relación de aspecto o el cambio de acciones.
  • BoundsAnimationController: Anima las ventanas de actividad de PIP de una manera que no active un cambio de configuración mientras se cambia el tamaño.
  • PipSnapAlgorithm: Es una clase compartida que se usa en el sistema y en SystemUI que controla el comportamiento de ajuste de la ventana de PIP cerca de los bordes de la pantalla.

La referencia SystemUI proporciona una implementación completa del PIP que admite la presentación de acciones personalizadas a los usuarios y la manipulación general, como la expansión y el descarte. Los fabricantes de dispositivos pueden aprovechar estos cambios, siempre que no afecten los comportamientos intrínsecos definidos en la CDD. A continuación, se incluye una breve descripción general de la clase:

  • PipManager: Es el componente SystemUI que se inicia con SystemUI.
  • PipTouchHandler: Es el controlador de tacto, que controla los gestos que manipulan el PIP. Esto solo se usa mientras el consumidor de entrada para el PIP está activo (consulta InputConsumerController). Aquí se pueden agregar gestos nuevos.
  • PipMotionHelper: Es una clase conveniente que realiza un seguimiento de la posición del PIP y la región permitida en pantalla. Llama a ActivityManagerService para actualizar o animar la posición y el tamaño del PIP.
  • PipMenuActivityController: Inicia una actividad que muestra las acciones proporcionadas por la actividad que se encuentra actualmente en PIP. Esta actividad es una actividad de superposición de tareas y quita el consumidor de entrada superpuesto para permitir que sea interactiva.
  • PipMenuActivity: Es la implementación de la actividad del menú.
  • PipMediaController: Es el objeto de escucha que actualiza SystemUI cuando la sesión multimedia cambia de una manera que podría afectar las acciones predeterminadas en el PIP.
  • PipNotificationController: Es el controlador que garantiza que una notificación esté activa mientras un usuario usa la función PIP.
  • PipDismissViewController: Es la superposición que se muestra a los usuarios cuando comienzan a interactuar con el PIP para indicar que se puede descartar.

Ubicación predeterminada

Existen varios recursos del sistema que controlan la ubicación predeterminada del PIP:

  • config_defaultPictureInPictureGravity: Es el número entero de gravedad, que controla la esquina para colocar el PIP, como BOTTOM|RIGHT.
  • config_defaultPictureInPictureScreenEdgeInsets: Los desplazamientos desde los lados de la pantalla para colocar el PIP.
  • config_pictureInPictureDefaultSizePercent y config_pictureInPictureDefaultAspectRatio: La combinación del porcentaje del ancho de la pantalla y la relación de aspecto controla el tamaño del PIP. El tamaño predeterminado del PIP calculado no debe ser menor que @dimen/default_minimal_size_pip_resizable_task, como lo definen CTS y el CDD.
  • config_pictureInPictureSnapMode: Es el comportamiento de ajuste como se define en PipSnapAlgorithm.

Las implementaciones de dispositivos no deben cambiar las relaciones de aspecto mínimas y máximas que se definen en el CDD y el CTS.

Permisos

La "operación de la aplicación" (OP_PICTURE_IN_PICTURE) por paquete en AppOpsManager (main/core/java/android/app/AppOpsManager.java) permite a los usuarios controlar el PIP a nivel de la aplicación a través de la configuración del sistema. Las implementaciones de dispositivos deben respetar esta verificación cuando una actividad solicita ingresar al modo de pantalla en pantalla.

Prueba

Para probar las implementaciones de PIP, ejecuta todas las pruebas relacionadas con la imagen en imagen que se encuentran en las pruebas de CTS del host en /cts/hostsidetests/services/activitymanager, en particular en ActivityManagerPinnedStackTests.java.