ILiveEventProvider
用于替换直播活动列表的数据提供者对象。
该提供者用于将所有直播活动设置/替换为一组全新的直播活动。通过使用不同直播活动列表多次调用add()函数,可创建一组新的直播活动,然后在最终调用commit()函数时,用整组新直播活动替换所有以前的直播活动。如果在调用commit()之前销毁提供者对象,则排队等待处理的所有更改都将丢失。
方法
add()
add(liveEvents: ILiveEvent
[]):Promise<IAddLiveEventFailure[]>
将直播活动列表添加到提交队列。
该函数可调用一次或多次,以添加直播活动数据。将跳过所有插入失败的直播活动,并将继续尝试插入所提供的剩余直播活动。失败直播活动列表将予以返回。插入的数据将仅在调用commit()函数时提交。
参数
liveEvents
要插入的直播活动实例数组。
抛出
- 如果在同一
LiveEventProvider之前在其一个方法中已返回错误后调用此函数,则抛出IllegalStateError。 - 如果该函数遇到不可恢复的错误(如数据存储连接问题等),则抛出InternalError。提供者在收到此错误后应中止。
- 如果该函数遇到因引入的数据超过存储限制导致的错误,则抛出StorageLimitError。如果您遇到此错误,请咨询您的亚马逊联系人。
返回值
Promise<IAddLiveEventFailure[]>
IAddLiveEventFailure[] 未能添加到提交队列的直播活动的列表以及导致失败的错误。
commit()
commit(version:
string):Promise<void>
将此提供者对象的所有待处理操作提交到数据存储区。
在使用提供者接口中的其他方法对提供者执行操作之后,应调用一次这个函数。
参数
version
string
表示将因本次提交操作而添加到数据存储区中的直播活动阵容版本的字符串。
抛出
- 如果在提供者之前已返回
InternalError后调用此函数,则抛出IllegalStateError。 - 如果数据无法提交到数据存储区,则抛出
InternalError。
返回值
Promise<void>
Last updated: 2026年7月22日

