@amazon-devices/kepler-epg-sync-scheduler
The Kepler EPG Sync Scheduler API provides functionality for scheduling Electronic Program Guide (EPG) synchronization tasks in React Nattive for Kepler apps.. It offers flexible scheduling options with both interval-based and time-window-based execution.
Remarks
The Kepler EPG Sync Scheduler allows you to:
- Schedule periodic EPG sync tasks at regular intervals
- Schedule EPG sync tasks within specific time windows (for example, between 2AM-4AM UTC)
- Cancel existing scheduled tasks
Important Notes
- Only one EPG sync task can be scheduled at any point in time
- The most recent scheduling call will override any previous scheduling
- Scheduled tasks persist across device reboots
- All time-based scheduling uses UTC time
- Builder instances can only be used once and cannot be reused after calling
build()
- Interval scheduling accepts values between 5 and 1440 minutes (1 day)
- Execution window scheduling requires a minimum window of 60 minutes (1 hour)
Error Handling
All scheduling operations are asynchronous and may throw InternalError
exceptions. Always wrap scheduling calls in try-catch blocks or handle Promise rejections appropriately.
The builder pattern used for time properties may throw InvalidArgumentError
for invalid parameters or IllegalStateError
if attempting to reuse a builder instance.
Related topics
For detailed integration steps, see Overview of EPG Integration.
Modules
Last updated: Sep 30, 2025