IProgramLineupProvider2
コミットの部分的な成功をサポートし、コミットできない番組に対してエラーフィードバックを提供するIProgramLineupProviderの更新済みインターフェイス。
詳細
このプロバイダーは、EPGの番組ラインナップを更新するために使用します。同じプロバイダーオブジェクト内でupsert()関数を複数回呼び出して、コミットキューに番組を追加できます。プロバイダー内で実行したすべての操作は、commit()関数が呼び出されたときに保持されます。このインターフェイスはスレッドセーフではないことに注意してください。非決定的な動作を避けるため、このオブジェクトの複数のインスタンスを作成して異なるスレッドで使用しないでください。このオブジェクトのいずれかのメソッドでエラーがスローされた場合は、このオブジェクトを破棄して新しいインスタンスを作成してください。
プロパティ
clearAllPrograms()
clearAllPrograms: () =>
Promise<void>
データストアからすべての番組を消去します。
戻り値
Promise<void>
詳細
データストアからすべての番組を削除します。このアクションは、commit()が呼び出されるまで永続化されません。これによってデータストアからチャンネル情報が消去されることはありません。この機能は、追加した番組を電子番組表（EPG）から削除する必要がある場合にのみ使用してください。clearAllPrograms()の関数呼び出しは、同じトランザクション内でupsert()を最初に呼び出す前に実行する必要があります。
スロー
このトランザクション内でupsert()の後にclearAllPrograms()を呼び出した場合、またはプロバイダーからInternalErrorがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。
スロー
その他の理由で番組データを消去できない場合、InternalErrorがスローされます。
メソッド
commit()
commit(
version):Promise<void>
IUpsertProgramFailureにならなかった保留中の操作をすべてデータストアにコミットします。
パラメーター
version
string
このコミットの結果としてデータストアに格納される番組ラインナップのバージョンを表す文字列。
戻り値
Promise<void>
詳細
この関数は、プロバイダーインターフェイスのほかのメソッドを使用してプロバイダーで操作を実行した後に呼び出す必要があります。この呼び出しが成功した後で、EpgLineupInformation.getLastCommittedProgramLineupVersion()がこのバージョン値を返し始めます。
スロー
プロバイダーのいずれかのメソッドからInternalErrorがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。
スロー
データをデータストアにコミットできない場合、InternalErrorがスローされます。
upsert()
upsert(
programs):Promise<IUpsertProgramFailure[]>
EPGの番組ラインナップの番組リストをアップサートします。挿入できなかった番組はすべてスキップし、提供された残りの番組の挿入を続行します。
パラメーター
programs
IProgram[]
挿入する番組インスタンスの配列。
戻り値
Promise<IUpsertProgramFailure[]>
IUpsertProgramFailure*[]、コミットキューに追加できなかった番組と失敗の原因となったエラーのリスト。すべての番組がコミットキューに正常に追加された場合は、空のリストが返されます。
詳細
ライブTVプロバイダーのデータストアに番組を挿入します。このアクションは、commit()が呼び出されるまで永続化されません。
スロー
プロバイダーのいずれかのメソッドからエラーがスローされた後にこの関数を呼び出した場合、IllegalStateErrorがスローされます。
スロー
その他の理由でデータをコミットキューに追加できない場合、InternalErrorがスローされます。
スロー
取り込んだデータがストレージ制限を超えたためにこの関数でエラーが発生した場合、StorageLimitErrorがスローされます。このエラーが発生した場合は、Amazonの担当者にお問い合わせください。
Last updated: 2025年9月30日
