手順5: EPG同期タスクをスケジュールする
手順5: EPG同期タスクをスケジュールする
オープンベータ版ドキュメント:本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、
リリースノートを参照してください。
次に、EPG同期タスクを実行するようにスケジュールを設定する必要があります。大まかにまとめると、EPG同期の実行は以下のトリガーポイントの一部または全部で行います。
- アプリのインストール時。ユーザーの登録やサインインを必要としないライブコンテンツを提供する場合に実行します。
- アプリのアップデート時。アプリのアップデート時にユーザーのEPGデータを更新する必要がある場合に実行します。
- ユーザーのサインイン時、サインアウト時、定期購入プランの変更時。
- 定期的な更新。ユーザーにアプリのコンテンツの視聴権限が与えられたら、定期的なEPG更新をスケジュールして、チャンネル、番組、イベントの情報を常に最新の状態に保ちます。これらの更新はバックグラウンドで実行して、ユーザーエクスペリエンスが中断されないようにします。
EPG同期タスクを定期的に実行するようにスケジュールするには、Vega EPG同期スケジューラインターフェイスを使用します。インターフェイスを使用するときは、次の点に留意してください。
- EPG同期タスクは、スケジュールの設定時に即座に実行された後、指定の間隔で定期的に実行されます。
- 最新のスケジュールリクエストにより、以前の構成はすべて置き換えられます。
- スケジュール間隔は5~1440分の範囲で指定できます。この範囲から外れる場合は、範囲内に収められます。定期的なEPG統合タスクは、24時間ごとに実行するようにスケジュールを設定し、定期タスクを実行するたびに少なくとも48時間分の番組データを提供することを推奨します。EPG統合タスクをそれ以上実行すると、システムに不要な負荷がかかります。
- ジョブの周期を変更するには、同じ
EpgSyncTask componentIdパラメーターを使用してスケジュールAPIを呼び出します。これは、番組ラインナップが頻繁に変更される場合に、一時的にジョブの頻度を増やすために使用できます。たとえば、オリンピックなどのイベントで役立ちます。
- ジョブの実行が予定されていたときにデバイスの電源がオフになっていた場合は、デバイスの電源がオンになると実行されます。
- ジョブスケジューラは、ジョブが正確な時刻に実行されることを保証するものではありません。デバイスのリソースの利用状況により、スケジューラの動作は変動する場合があります。
- ユーザーがアプリ内のコンテンツの視聴権限を失った場合、スケジュール済みのEPG同期タスクをキャンセルするには、
cancelScheduledTasksメソッドを使用します。これは、ユーザーが定期購入をキャンセルしたときや、アプリからサインアウトしたときなど、コンテンツへのユーザーのアクセスが取り消された場合に役立ちます。
注: このシナリオでは、ChannelLineupProvider.add([])とChannelLineupProvider.commit()、LiveEventProvider.add([])とLiveEventProvider.commit()を使用して、ユーザーのライブコンテンツをシステムから消去する必要もあります。
次の手順では、さまざまなトリガーポイントでVega EPG同期スケジューラを使用する方法の例を詳しく見ていきます。
Last updated: 2025年9月30日