Поддержка многооконного режима

В Android N добавлена поддержка отображения нескольких приложений одновременно. На мобильных устройствах два приложения могут быть запущены рядом или друг над другом в режиме разделения экрана. На телевизорах приложения могут использовать режим "картинка в картинке", чтобы воспроизводить видео, пока пользователи работают с другим приложением.

Если вы создаете приложение с использованием N Preview SDK, вы можете указать, как оно будет действовать в многооконном режиме. Например, можно задать минимальные допустимые размеры окна приложения. Также можно отключить многооконный режим для приложения, чтобы оно отображалось только в полноэкранном режиме.

Обзор

В Android N несколько приложений могут одновременно находиться на экране. Например, пользователь может разделить экран, чтобы просматривать веб-страницу слева и писать сообщение электронной почты справа. Возможности пользователя зависят от устройства.

  • На мобильных устройствах с Android N доступен режим разделения экрана. В этом режиме два приложения отображаются рядом или друг над другом. Пользователь может перетащить линию разделения, чтобы увеличить окно одного приложения и уменьшить окно другого.
  • На устройствах Nexus Player с Android N для приложений будет доступен режим "картинка в картинке", который позволит приложению отображать контент, пока пользователь просматривает другие приложения или взаимодействует с ними.
  • Производители более крупных устройств могут активировать режим произвольной формы, где пользователь может любым образом изменять размер каждого окна. В этом случае помимо режима разделения экрана на устройстве будет доступен и этот режим.

Рис. 1. Два приложения отображаются рядом в режиме разделения экрана.

Пользователь может перейти в многооконный режим следующими способами.

  • Если пользователь откроет экран обзора и длительно нажмет название операции, ее можно будет перетащить в выделенную часть экрана и переключить в многооконный режим.
  • Если пользователь длительно нажмет кнопку "Обзор", устройство переключит текущую операцию в многооконный режим и откроет экран обзора, где пользователь сможет выбрать другую операцию для совместного отображения.

Пользователи могут перетаскивать данные между окнами операций в режиме совместного отображения. (Ранее перетаскивать данные можно было только в рамках одной операции).

Жизненный цикл многооконного режима

Многооконный режим не меняет жизненный цикл операции.

В этом режиме в каждый момент времени активной является только последняя операция, с которой взаимодействовал пользователь. Такая операция считается самой верхней. Все другие операции приостановлены, даже если они отображаются. Однако система отдает приостановленным, но видимым операциям более высокий приоритет, чем невидимым. Если пользователь взаимодействует с одной из приостановленных операций, она возобновляется, а прежняя самая верхняя операция приостанавливается.

Примечание. В многооконном режиме приложение может быть приостановлено и по-прежнему видимо для пользователя. Приложению может потребоваться продолжать свои операции, даже если оно приостановлено. Например, видимое приостановленное приложение, воспроизводящее видео, будет по-прежнему показывать видео. Поэтому мы не рекомендуем приостанавливать воспроизведение в обработчиках onPause() таких приложений. Вместо этого следует приостановить видео в onStop() и возобновить воспроизведение в onStart().

Если пользователь переводит приложение в многооконный режим, система уведомляет операцию об изменении конфигурации, как указано в документе Обработка изменений во время выполнения. По сути это изменение так же действует на жизненный цикл операции, как уведомление приложения системой о переходе устройства из вертикальной ориентации в горизонтальную, только изменяются размеры экрана, а не ориентация. Как описано в документе Обработка изменений во время выполнения, операция может обработать изменение конфигурации самостоятельно или может позволить системе удалить окно операции и создать его заново с новыми размерами.

Если пользователь увеличивает одну из сторон окна, система меняет размер окна операции в соответствии с действием пользователя и применяет изменения в режиме выполнения по мере необходимости. Если приложение не успевает отрисовать новые области, система временно заполняет их цветом, заданным атрибутом windowBackground или атрибутом стиля windowBackgroundFallback по умолчанию.

Настройка приложения для многооконного режима

Если ваше приложение предназначено для Android N, вы можете указать, каким образом поддерживают (и поддерживают ли) операции вашего приложения многооконный режим. Атрибуты управления размером и макетом устанавливаются в манифесте. Настройки атрибутов корневой операции применяются ко всем операциям в ее стеке задач.

Примечание. Если приложение с поддержкой различной ориентации было создано с версией SDK, более ранней, чем Android N, и пользователь запустит это приложение в многооконном режиме, система принудительно изменит размер приложения. Система отображает диалоговое окно с предупреждением о том, что приложение может работать непредвиденным образом. Система не меняет размер окна для приложений с фиксированной ориентацией. Если пользователь попытается открыть такое приложение в многооконном режиме, оно займет весь экран.

android:resizeableActivity

Установите этот атрибут в узле <activity> или <application> манифеста, чтобы включить или отключить многооконный режим:

android:resizeableActivity=["true" | "false"]

Если для этого атрибута задано значение true, операцию можно запускать в режимах разделения экрана и произвольной формы. Если для атрибута задано значение false, операция не поддерживает многооконный режим. Если значение равно false и пользователь пытается запустить операцию в многооконном режиме, она занимает весь экран.

Если приложение предназначено для Android N, но значение для этого атрибута не было указано, то по умолчанию используется значение true.

android:supportsPictureInPicture

Установите этот атрибут в узле <activity> манифеста, чтобы указать, поддерживает ли операция режим "картинка в картинке". Этот атрибут не принимается во внимание, если для android:resizeableActivity установлено значение false.

android:supportsPictureInPicture=["true" | "false"]

Атрибуты макета

В Android N элемент манифеста <layout> поддерживает несколько атрибутов, которые определяют поведение операции в многооконном режиме.

android:defaultWidth
Ширина окна операции по умолчанию в режиме произвольной формы.
android:defaultHeight
Высота окна операции по умолчанию в режиме произвольной формы.
android:gravity
Начальная позиция окна операции в режиме произвольной формы. Допустимые значения см. в описании класса Gravity.
android:minimalSize
Минимальные значения высоты и ширины окна операции в режимах разделения экрана и произвольной формы. Если пользователь перемещает разделительную линию в режиме разделения экрана, чтобы сделать размер окна операции меньше указанного минимума, система обрезает его до запрошенного пользователем размера.

В следующем примере кода показано, как задать размер и позицию окна операции по умолчанию, а также ее минимальный размер в режиме произвольной формы:

<activity android:name=".MyActivity">
    <layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end"
          android:minimalSize="450dp" />
</activity>

Запуск приложения в многооконном режиме

Android N предоставляет новые возможности для поддержки приложений в многооконном режиме.

Недоступные возможности в многооконном режиме

Некоторые возможности отключены или игнорируются в многооконном режиме, потому что они не имеют смысла для операции, которая отображается на экране устройства одновременно с другими операциями или приложениями. Ниже приведены примеры таких возможностей.

  • Отключены некоторые параметры настройки системного интерфейса. Например, приложения не могут скрыть строку состояния, если они не работают в полноэкранном режиме.
  • Система не учитывает изменения атрибута android:screenOrientation.

Уведомления об изменениях и запросы в многооконном режиме

Для поддержки многооконного режима в класс Activity были добавлены следующие методы. Подробнее о каждом из них см. в справочнике по N Preview SDK.

Activity.inMultiWindow()
Вызовите этот метод, чтобы узнать, находится ли операция в многооконном режиме.
Activity.inPictureInPicture()
Вызовите этот метод, чтобы узнать, находится ли операция в режиме "картинка в картинке".

Примечание. Режим "картинка в картинке" — это частный случай многооконного режима. Если метод myActivity.inPictureInPicture() возвращает значение true, myActivity.inMultiWindow() также возвращает true.

Activity.onMultiWindowChanged()
Система вызывает этот метод, когда операция переходит в многооконный режим или выходит из него. Система передает методу значение true, если операция входит в многооконный режим, и значение false, если она выходит из него.
Activity.onPictureInPictureChanged()
Система вызывает этот метод, когда операция переходит в режим "картинка в картинке". Система передает методу значение true, если операция входит в режим "картинка в картинке", и значение false, если она выходит из него.

Также существуют версии Fragment для этих методов, например, Fragment.inMultiWindow().

Переход в режим "картинка в картинке"

Чтобы перевести операцию в режим "картинка в картинке", вызовите новый метод Activity.enterPictureInPicture(). Этот метод игнорируется, если устройство не поддерживает режим "картинка в картинке". Дополнительная информация содержится в документации Режим "картинка в картинке".

Запуск новых операций в многооконном режиме

При запуске новой операции можно сообщить системе, что окно новой операции следует показать рядом с текущим, если это возможно. Для этого используйте флаг Intent.FLAG_ACTIVITY_LAUNCH_TO_ADJACENT. Этот флаг запрашивает следующее поведение.

  • Если устройство находится в режиме разделения экрана, система пытается создать окно новой операции рядом с окном запустившей ее операции, чтобы разместить две операции на экране. Не гарантируется, что система сможет это сделать, но если это возможно, операции отображаются рядом друг с другом.
  • Если устройство не находится в режиме разделения экрана, этот флаг не учитывается.

Если при запуске новой операции устройство находится в режиме произвольной формы, вы можете задать размеры и позицию окна новой операции, вызвав метод ActivityOptions.setLaunchBounds(). Этот метод игнорируется, если устройство не находится в многооконном режиме.

Примечание. Если запустить операцию в стеке задач, она заменит операцию на экране, унаследовав все ее свойства многооконного режима. Чтобы запустить новую операцию в отдельном окне в многооконном режиме, ее следует запустить в новом стеке задач.

Поддержка перетаскивания

Пользователи могут перетаскивать данные между окнами операций в режиме совместного отображения. (Ранее перетаскивать данные можно было только в рамках одной операции). Поэтому вы можете реализовать функции перетаскивания в своем приложении, если оно еще их не поддерживает.

В N Preview SDK пакет android.view расширен для поддержки перетаскивания между приложениями. Дополнительная информация о нижеприведенных классах и методах содержится в справочнике по N Preview SDK.

android.view.DropPermissions
Объект токена для указания разрешений приложению, в которое перетаскиваются данные.
View.startDragAndDrop()
Новый псевдоним для View.startDrag(). Чтобы разрешить перетаскивание между операциями, передайте новый флаг View.DRAG_FLAG_GLOBAL. Если вам нужно предоставить принимающей операции разрешения на чтение или запись URI, передайте новый флаг View.DRAG_FLAG_GLOBAL_URI_READ или View.DRAG_FLAG_GLOBAL_URI_WRITE соответственно.
View.cancelDragAndDrop()
Отменяет текущую операцию перетаскивания. Этот метод может вызвать только приложение, в котором была инициирована операция перетаскивания.
View.updateDragShadow()
Заменяет тень текущей операции перетаскивания. Этот метод может вызвать только приложение, в котором была инициирована операция перетаскивания.
Activity.requestDropPermissions()
Запрашивает разрешения для URI контента, переданных в объекте ClipData в DragEvent.

Тестирование приложения в многооконном режиме

Независимо от того, обновляете ли вы свое приложение для Android N, вам необходимо подтвердить его поведение в многооконном режиме на тот случай, если пользователь попытается запустить его в этом режиме на устройстве с Android N.

Настройка тестового устройства

Если установить Android N на устройстве, режим разделения экрана будет поддерживаться автоматически.

Если приложение было создано без использования N Preview SDK

Если вы не применяли N Preview SDK для создания приложения и пользователь попытается запустить его в многооконном режиме, система принудительно изменит размер окна приложения, если его ориентация не зафиксирована.

Если для приложения не задана фиксированная ориентация, вам следует запустить его на устройстве с Android N и попытаться перевести его в режим разделения экрана. Убедитесь, что приложение работает нормально после принудительного изменения размера.

Если для приложения задана фиксированная ориентация, попытайтесь перевести его в многооконный режим. Убедитесь, что при этом приложение остается в полноэкранном режиме.

Если приложение поддерживает многооконный режим

Если вы использовали N Preview SDK для создания приложения и не отключили поддержку многооконного режима, проверьте работу приложения, как описано далее, в режимах разделения экрана и произвольной формы.

  • Запустите приложение в полноэкранном режиме, а затем переключитесь в многооконный режим долгим нажатием кнопки "Обзор". Убедитесь, что приложение корректно переключается между режимами.
  • Запустите приложение непосредственно в многооконном режиме и убедитесь, что оно работает нормально. Вы можете запустить приложение в многооконном режиме, нажав кнопку "Обзор", затем длительно нажав строку заголовка приложения и перетащив ее в одну из выделенных областей на экране.
  • Измените размер окна приложения в режиме разделения экрана, перетащив линию разделения. Убедитесь, что изменение размера не приводит к сбою и что необходимые элементы интерфейса остаются видимыми.
  • Если вы указали минимальные размеры окна приложения, попытайтесь установить размер меньше минимального. Убедитесь в невозможности установить размер меньше указанного минимума.
  • Во время всех тестов следите за производительностью приложения — она должна быть приемлемой. Например, убедитесь, что после изменения размера окна приложения не возникает большой задержки обновления интерфейса.

Контрольный список тестирования

Для проверки производительности приложения в многооконном режиме выполните следующие операции. Попытайтесь выполнить их в режиме разделения экрана и в многооконном режиме, если не указано иное.

  • Перейдите в многооконный режим и выйдите из него.
  • Переключитесь из своего приложения в другое приложение и убедитесь, что приложение работает нормально, если оно видимо, но не активно. Например, если приложение показывает видео, оно должно продолжать воспроизведение, когда пользователь работает с другим приложением.
  • В режиме разделения экрана попробуйте перемещать линию разделения, увеличивая и уменьшая окно приложения. Попробуйте выполнить эти операции, когда окна двух приложений находятся рядом и друг над другом. Убедитесь, что приложение не завершается с ошибкой, необходимые элементы видны и изменение размера не занимает слишком много времени.
  • Быстро измените размер окна приложения несколько раз подряд. Убедитесь, что приложение не зависает и не вызывает утечку памяти. Информация о проверке использования памяти приложением содержится в документе Анализ использования оперативной памяти.
  • Поработайте с приложением в различных оконных конфигурациях и убедитесь, что оно ведет себя должным образом. Текст должен легко читаться, а элементы интерфейса не должны быть слишком маленькими.

Если вы отключили поддержку многооконного режима

Если вы отключили поддержку многооконного режима, установив атрибут android:resizableActivity="false", запустите приложение на устройстве с Android N и попытайтесь перевести его в режимы произвольной формы и разделения экрана. Убедитесь, что при этом приложение остается в полноэкранном режиме.