IProgramLineupProvider

一个数据提供者对象，用于向EPG添加节目或从EPG中清除节目。

已弃用

此接口已弃用。请改用{IProgramLineupProvider2}。

详情

该提供者用于更新EPG中的节目时间表。可以在同一个提供者对象中多次调用upsert() 函数，将节目添加到提交队列中。调用commit() 函数时，在提供者中执行的所有操作都将保留。请注意，此接口并非线程安全。请勿出于应用于不同线程之目的为该对象创建多个实例，以免发生不确定行为。如果此对象的任一方法已出现错误，请弃用此对象并创建一个新实例。

属性

clearAllPrograms()

clearAllPrograms: () => Promise<void>

清除数据存储区中的所有节目。

返回值

Promise<void>

详情

移除数据存储区中的所有节目。在调用commit() 前不会保留此操作。这样操作不会清除数据存储区中的频道信息。只有当需要从电子节目指南 (EPG) 中移除已添加的节目时，才使用该函数。在同一交易中，clearAllPrograms() 的函数调用必须优先于所有upsert() 调用执行。

抛出

IllegalStateError：如果在此交易中，在upsert() 之后调用clearAllPrograms()，或者如果此函数是在提供者先前已经抛出InternalError之后调用的。

抛出

InternalError：如果由于任何其他原因无法清除节目数据。

方法

commit()

commit(version): Promise<void>

将此提供者对象的所有待处理操作提交到数据存储区。

参数

version

string

一个字符串，表示将因本次提交操作而添加到数据存储区的节目时间表版本。

返回值

Promise<void>

详情

这个函数必须在使用提供者接口中的其他方法对提供者执行操作之后才能调用。调用成功后，EpgLineupInformation.getLastCommittedProgramLineupVersion() 将开始返回该版本值。

抛出

IllegalStateError：如果在提供者使用的某一方法出现InternalError后继续调用该函数。

抛出

InternalError：如果数据无法提交到数据存储区。

---

upsert()

upsert(programs): Promise<void>

为EPG中的节目时间表更新和插入节目列表。

参数

programs

IProgram[]

要插入的节目实例数组。

返回值

Promise<void>

详情

将节目插入到直播TV提供者数据存储区中。在调用commit() 前不会保留此操作。

抛出

IllegalStateError：如果在提供者使用的某一方法出现错误后继续调用该函数。

抛出

InternalError：如果该函数遇到不可恢复的错误（如数据存储区连接问题等）。提供者在收到此错误后应中止。

抛出

StorageLimitError：如果该函数遇到因引入数据超过存储限制导致的错误。如果您遇到此错误，请咨询您的亚马逊联系人。

---

Last updated: 2025年9月30日