Картинка в картинке

Функция «картинка в картинке» (PIP) для портативных устройств Android позволяет пользователям изменять размер приложения с текущей деятельностью в небольшом окне. PIP особенно полезен для видеоприложений, поскольку контент продолжает воспроизводиться, пока пользователь может выполнять другие действия. Пользователи могут управлять положением этого окна через SystemUI и взаимодействовать с приложением, которое в данный момент находится в режиме «картинка в картинке», с помощью (до трех) действий, предоставляемых приложением.

PIP требует явного согласия со стороны приложений, которые его поддерживают, и работает для каждого действия. (Одно приложение может иметь несколько действий, только одно из которых находится в режиме PIP.) Действия запрашивают переход в режим «картинка в картинке» путем вызова enterPictureInPictureMode() и получают обратные вызовы активности в форме onPictureInPictureModeChanged() .

Метод setPictureInPictureParams() позволяет действиям контролировать соотношение сторон в режиме PIP и настраивать действия, которые позволяют пользователям взаимодействовать с действием без необходимости его расширения. В PIP действие находится в состоянии паузы, но рендеринга и не получает непосредственно сенсорного ввода или фокуса окна. В PIP одновременно может находиться только одна задача.

Дополнительную информацию можно найти в документации «Картинка в картинке» для разработчиков Android.

Требования к устройству

Для поддержки PIP включите системную функцию PackageManager#FEATURE_PICTURE_IN_PICTURE в /android/frameworks/base/core/java/android/content/pm/PackageManager.java . Устройства, поддерживающие PIP, должны иметь экран с разрешением более 220 dp при минимальной ширине. Подобно многооконному режиму разделенного экрана, PIP позволяет одновременно выполнять несколько действий на экране. Следовательно, устройства должны иметь достаточный процессор и оперативную память для поддержки этого варианта использования.

Выполнение

Большая часть управления жизненным циклом действий выполняется в системе между ActivityManager и WindowManager . Эталонная реализация пользовательского интерфейса находится в пакете SystemUI .

Модификации системы не должны влиять на ее внутреннее поведение, определенное тестами набора тестов совместимости (CTS) . Системная логика PIP в основном вращается вокруг управления задачами и действиями в «закрепленном» стеке. Вот краткий обзор класса:

  • ActivityRecord : отслеживает состояние «картинка в картинке» каждого действия. Чтобы запретить пользователям вводить PIP в определенных обстоятельствах, например, с экрана блокировки или во время VR, добавьте случаи в checkEnterPictureInPictureState() .
  • ActivityManagerService : основной интерфейс действия для запроса ввода PIP и интерфейс для вызовов из WindowManager и SystemUI для изменения состояния действия PIP.
  • ActivityStackSupervisor : вызывается из ActivityManagerService для перемещения задач в закрепленный стек или из него, при необходимости обновляя WindowManager .
  • PinnedStackWindowController : интерфейс WindowManager из ActivityManager .
  • PinnedStackController : сообщает об изменениях в системе в SystemUI , например, об отображении/скрытии IME, изменении соотношения сторон или изменении действий.
  • BoundsAnimationController : анимирует окна активности PIP таким образом, чтобы не вызывать изменения конфигурации при изменении размера.
  • PipSnapAlgorithm : общий класс, используемый как в системе, так и в SystemUI, который управляет поведением привязки окна PIP вблизи краев экрана.

Эталонный SystemUI обеспечивает полную реализацию PIP, которая поддерживает представление пользователям настраиваемых действий и общие манипуляции, такие как расширение и увольнение. Производители устройств могут опираться на эти изменения, если они не влияют на внутреннее поведение, определенное CDD. Вот краткий обзор класса:

  • PipManager : компонент SystemUI , который запускается с помощью SystemUI .
  • PipTouchHandler : обработчик касания, который управляет жестами, управляющими PIP. Это используется только тогда, когда активен входной потребитель для PIP (см. InputConsumerController ). Сюда можно добавить новые жесты.
  • PipMotionHelper : удобный класс, который отслеживает положение PIP и допустимую область на экране. Вызывает ActivityManagerService для обновления или анимации положения и размера PIP.
  • PipMenuActivityController : запускает действие, которое показывает действия, выполняемые действием, которое в данный момент находится в PIP. Это действие является действием наложения задач и удаляет наложенного потребителя входных данных, чтобы сделать его интерактивным.
  • PipMenuActivity : реализация действия меню.
  • PipMediaController : прослушиватель, который обновляет SystemUI , когда мультимедийный сеанс изменяется таким образом, что это может повлиять на действия по умолчанию в PIP.
  • PipNotificationController : контроллер, который гарантирует, что уведомление активно, пока пользователь использует функцию PIP.
  • PipDismissViewController : наложение, отображаемое пользователям, когда они начинают взаимодействовать с PIP, чтобы указать, что его можно закрыть.

Размещение по умолчанию

Существуют различные системные ресурсы, которые управляют размещением PIP по умолчанию:

  • config_defaultPictureInPictureGravity : целое число гравитации , которое управляет углом размещения PIP, например BOTTOM|RIGHT .
  • config_defaultPictureInPictureScreenEdgeInsets : смещения от сторон экрана для размещения PIP.
  • config_pictureInPictureDefaultSizePercent и config_pictureInPictureDefaultAspectRatio : комбинация процентов ширины экрана и соотношения сторон управляет размером PIP. Вычисленный размер PIP по умолчанию не должен быть меньше, чем @dimen/default_minimal_size_pip_resizable_task , как определено CTS и CDD.
  • config_pictureInPictureSnapMode : поведение привязки, определенное в PipSnapAlgorithm .

Реализации устройств не должны изменять минимальное и максимальное соотношение сторон, определенные в CDD и CTS.

Разрешения

«Операция приложения» для каждого пакета ( OP_PICTURE_IN_PICTURE ) в AppOpsManager ( main/core/java/android/app/AppOpsManager.java ) позволяет пользователям управлять PIP на уровне каждого приложения через настройки системы. Реализации устройств должны учитывать эту проверку, когда действие запрашивает переход в режим «картинка в картинке».

Тестирование

Чтобы протестировать реализации PIP, запустите все тесты, связанные с «картинка в картинке», которые можно найти в тестах CTS на стороне хоста в /cts/hostsidetests/services/activitymanager , особенно в ActivityManagerPinnedStackTests.java .