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文件

kepler exec livetv_validator <manifest.toml的路径>

验证VPKG文件

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

由于不变量违规，EPG同步任务崩溃

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

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

E Volta:[KeplerScript-JavaScript] 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无头任务和服务。

频道没有显示在On Now行或Channel Guide中

• 请联系您的亚马逊联系人，确认您已加入直播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. 重新启动设备。
• 确保已启用频道调谐和播放。

频道在On Now行中显示为没有图像的空白磁贴（仅显示频道名称）

• 如果频道未集成Gracenote，请检查Program.thumbnailUrl（用户体验字段列表）是否正确。
• 如果已集成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"
    

  • 如果成功，并且您使用的是IChannelSeverComponent2、ChannelServerComponent2和IChannelServer2接口，您将看到以下日志。

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

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

相关主题

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

Last updated: 2025年9月30日