Android Management API管理的KIOSK模式平板屏幕自动熄灭问题咨询

大家好，我目前用Android Management API管理着大概500台配置成KIOSK模式的平板，最近发现这些平板会自动熄灭屏幕，影响日常使用。我当前的策略配置代码片段如下：

val categories: MutableList<String> = ArrayList()
categories.add("android.intent.category.HOME")
categories.add("android.intent.category.DEFAULT")
return Policy()
    .setApplications(
        Collections.singletonList(
            ApplicationPolicy()
                .setPackageName(MY_APP_NAME)
                // 原代码后续内容未完整给出
        )
    )

想请教下各位同行，该怎么修改这个策略配置，才能让KIOSK模式下的平板保持屏幕常亮，避免自动熄灭呢？

可行解决方案 #

要解决屏幕自动熄灭的问题，你需要在现有Policy中补充屏幕唤醒与锁屏控制的相关配置，具体可以从以下两个层面入手：

• 全局设备策略配置
  在Policy构建时添加DevicePolicy配置，禁用锁屏并设置插电时保持屏幕常亮：

  return Policy()
      .setApplications(...) // 保留你原有的应用列表配置
      .setDevicePolicy(
          DevicePolicy()
              // 禁用系统锁屏，防止屏幕锁定
              .setKeyguardDisabled(true)
              // 设置插电时（AC/USB）保持屏幕常亮
              .setStayOnWhilePluggedIn(StayOnWhilePluggedIn.STAY_ON_WHILE_PLUGGED_IN_AC or StayOnWhilePluggedIn.STAY_ON_WHILE_PLUGGED_IN_USB)
      )
  

• KIOSK应用专属配置
  确保你的KIOSK应用拥有必要的权限，同时配置为持久化默认主页：

  ApplicationPolicy()
      .setPackageName(MY_APP_NAME)
      // 允许应用进入锁屏任务模式（KIOSK模式必备）
      .setLockTaskAllowed(true)
      // 授予应用唤醒锁权限，用于保持屏幕唤醒
      .setPermissions(Collections.singletonList("android.permission.WAKE_LOCK"))
      // 设置应用为持久化默认主页，确保始终处于前台
      .setPersistentPreferredActivity(
          PersistentPreferredActivity()
              .setIntentFilters(Collections.singletonList(
                  IntentFilter()
                      .setActions(Collections.singletonList("android.intent.action.MAIN"))
                      .setCategories(categories)
              ))
      )
  

额外提示 #

如果你的平板需要在未插电状态下也保持屏幕常亮，仅靠Android Management API的配置是不够的，还需要在KIOSK应用的代码中主动获取唤醒锁：

// 在应用中初始化PowerManager
val powerManager = getSystemService(Context.POWER_SERVICE) as PowerManager
val wakeLock = powerManager.newWakeLock(PowerManager.SCREEN_BRIGHT_WAKE_LOCK, "MyApp::KioskWakeLock")
// 在应用启动时获取唤醒锁
wakeLock.acquire()
// 注意：在应用退出时记得释放唤醒锁，避免过度耗电

最后，修改完策略后，记得同步更新到所有设备，可通过Android Management API的设备管理界面确认策略是否成功应用。

备注：内容来源于stack exchange，提问作者March3April4