观看列表
观看列表
这适用于在客户的观看列表中添加和删除内容。Fire TV可能会使用观看列表信息来更新客户的通用观看列表。
要发送的内容
如果触发器是应用安装和登录,或者Fire TV的设备端服务要求刷新,则为所有观看列表项目提供action=add
。否则,仅发送已添加和已删除的项目。触发后,发送所有数据。亚马逊会处理重复内容,因此无需自行过滤掉这些内容。
字段名 | 必填项(是/否) | 描述 |
---|---|---|
Content ID(内容ID) | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
Activity Date(活动日期) | 是 | 客户添加或删除权利时的时间戳。 |
List Action(列出操作) | 是 | ADDED (已添加)或REMOVED (移除)。 |
Internal Profile ID(内部个人资料ID) | 是 | 提供经过混淆处理的Profile ID(个人资料ID),以便Fire TV将活动与正确的应用客户关联。 |
何时发送
- 初次安装和登录应用时。
- 客户的观看列表中添加或删除项目时。此操作可以在设备外发生。
- Fire TV的设备端服务要求刷新时。
- 切换到新的个人资料时。
发送方式
要共享客户添加到观看列表的最新作品,请使用以下代码:
AmazonCustomerListReceiver listReceiver = AmazonCustomerListReceiver.getInstance(getContext());
AmazonCustomerListEntry listEntry = AmazonCustomerListEntry.builder()
.contentId(AmazonContentId.builder()
.id("contentId")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
.addedTimestampMs(System.currentTimeMillis())
.profileId(AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build())
.build();
listReceiver.addCustomerListEntry(AmazonCustomerListType.WATCHLIST, listEntry);
val listReceiver: AmazonCustomerListReceiver = AmazonCustomerListReceiver.getInstance(context)
val listEntries: List<AmazonCustomerListEntry> = ArrayList()
val listEntry: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
.contentId(
AmazonContentId.builder()
.id("contentId")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
)
.addedTimestampMs(System.currentTimeMillis())
.profileId(
AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build()
)
.build()
listEntries.add(listEntry)
val listEntry2: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
.contentId(
AmazonContentId.builder()
.id("contentId2")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
)
.addedTimestampMs(System.currentTimeMillis())
.profileId(
AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build()
)
.build()
listEntries.add(listEntry2)
listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries)
发送客户的完整观看列表
以下示例代码展示了如何发送客户的完整观看列表。
AmazonCustomerListReceiver listReceiver = AmazonCustomerListReceiver.getInstance(getContext()); List<AmazonCustomerListEntry> listEntries = new ArrayList<>();
AmazonCustomerListEntry listEntry = AmazonCustomerListEntry.builder()
.contentId(AmazonContentId.builder()
.id("contentId")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
.addedTimestampMs(System.currentTimeMillis())
.profileId(AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build())
.build();
listEntries.add(listEntry);
AmazonCustomerListEntry listEntry2 = AmazonCustomerListEntry.builder()
.contentId(AmazonContentId.builder()
.id("contentId2")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build())
.addedTimestampMs(System.currentTimeMillis())
.profileId(AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build())
.build();
listEntries.add(listEntry2);
listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries);
val listReceiver: AmazonCustomerListReceiver = AmazonCustomerListReceiver.getInstance(context)
val listEntries: List<AmazonCustomerListEntry> = ArrayList()
val listEntry: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
.contentId(
AmazonContentId.builder()
.id("contentId")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
)
.addedTimestampMs(System.currentTimeMillis())
.profileId(
AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build()
)
.build()
listEntries.add(listEntry)
val listEntry2: AmazonCustomerListEntry = AmazonCustomerListEntry.builder()
.contentId(
AmazonContentId.builder()
.id("contentId2")
.namespace(AmazonContentId.NAMESPACE_CDF_ID).build()
)
.addedTimestampMs(System.currentTimeMillis())
.profileId(
AmazonProfileId.builder()
.id("myProfileId1")
.namespace(AmazonProfileId.NAMESPACE_APP_INTERNAL)
.build()
)
.build()
listEntries.add(listEntry2)
listReceiver.setCustomerList(AmazonCustomerListType.WATCHLIST, listEntries)
后续步骤
我们的数据类型参考是可供您便捷查阅的数据类型参考资源。
Last updated: 2023年11月29日