Image dans l'image

La fonction d'image dans l'image (PIP) pour les appareils portables Android permet aux utilisateurs de redimensionner une application avec une activité en cours dans une petite fenêtre. PIP est particulièrement utile pour les applications vidéo car le contenu continue à être lu pendant que l'utilisateur est libre d'effectuer d'autres actions. Les utilisateurs peuvent manipuler la position de cette fenêtre via l'interface utilisateur système et interagir avec l'application actuellement en image dans l'image avec (jusqu'à trois) actions fournies par l'application.

PIP nécessite une acceptation explicite des applications qui le prennent en charge et fonctionne par activité. (Une seule application peut avoir plusieurs activités, dont une seule est dans PIP.) Les activités demandent d'entrer une image dans l'image en appelant enterPictureInPictureMode() et reçoivent des rappels d'activité sous la forme de onPictureInPictureModeChanged() .

La méthode setPictureInPictureParams() permet aux activités de contrôler leur rapport hauteur/largeur dans PIP et les actions personnalisées, ce qui permet aux utilisateurs d'interagir avec l'activité sans avoir à la développer. Dans PIP, l'activité est dans un état de pause, mais rendu, et ne reçoit pas directement l'entrée tactile ou le focus de la fenêtre. Une seule tâche peut être dans PIP à la fois.

Plus d'informations sont disponibles dans la documentation Android Developer Picture-in-picture .

Configuration requise pour l'appareil

Pour prendre en charge PIP, activez la fonctionnalité système PackageManager#FEATURE_PICTURE_IN_PICTURE dans /android/frameworks/base/core/java/android/content/pm/PackageManager.java . Les appareils qui prennent en charge PIP doivent avoir un écran supérieur à 220 dp à sa plus petite largeur. Semblable à la multi-fenêtre à écran partagé, PIP permet à plusieurs activités de s'exécuter à l'écran en même temps. Par conséquent, les appareils doivent disposer de suffisamment de CPU et de RAM pour prendre en charge ce cas d'utilisation.

Mise en œuvre

La majeure partie de la gestion du cycle de vie des activités est effectuée dans le système entre ActivityManager et WindowManager . L'implémentation de l'interface utilisateur de référence se trouve dans le package SystemUI .

Les modifications apportées au système ne doivent pas affecter son comportement intrinsèque tel que défini par les tests de la suite de tests de compatibilité (CTS) . La logique du système pour PIP s'articule principalement autour de la gestion des tâches et des activités au sein de la pile "épinglée". Voici un aperçu rapide de la classe :

  • ActivityRecord : suit l'état d'image dans l'image de chaque activité. Pour empêcher les utilisateurs d'entrer PIP dans certaines circonstances, comme depuis l'écran de verrouillage ou pendant la réalité virtuelle, ajoutez des cas à checkEnterPictureInPictureState() .
  • ActivityManagerService : l'interface principale de l'activité pour demander la saisie de PIP et l'interface pour les appels de WindowManager et SystemUI pour modifier l'état de l'activité PIP.
  • ActivityStackSupervisor : appelé depuis ActivityManagerService pour déplacer des tâches dans ou hors de la pile épinglée, en mettant à jour le WindowManager si nécessaire.
  • PinnedStackWindowController : l'interface WindowManager d' ActivityManager .
  • PinnedStackController : signale les modifications apportées au système à SystemUI , telles que l'IME affiché/masqué, le rapport d'aspect modifié ou les actions modifiées.
  • BoundsAnimationController : anime les fenêtres d'activité PIP de manière à ne pas déclencher de changement de configuration lors du redimensionnement.
  • PipSnapAlgorithm : une classe partagée utilisée à la fois dans le système et SystemUI qui contrôle le comportement d'accrochage de la fenêtre PIP près des bords de l'écran.

La référence SystemUI fournit une implémentation complète de PIP qui prend en charge la présentation d'actions personnalisées aux utilisateurs et la manipulation générale, telle que l'expansion et le rejet. Les fabricants d'appareils peuvent s'appuyer sur ces changements, tant qu'ils n'affectent pas les comportements intrinsèques tels que définis par le CDD. Voici un aperçu rapide de la classe :

  • PipManager : le composant SystemUI démarré avec SystemUI .
  • PipTouchHandler : le gestionnaire tactile, qui contrôle les gestes qui manipulent le PIP. Ceci n'est utilisé que lorsque le consommateur d'entrée pour le PIP est actif (voir InputConsumerController ). De nouveaux gestes peuvent être ajoutés ici.
  • PipMotionHelper : une classe pratique qui suit la position PIP et la région autorisée à l'écran. Appels via ActivityManagerService pour mettre à jour ou animer la position et la taille du PIP.
  • PipMenuActivityController : démarre une activité qui affiche les actions fournies par l'activité actuellement dans PIP. Cette activité est une activité de superposition de tâches et supprime le consommateur d'entrée superposé pour lui permettre d'être interactive.
  • PipMenuActivity : l'implémentation de l'activité de menu.
  • PipMediaController : l'écouteur qui met à jour SystemUI lorsque la session multimédia change d'une manière qui pourrait affecter les actions par défaut sur le PIP.
  • PipNotificationController : le contrôleur qui garantit qu'une notification est active lorsqu'un utilisateur utilise la fonction PIP.
  • PipDismissViewController : la superposition affichée aux utilisateurs lorsqu'ils commencent à interagir avec le PIP pour indiquer qu'il peut être rejeté.

Emplacement par défaut

Il existe différentes ressources système qui contrôlent le placement par défaut du PIP :

  • config_defaultPictureInPictureGravity : l'entier de gravité , qui contrôle le coin où placer le PIP, tel que BOTTOM|RIGHT .
  • config_defaultPictureInPictureScreenEdgeInsets : les décalages des côtés de l'écran pour placer le PIP.
  • config_pictureInPictureDefaultSizePercent et config_pictureInPictureDefaultAspectRatio : la combinaison du pourcentage de la largeur de l'écran et du format d'image contrôle la taille du PIP. La taille PIP par défaut calculée ne doit pas être inférieure à @dimen/default_minimal_size_pip_resizable_task , tel que défini par CTS et le CDD.
  • config_pictureInPictureSnapMode : le comportement d'accrochage tel que défini dans PipSnapAlgorithm .

Les implémentations d'appareils ne doivent pas modifier les rapports d'aspect minimum et maximum qui sont définis dans le CDD et le CTS.

Autorisations

L'"opération d'application" par package ( OP_PICTURE_IN_PICTURE ) dans AppOpsManager ( master/core/java/android/app/AppOpsManager.java ), permet aux utilisateurs de contrôler PIP au niveau de l'application via les paramètres système. Les implémentations d'appareils doivent respecter cette vérification lorsqu'une activité demande de passer en mode image dans l'image.

Essai

Pour tester les implémentations PIP, exécutez tous les tests liés à l'image dans l'image trouvés dans les tests CTS côté hôte sous /cts/hostsidetests/services/activitymanager , en particulier dans ActivityManagerPinnedStackTests.java .