Vega Live TV Issues

​

Live TV log capture

1. Start the log capture process before pushing or installing your app on the device.
2. Configure your log settings with the following.
   loggingctl config --set-rate all 60000
   
   loggingctl config --set-level all info
   
3. Reboot the device and start capturing logs.
   vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync\|kepler.script.channel"
   
4. Share the entire device_logs.txt file if you must file a bug ticket with Amazon.

​

Live TV Validator tool

​

To validate a TOML file

vega exec livetv_validator <path_to_manifest.toml>

​

To validate a VPKG file

vega exec livetv_validator <path_to_vpkg> <output_directory>

​

EPG sync task crashes due to invariant violation

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.

​

The channel doesn’t show up in the On Now row or Channel Guide

• Reach out to your Amazon contact to make sure Amazon has allowlisted you for Live TV according to the Prerequisites.
• Verify that the EPG Sync Task runs successfully.
  • Install your app on the device.
  • You should see your EPG Sync Task run within a few seconds. You can also validate by searching your app logs with the following command:
    vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    
    If successful, when you check the logs, you see the following message.
    INFO ktf.tm.nests:Successfully scheduled EPG Sync Task.
    
  • Reboot the device.
• Make sure you have enabled Channel Tuning and Playback.

​

The channel displays as a blank tile in On Now, with no image (only a channel name)

• If you haven’t integrated your channel into Gracenote, see if your software implemented the Program.thumbnailUrl(UX field list) correctly.
• If it uses Gracenote integration, see the following.

​

The channel has a Gracenote ID, but no metadata shows up in On Now or the Channel Guide

• Make sure you know if your feed is for onTV or GVD and define it correctly as an External ID. Amazon catalog supports onTV for certain marketplaces. If your Gracenote ID type doesn’t match what Amazon supports, contact your Amazon representative for details. Your contact can work with Gracenote to resolve the issue.
• Double check the Gracenote ID value. onTV uses numerical values only, but GVD is alphanumeric.

​

When I click the program tile, but my app doesn’t start.

• Check if the system correctly updated your manifest.toml file.
• Verify that the software sent the change channel request successfully.
  • You can validate by searching your app logs with the following command.
    vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    
  • If successful, when you check the logs, you see the following message.
    INFO ktf.tm.channel.client:changeChannel request successful: true
    

​

The app starts when I click the program tile, but the content doesn’t play

• Check if the software implemented the channel handler correctly.
• Verify that the software called the channel handler successfully.
  • You can validate by searching your app logs with the following command.
    vda shell loggingctl log -f | tee device_logs.txt | grep "epg:\|ktf:\|ktf.\|EpgSync"
    
  • If successful, and you are using the IChannelServerComponent2, ChannelServerComponent2 and IChannelServer2 interfaces, the system should generate the following logs.
    INFO kepler.script.channel:handleChangeChannelAsync invoked with <content id>
    

​

Related topics

• Get Started with Linear TV
• Vega Live TV API Overview
• Manage System Logs and Diagnostics with LoggingCtl