IProgramLineupProvider
一个数据提供者对象，用于向EPG添加节目或从EPG中清除节目。
已弃用： 此接口已弃用。请改用IProgramLineupProvider2。
该提供者用于更新EPG中的节目单。可以在同一个提供者对象中多次调用upsert() 函数，将节目添加到提交队列中。调用commit() 函数时，在提供者中执行的所有操作都将保留。请注意，此接口并非线程安全。请勿出于应用于不同线程之目的为该对象创建多个实例，以免发生不确定行为。如果此对象的任一方法已出现错误，请弃用此对象并创建一个新实例。
属性
clearAllPrograms
clearAllPrograms:
() => Promise<void>
清除数据存储区中的所有节目。
移除数据存储区中的所有节目。在调用commit() 前不会保留此操作。这样操作不会清除数据存储区中的频道信息。只有当需要从电子节目指南 (EPG) 中移除已添加的节目时，才使用该函数。在同一交易中，clearAllPrograms()的函数调用必须优先于所有upsert()调用执行。
方法
upsert()
upsert(programs: IProgram
[]):Promise<void>
为EPG中的节目单更新和插入节目列表。
将节目插入到直播TV提供者数据存储区中。在调用commit()前不会保留此操作。
参数
programs
IProgram[]
要插入的节目实例数组。
抛出
- 如果在提供者使用的某一方法出现错误后继续调用该函数，则抛出
IllegalStateError。 - 如果该函数遇到不可恢复的错误（如数据存储连接问题等），则抛出InternalError。提供者在收到此错误后应中止。
- 如果该函数遇到因引入的数据超过存储限制导致的错误，则抛出
StorageLimitError。如果您遇到此错误，请咨询您的亚马逊联系人。
返回值
Promise<void>
commit()
commit(version:
string):Promise<void>
将此提供者对象的所有待处理操作提交到数据存储区。
这个函数必须在使用提供者接口中的其他方法对提供者执行操作之后才能调用。调用成功后，EpgLineupInformation.getLastCommittedProgramLineupVersion()将开始返回该版本值。
参数
version
string
一个字符串，表示将因本次提交操作而添加到数据存储区的节目单版本。
抛出
- 如果在提供者使用的某一方法出现
InternalError后继续调用该函数，则抛出IllegalStateError。 - 如果数据无法提交到数据存储区，则抛出
InternalError。
返回值
Promise<void>
Last updated: 2026年7月22日
