Imagen en imagen

La función de imagen en imagen (PIP) para dispositivos portátiles Android permite a los usuarios cambiar el tamaño de una aplicación con una actividad en curso en una pequeña ventana. PIP es especialmente útil para aplicaciones de video porque el contenido continúa reproduciéndose mientras el usuario puede realizar otras acciones. Los usuarios pueden manipular la posición de esta ventana a través de SystemUI e interactuar con la aplicación actualmente en imagen en imagen con (hasta tres) acciones proporcionadas por la aplicación.

PIP requiere una suscripció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 imagen en imagen 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 PIP y acciones personalizadas, lo que permite a los usuarios interactuar con la actividad sin tener que expandirla. En PIP, la actividad está en un estado de pausa, pero renderizado, y no recibe directamente la entrada táctil o el foco de la ventana. Solo una tarea puede estar en PIP a la vez.

Hay más información disponible en la documentación Picture-in-picture para desarrolladores de Android.

Requisitos del dispositivo

Para admitir PIP, habilite la característica 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 de más de 220 dp en su ancho más pequeño. Similar a la ventana múltiple de pantalla dividida, PIP permite que múltiples 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 gestión del ciclo de vida de la actividad se realiza en el sistema entre ActivityManager y WindowManager . La implementación de la interfaz de usuario de referencia se encuentra en el paquete SystemUI .

Las modificaciones al sistema no deben afectar su comportamiento intrínseco según lo definido por las pruebas de Compatibility Test Suite (CTS) . La lógica del sistema para PIP gira principalmente en torno a la gestión de tareas y actividades dentro de la pila "anclada". Aquí hay una descripción general rápida de la clase:

• ActivityRecord : realiza un seguimiento del estado de imagen en imagen de cada actividad. Para evitar que los usuarios ingresen a PIP en determinadas circunstancias, como desde la pantalla de bloqueo o durante la realidad virtual, agregue casos a checkEnterPictureInPictureState() .
• ActivityManagerService : la interfaz principal de la actividad para solicitar el ingreso de PIP y la interfaz para las llamadas de WindowManager y SystemUI para cambiar el estado de la actividad de PIP.
• ActivityStackSupervisor : llamado desde ActivityManagerService para mover tareas dentro o fuera de la pila anclada, actualizando WindowManager según sea necesario.
• PinnedStackWindowController : la interfaz WindowManager de ActivityManager .
• PinnedStackController : informa cambios en el sistema a SystemUI , como IME mostrado/oculto, relación de aspecto cambiada o acciones cambiadas.
• BoundsAnimationController : anima las ventanas de actividad de PIP de una manera que no desencadena un cambio de configuración al cambiar el tamaño.
• PipSnapAlgorithm : una clase compartida utilizada tanto en el sistema como en SystemUI que controla el comportamiento de ajuste de la ventana PIP cerca de los bordes de la pantalla.

El SystemUI de referencia proporciona una implementación completa de PIP que admite la presentación de acciones personalizadas a los usuarios y la manipulación general, como la expansión y el despido. Los fabricantes de dispositivos pueden aprovechar estos cambios, siempre que no afecten los comportamientos intrínsecos definidos por la CDD. Aquí hay una descripción general rápida de la clase:

• PipManager : el componente SystemUI que se inicia con SystemUI .
• PipTouchHandler : el controlador táctil, que controla los gestos que manipulan el PIP. Esto solo se usa mientras el consumidor de entrada para el PIP está activo (consulte InputConsumerController ). Aquí se pueden añadir nuevos gestos.
• PipMotionHelper : una clase de conveniencia que rastrea la posición de PIP y la región permitida en la 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 actualmente en PIP. Esta actividad es una actividad de superposición de tareas y elimina el consumidor de entrada superpuesto para permitir que sea interactivo.
• PipMenuActivity : la implementación de la actividad del menú.
• PipMediaController : el oyente que actualiza SystemUI cuando la sesión de medios cambia de una manera que podría afectar las acciones predeterminadas en el PIP.
• PipNotificationController : el controlador que asegura que una notificación esté activa mientras un usuario está usando la función PIP.
• PipDismissViewController : 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

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

• config_defaultPictureInPictureGravity : el 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 de PIP predeterminado calculado no debe ser más pequeño que @dimen/default_minimal_size_pip_resizable_task , según lo definido por CTS y CDD.
• config_pictureInPictureSnapMode : 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 CDD y CTS.

permisos

La "operación de aplicación" por paquete ( OP_PICTURE_IN_PICTURE ) en AppOpsManager ( master/core/java/android/app/AppOpsManager.java ), permite a los usuarios controlar PIP en un nivel por 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 imagen en imagen.

Pruebas

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