Android TV端Kiosk模式配置失败求助（手机端正常）

针对你的代码在Android手机正常但TV上无效的问题，以下是针对性的修复方案：

• 适配Android TV的Home Intent Filter
  Android TV的启动逻辑和手机不同，默认Home应用需要适配LEANBACK_LAUNCHER类别，修改setupAutoStart中的IntentFilter：

  private fun setupAutoStart() {
      val intentFilter = IntentFilter(Intent.ACTION_MAIN)
      intentFilter.addCategory(Intent.CATEGORY_HOME)
      intentFilter.addCategory(Intent.CATEGORY_DEFAULT)
      // 添加Android TV专属的Leanback类别
      intentFilter.addCategory(Intent.CATEGORY_LEANBACK_LAUNCHER)
      policyManager.addPersistentPreferredActivity(
          adminComponentName,
          intentFilter, ComponentName(packageName, KioskActivity::class.java.name)
      )
      // Android TV通常没有锁屏，可添加设备判断避免无效调用
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !isTvDevice()) {
          policyManager.setKeyguardDisabled(adminComponentName, true)
      }
  }
  
  // 辅助方法判断是否为TV设备
  private fun isTvDevice(): Boolean {
      return packageManager.hasSystemFeature(PackageManager.FEATURE_LEANBACK)
  }
  

• 修正Lock Task允许的包名（TV版应用包名差异）
  你添加的部分应用在Android TV上的包名和手机版不同，比如YouTube TV版包名是com.google.android.youtube.tv，而非手机版的com.google.android.youtube。如果包名不存在，会导致Lock Task配置失效，建议只保留TV上存在的应用包名：

  policyManager.setLockTaskPackages(
      adminComponentName,
      arrayOf(
          packageName,
          "com.google.android.youtube.tv" // 替换为TV版YouTube包名
          // 移除TV上不存在的应用，如Facebook、WhatsApp等
      )
  )
  

• 确认设备所有者配置正确
  Android TV上设置设备所有者的流程和手机一致，但需确保通过ADB命令正确设置：

  dpm set-device-owner com.your.package/.YourDeviceAdminReceiver
  

  在代码中添加日志验证policyManager.isDeviceOwnerApp(packageName)的返回值，如果为false，后续配置都不会执行，直接调用startLockTask()在TV上会被系统拒绝。

• 调整startLockTask()的调用时机
  Android TV的Activity生命周期可能存在延迟，在onResume直接调用startLockTask()可能时机过早，建议在Activity获取焦点后调用：

  override fun onWindowFocusChanged(hasFocus: Boolean) {
      super.onWindowFocusChanged(hasFocus)
      if (hasFocus && policyManager.isDeviceOwnerApp(packageName)) {
          startLockTask()
      }
  }
  

  同时移除setupKiosk()末尾的直接调用，避免重复触发。

• Manifest添加TV适配配置
  确保你的KioskActivity在Manifest中声明TV相关属性，并且应用包含Leanback特性：

  <uses-feature
      android:name="android.software.leanback"
      android:required="true" />
  
  <activity
      android:name=".KioskActivity"
      android:launchMode="singleTask"
      android:screenOrientation="landscape">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.HOME" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
      </intent-filter>
  </activity>
  

• 验证Lock Task模式的系统限制
  Android TV上的Lock Task模式可能有额外限制，比如不允许退出的条件更严格，需确保你的应用已被正确添加到允许列表，并且设备所有者权限完全生效。

内容的提问来源于stack exchange，提问作者Argam Mehrabyan