Vega直播TV的问题

直播TV日志捕获

要调试问题，或向亚马逊报告错误，请使用以下机制捕获日志。

1. 在将应用推送或安装到设备上之前，启动日志捕获进程。
2. 按照以下内容配置您的日志设置。

   复制代码 已复制到剪贴板。

    loggingctl config --set-rate all 60000
   

   复制代码 已复制到剪贴板。

    loggingctl config --set-level all info
   

3. 重启设备并开始捕获日志。

   复制代码 已复制到剪贴板。

    vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync\|kepler.script.channel"
   

4. 如果您需要向亚马逊提交错误工单，请提供完整的device_logs.txt文件。

直播TV验证器工具

直播TV验证器工具旨在评估您的直播TV集成。此工具可以验证您的清单文件或VPKG，从而对您的实现情况进行高级检查。它为验证基本合规性并识别直播TV集成中的潜在问题提供了一种便捷方法。

验证TOML文件

vega exec livetv_validator <manifest.toml的路径>

验证VPKG文件

vega exec livetv_validator <vpkg路径> <输出目录>

由于违反不变量条件，EPG同步任务崩溃

您的EPG同步任务可能会由于与以下类似的错误而崩溃。

复制代码 已复制到剪贴板。

Invariant Violation: TurboModuleRegistry.getEnforcing(...): 'DeviceInfo' could not be found.Verify that a module by this name is registered in the native binary., js engine: hermes.

有关故障排除指南，请参阅Vega无头任务和服务。

该频道未显示在“当前热映”行或“频道指南”中

• 联系您的亚马逊联系人，确保亚马逊已根据先决条件将您加入直播TV许可名单。

• 确认EPG同步任务成功运行。

  1. 将您的应用安装到设备上
  2. 您应该在几秒钟内看到自己的EPG同步任务运行。您还可以通过使用以下命令搜索应用日志来进行验证：

     复制代码 已复制到剪贴板。

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
     

     如果成功，当您检查日志时，会看到以下消息。

     复制代码 已复制到剪贴板。

      INFO ktf.tm.nests:Successfully scheduled EPG Sync Task.
     

  3. 重新启动设备。
• 确保已启用频道调谐和播放。

频道在“当前热映”行中显示为没有图像的空白磁贴（仅显示频道名称）

• 如果您尚未将频道集成到Gracenote中，请查看您的软件是否正确实现了Program.thumbnailUrl(UX field list)。
• 如果已集成Gracenote，请参阅以下信息。

频道具有Gracenote ID，但On Now行或Channel Guide中没有显示元数据

• 确保您清楚自己的源支持onTV还是GVD，并正确地将这一点定义为外部ID。Amazon Catalog在某些市场支持onTV。如果亚马逊支持的内容和您拥有的Gracenote ID类型不匹配，请联系您的亚马逊联系人了解详情。他们应该与Gracenote合作来纠正这个问题。
• 重复检查Gracenote ID值。onTV仅使用数字值，而GVD使用字母数字。

单击节目磁贴后，我的应用无法启动。

• 检查系统是否正确更新了manifest.toml文件。
• 验证软件是否成功发送了更改频道请求。
  • 您可以通过使用以下命令搜索应用日志来进行验证。

    复制代码 已复制到剪贴板。

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    

  • 如果成功，当您检查日志时，会看到以下消息。

    复制代码 已复制到剪贴板。

    INFO ktf.tm.channel.client:changeChannel request successful: true
    

单击节目磁贴后，应用可以启动，但没有播放相关内容

• 检查软件是否正确实现了频道处理器。
• 验证软件是否成功调用了频道处理程序。
  • 您可以通过使用以下命令搜索应用日志来进行验证。

    复制代码 已复制到剪贴板。

      vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    

  • 如果成功，并且您使用的是IChannelServerComponent2、ChannelServerComponent2和IChannelServer2接口，系统将生成以下日志。

    复制代码 已复制到剪贴板。

    INFO kepler.script.channel:handleChangeChannelAsync invoked with <内容ID> 
    

相关主题

• 开始使用线性电视
• Vega直播TV API概述
• 使用LoggingCtl管理系统日志和诊断

Last updated: 2026年2月24日