Android TV Home中Watch Next行不显示应用程序的问题排查

代码层面可能的遗漏 #

• 权限缺失：确保AndroidManifest.xml中添加了写入Watch Next的权限：

  <uses-permission android:name="com.android.providers.tv.permission.WRITE_WATCH_NEXT_PROGRAMS" />
  

• 插入Uri错误：应该使用WatchNextPrograms.CONTENT_URI而非Programs.CONTENT_URI，正确的插入代码应为：

  Uri watchNextProgramUri = context.getContentResolver().insert(WatchNextPrograms.CONTENT_URI, content);
  

• 缺少封面/缩略图字段：Android TV的Watch Next行要求必须提供封面图，需添加以下字段：

  content.put(PreviewPrograms.COLUMN_POSTER_ART_URI, "content://your_app/path/to/poster");
  // 或缩略图字段
  content.put(PreviewPrograms.COLUMN_THUMBNAIL_URI, "content://your_app/path/to/thumbnail");
  

• 时间字段格式错误：LAST_ENGAGEMENT_TIME_UTC_MILLIS必须传入UTC时间戳，如果用本地时间会导致系统无法正确排序或识别，可直接使用System.currentTimeMillis()获取标准UTC时间戳。
• IntentUri无效：确保IntentUri是通过Intent.toUri(Intent.URI_INTENT_SCHEME)生成的有效Uri，且应用能正确处理该Intent。系统会验证Intent的有效性，无效条目会被过滤。

设备设置层面的排查 #

• 确认第三方内容展示权限：从你的截图看已开启Play Next，但需进入Android TV设置 → 主屏幕 → 确认「显示来自所有应用的内容」选项已开启。
• 刷新Android TV Home缓存：进入设置 → 应用 → 找到「Android TV Home」→ 清除缓存和数据 → 重启设备，强制系统重新加载Watch Next数据。
• 解除应用后台限制：确保你的应用没有被设置为电池优化或后台限制，进入设置 → 应用 → 你的应用 → 电池 → 选择「不优化」；同时确认应用的通知权限已开启（部分设备依赖此判断应用活跃度）。

内容的提问来源于stack exchange，提问作者Howard Chou