IProgramLineupProvider

EPGに番組を追加したり、EPGから番組を消去したりするために使用するデータプロバイダーオブジェクト。

廃止

このインターフェイスは廃止されました。代わりに{IProgramLineupProvider2}を使用してください。

詳細

このプロバイダーは、EPGの番組ラインナップを更新するために使用します。同じプロバイダーオブジェクト内でupsert()関数を複数回呼び出して、コミットキューに番組を追加できます。プロバイダー内で実行したすべての操作は、commit()関数が呼び出されたときに保持されます。このインターフェイスはスレッドセーフではないことに注意してください。非決定的な動作を避けるため、このオブジェクトの複数のインスタンスを作成して異なるスレッドで使用しないでください。このオブジェクトのいずれかのメソッドでエラーがスローされた場合は、このオブジェクトを破棄して新しいインスタンスを作成してください。

プロパティ

clearAllPrograms()

clearAllPrograms: () => Promise<void>

データストアからすべての番組を消去します。

戻り値

Promise<void>

詳細

データストアからすべての番組を削除します。このアクションは、commit()が呼び出されるまで永続化されません。これによってデータストアからチャンネル情報が消去されることはありません。この機能は、追加した番組を電子番組表（EPG）から削除する必要がある場合にのみ使用してください。clearAllPrograms()の関数呼び出しは、同じトランザクション内でupsert()を最初に呼び出す前に実行する必要があります。

スロー

このトランザクション内でupsert()の後にclearAllPrograms()を呼び出した場合、またはプロバイダーからInternalErrorがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。

スロー

その他の理由で番組データを消去できない場合、InternalErrorがスローされます。

メソッド

commit()

commit(version): Promise<void>

保留中のすべての操作をこのプロバイダーオブジェクトからデータストアにコミットします。

パラメーター

version

string

このコミットの結果としてデータストアに格納される番組ラインナップのバージョンを表す文字列。

戻り値

Promise<void>

詳細

この関数は、プロバイダーインターフェイスのほかのメソッドを使用してプロバイダーで操作を実行した後に呼び出す必要があります。この呼び出しが成功した後で、EpgLineupInformation.getLastCommittedProgramLineupVersion()がこのバージョン値を返し始めます。

スロー

プロバイダーのいずれかのメソッドからInternalErrorがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。

スロー

データをデータストアにコミットできない場合、InternalErrorがスローされます。

---

upsert()

upsert(programs): Promise<void>

EPGの番組ラインナップの番組リストをアップサートします。

パラメーター

programs

IProgram[]

挿入する番組インスタンスの配列。

戻り値

Promise<void>

詳細

ライブTVプロバイダーのデータストアに番組を挿入します。このアクションは、commit()が呼び出されるまで永続化されません。

スロー

プロバイダーのいずれかのメソッドからエラーがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。

スロー

データストア接続の問題などの回復不可能なエラーがこの関数で発生した場合、InternalErrorがスローされます。このエラーを受け取ったら、プロバイダーを中止する必要があります。

スロー

取り込んだデータがストレージ制限を超えたためにこの関数でエラーが発生した場合、StorageLimitErrorがスローされます。このエラーが発生した場合は、Amazonの担当者にお問い合わせください。

---

Last updated: 2025年9月30日