as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support

Step 5: Schedule EPG Sync Task

Next, you need to schedule your EPG sync task to run. At a high-level, you want your EPG sync task to run at some or all of these trigger points:

  1. On app install. If you offer live content without requiring customer registration or sign-in.
  2. On app updates. If you need to update the customer's EPG data when your app is updated.
  3. On customer sign-in, sign-out, or changes to subscription plans.
  4. Periodic updates. Once the customer is entitled to watch content in your app, you will schedule regular EPG updates so the channel, program, and event information remains current. These updates run in the background to avoid disrupting the user's experience.

You will use the Vega EPG Sync Scheduler interface to schedule your EPG sync task to run periodically. Here are some things to keep in mind when using the interface:

  1. The EPG sync task executes immediately upon scheduling, followed by your specified periodic intervals.
  2. The most recent scheduling request supersedes all previous configurations.
  3. The schedule interval has a range of 5 through 1440 minutes. Anything outside this range is capped. We recommend scheduling your periodic EPG ingestion task to run every 24 hours and provide at least 48 hours worth of program data in each run of your periodic tasks. Running the EPG ingestion task more than that puts unnecessary stress on the system.
  4. You can change the periodicity of your job by calling the schedule API with the same EpgSyncTask componentId parameter. This can be useful to temporarily increase the frequency of your job in case of frequent program lineup changes. For example, an event like the Olympics.
  5. If the device was off when your job was scheduled to run, it will run when the device is turned on.
  6. The job scheduler does not guarantee that the job runs at exact times. The scheduler may include variations due to device resource availability.
  7. The cancelScheduledTasks method is used to cancel scheduled EPG sync tasks if the customer is no longer entitled to watch entitled content in your app. This can be useful if the customer’s content access is revoked, such as when they cancel their subscription or sign-out of your app.

Next, we will dive into examples of how to use Vega EPG Sync Scheduler at various trigger points.


Last updated: Sep 30, 2025