Overview of EPG Integration

​

Prerequisites

• You are allowlisted for Live TV. Reach out to your Amazon contact to be allowlisted.
• Access to the source code of your app for Fire TV.
• A Fire TV device that supports this integration. Check with your Amazon contact for a list of device types currently supported.
• Although not mandatory, Amazon recommends that you integrate your catalog with a cloud service such as Amazon Catalog Service or Gracenote. Check with your Amazon contact for help onboarding onto these services.

​

Integration steps

1. Include the necessary package dependencies in your app.
2. Declare the EPG Sync Task in your manifest file.
3. Define your EPG Sync Task with a basic implementation of EPG Ingestion. The logic can be broken up into three parts:
   1. Channel lineup ingestion.
   2. Program lineup ingestion. The Program Lineup Ingestion is only necessary if you don’t have a cloud-based catalog, such as Amazon Catalog Service or Gracenote.
   3. Live event ingestion. Live Event Ingestion is only necessary if you offer live events.
4. Implement EPG Sync Task, following the best practices to add your EPG Ingestion logic.
5. Schedule EPG Sync Task, following the best practices.
6. Schedule repeating EPG Sync tasks on app install and updates.
7. Schedule repeating EPG Sync tasks on entitlement changes.
8. Register your task entry point with the system.
9. Enable channel tuning and playback.