Заблокировать режим задачи

В этом руководстве разработчика объясняется, как можно привязать выделенные устройства к одному приложению или набору приложений. Если вы являетесь разработчиком или интегратором решений для управления мобильностью предприятия (EMM), прочтите это руководство, чтобы добавить режим задачи блокировки в свое решение.

Обзор

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

Только приложения, которые были внесены в список разрешенных контроллером политики устройств (DPC), могут запускаться, когда система находится в режиме блокировки задач. Приложения занесены в список разрешенных, поскольку человек, использующий устройство, не всегда может выйти из режима блокировки задач.

Способ объединения приложения, внесенного в список разрешенных для режима блокировки задач, и DPC из белого списка будет зависеть от проблемы, которую вы хотите решить. Вот несколько примеров:

• Единый пакет приложения, который сочетает в себе киоск (для представления контента) и мини-ЦОД (для внесения себя в список разрешенных для режима блокировки задач).
• ЦОД, являющийся частью решения по управлению мобильностью предприятия, запускающий мобильные приложения клиента в режиме блокировки задач.

Доступность

Система может работать в режиме блокировки задач в Android 5.0 или более поздней версии. В таблице 1 показано, какие версии Android поддерживают внесение приложений в белый список по пользователям.

В Android 9.0 и более поздних версиях ЦОД может запускать любое действие приложения в режиме блокировки задач. В более ранних версиях приложение уже должно поддерживать запуск собственного действия в режиме блокировки задач.

Приложения из белого списка

ЦОД должен внести приложения в список разрешенных, прежде чем их можно будет использовать в режиме блокировки задач. Вызовите DevicePolicyManager.setLockTaskPackages() чтобы добавить приложения в список разрешенных для режима блокировки задач, как показано в следующем примере:

// Allowlist two apps.
private val KIOSK_PACKAGE = "com.example.kiosk"
private val PLAYER_PACKAGE = "com.example.player"
private val APP_PACKAGES = arrayOf(KIOSK_PACKAGE, PLAYER_PACKAGE)

// ...

val context = context
val dpm = context.getSystemService(Context.DEVICE_POLICY_SERVICE)
        as DevicePolicyManager
val adminName = getComponentName(context)
dpm.setLockTaskPackages(adminName, APP_PACKAGES)

// Allowlist two apps.
private static final String KIOSK_PACKAGE = "com.example.kiosk";
private static final String PLAYER_PACKAGE = "com.example.player";
private static final String[] APP_PACKAGES = {KIOSK_PACKAGE, PLAYER_PACKAGE};

// ...

Context context = getContext();
DevicePolicyManager dpm =
    (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
ComponentName adminName = getComponentName(context);
dpm.setLockTaskPackages(adminName, APP_PACKAGES);

Чтобы узнать, какие приложения ранее были внесены в список разрешенных для режима блокировки задач, ЦОД может вызвать DevicePolicyManager.getLockTaskPackages() . Другие приложения могут вызвать DevicePolicyManager.isLockTaskPermitted() чтобы подтвердить, что пакет приложения поддерживает режим задачи блокировки.

Запустить режим блокировки задач

В Android 9.0 (уровень API 28) или выше вы можете запустить активность другого приложения в режиме блокировки задач. Если действие уже выполняется на переднем плане или в фоновом режиме, вам необходимо перезапустить его. Вызовите ActivityOptions.setLockTaskEnabled() и укажите эти параметры при запуске действия. В следующем фрагменте показан один из способов сделать это:

// Set an option to turn on lock task mode when starting the activity.
val options = ActivityOptions.makeBasic()
options.setLockTaskEnabled(true)

// Start our kiosk app's main activity with our lock task mode option.
val packageManager = context.packageManager
val launchIntent = packageManager.getLaunchIntentForPackage(KIOSK_PACKAGE)
if (launchIntent != null) {
    context.startActivity(launchIntent, options.toBundle())
}

// Set an option to turn on lock task mode when starting the activity.
ActivityOptions options = ActivityOptions.makeBasic();
options.setLockTaskEnabled(true);

// Start our kiosk app's main activity with our lock task mode option.
PackageManager packageManager = context.getPackageManager();
Intent launchIntent = packageManager.getLaunchIntentForPackage(KIOSK_PACKAGE);
if (launchIntent != null) {
  context.startActivity(launchIntent, options.toBundle());
}

В версиях Android до 9.0 приложение запускает свои собственные действия в режиме задачи блокировки, вызывая Activity.startLockTask() . Чтобы вызвать этот метод, действие должно выполняться на переднем плане (см. Концепции жизненного цикла действия ), поэтому мы предлагаем вызвать метод onResume() Activity или Fragment . Вот как вы можете вызвать startLockTask() :

// In our Fragment subclass.
override fun onResume() {
    super.onResume()
    // First, confirm that this package is allowlisted to run in lock task mode.
    if (dpm.isLockTaskPermitted(context.packageName)) {
        activity.startLockTask()
    } else {
        // Because the package isn't allowlisted, calling startLockTask() here
        // would put the activity into screen pinning mode.
    }
}

// In our Fragment subclass.
@Override
public void onResume() {
  super.onResume();

  // First, confirm that this package is allowlisted to run in lock task mode.
  if (dpm.isLockTaskPermitted(context.getPackageName())) {
    getActivity().startLockTask();
  } else {
    // Because the package isn't allowlisted, calling startLockTask() here
    // would put the activity into screen pinning mode.
  }
}

Не запускайте режим задачи блокировки, когда устройство заблокировано, поскольку пользователь не сможет разблокировать устройство. Вы можете вызвать методы KeyguardManager , чтобы узнать, заблокировано ли устройство, и использовать обратный вызов жизненного цикла Activity (например, onResume() , который вызывается после разблокировки), чтобы запустить режим задачи блокировки.

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

Альтернативно вы можете объявить в файле манифеста приложения , как должно вести себя действие, когда система работает в режиме задачи блокировки. Чтобы система автоматически запускала ваши действия в режиме задачи блокировки, установите для атрибута android:lockTaskMode значение if_whitelisted , как показано в следующем примере:

<activity
    android:name=".MainActivity"
    android:lockTaskMode="if_whitelisted">
    <!-- ... -->
</activity>

Подробнее об объявлении параметров в файле манифеста приложения можно узнать, прочитав справочник по lockTaskMode .

Остановить режим блокировки блокировки

Центр обработки данных может удаленно остановить режим задачи блокировки, удалив пакет приложения из белого списка. Вызовите DevicePolicyManager.setLockTaskPackages() в Android 6.0 (уровень API 23) или более поздней версии и опустите имя пакета из массива белого списка. При обновлении белого списка приложение возвращается к предыдущей задаче в стеке.

Если действие ранее вызывалось startLockTask() , оно может вызвать Activity.stopLockTask() чтобы остановить режим задачи блокировки. Этот метод работает только для действия, которое запустило режим блокировки задач.

Обратные вызовы жизненного цикла

Вашему ЦОД может быть полезно знать, когда приложение (работающее от того же пользователя) входит в режим блокировки задач и выходит из него. Чтобы получать обратные вызовы, переопределите следующие методы обратного вызова в подклассе DeviceAdminReceiver вашего ЦОД:

onLockTaskModeEntering()

Вызывается после того, как приложение переходит в режим блокировки задач. Вы можете получить имя пакета приложения из аргумента pkg .

onLockTaskModeExiting()

Вызывается после выхода приложения из режима блокировки задач. Этот обратный вызов не получает информацию о приложении.

Если вы запускаете другое приложение в режиме блокировки задач, вам необходимо отслеживать статус работы в вашем собственном приложении. Чтобы проверить, работает ли текущее приложение в режиме задачи блокировки, используйте методы ActivityManager , как показано в следующем примере:

// Check if this app is in lock task mode. Screen pinning doesn't count.
var isLockTaskModeRunning = false

val activityManager = context
        .getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    isLockTaskModeRunning =
            activityManager.lockTaskModeState ==
            ActivityManager.LOCK_TASK_MODE_LOCKED
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    // Deprecated in API level 23.
    isLockTaskModeRunning = activityManager.isInLockTaskMode
}

if (isLockTaskModeRunning) {
    // Show the exit button ...
}

// Check if this app is in lock task mode. Screen pinning doesn't count.
boolean isLockTaskModeRunning = false;

ActivityManager activityManager = (ActivityManager)
    getContext().getSystemService(Context.ACTIVITY_SERVICE);

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
  isLockTaskModeRunning = activityManager.getLockTaskModeState()
      == ActivityManager.LOCK_TASK_MODE_LOCKED;
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
  // Deprecated in API level 23.
  isLockTaskModeRunning = activityManager.isInLockTaskMode();
}

if (isLockTaskModeRunning) {
  // Show the exit button ...
}

Настройте пользовательский интерфейс

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

• Строка состояния пуста, уведомления и системная информация скрыты.
• Кнопки «Домой» и «Обзор» скрыты.
• Другие приложения не могут запускать новые действия.
• Экран блокировки (если установлен) отключен.

В Android 9.0 или более поздней версии, когда включен режим блокировки задач, ваш ЦОД может активировать определенные функции системного пользовательского интерфейса на устройстве, что полезно для разработчиков, создающих собственное средство запуска. Вызовите DevicePolicyManager.setLockTaskFeatures() , как показано в следующем фрагменте:

// Enable the Home and Overview buttons so that our custom launcher can respond
// using our custom activities. Implicitly disables all other features.
dpm.setLockTaskFeatures(
        adminName,
        DevicePolicyManager.LOCK_TASK_FEATURE_HOME or
              DevicePolicyManager.LOCK_TASK_FEATURE_OVERVIEW)

// Enable the Home and Overview buttons so that our custom launcher can respond
// using our custom activities. Implicitly disables all other features.
dpm.setLockTaskFeatures(adminName,
    DevicePolicyManager.LOCK_TASK_FEATURE_HOME |
          DevicePolicyManager.LOCK_TASK_FEATURE_OVERVIEW);

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

ЦОД может вызвать DevicePolicyManager.getLockTaskFeatures() чтобы получить список функций, доступных на устройстве, когда включен режим задачи блокировки. Когда устройство выходит из режима задачи блокировки, пользовательский интерфейс возвращается в состояние, предусмотренное существующими политиками устройства.

Блокировать окна и наложения

Когда приложение работает в режиме блокировки задач, другие приложения и фоновые службы могут создавать новые окна, которые Android отображает перед приложением в режиме блокировки задач. Приложения и службы создают эти окна, чтобы показывать всплывающие уведомления, диалоговые окна и наложения пользователю, использующему устройство. Ваш ЦОД может предотвратить это, добавив пользовательское ограничение DISALLOW_CREATE_WINDOWS . В следующем примере показано, как это можно сделать в обратном вызове onLockTaskModeEntering() :

// Called just after entering lock task mode.
override fun onLockTaskModeEntering(context: Context, intent: Intent) {
    val dpm = getManager(context)
    val admin = getWho(context)

    dpm.addUserRestriction(admin, UserManager.DISALLOW_CREATE_WINDOWS)
}

// Called just after entering lock task mode.
public void onLockTaskModeEntering(Context context, Intent intent) {
  DevicePolicyManager dpm = getManager(context);
  ComponentName admin = getWho(context);

  dpm.addUserRestriction(admin, UserManager.DISALLOW_CREATE_WINDOWS);
}

Ваш ЦОД может снять ограничение пользователя, когда устройство выходит из режима задачи блокировки.

Дополнительные ресурсы

Чтобы узнать больше о выделенных устройствах, прочитайте следующие документы:

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