数据类型参考
数据类型参考
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。
对于每个触发器（参见每种数据类型对应的“何时发送”），使用以下字段发送正确的事件。无需筛选您发送的数据或检查是否有重复数据。亚马逊会在必要时进行该操作。
观看活动
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID（内容ID） | 是 | 客户正在观看的通过亚马逊目录集成指定内容的ID。 |
| Live Channel Descriptor（直播频道描述符） | 是* | 正在播放通过目录集成指定内容的直播线性频道的频道描述符。 *仅对直播内容为必填项。 |
| Internal Profile ID（内部个人资料ID） | 是 | 提供经过混淆处理的Profile ID（个人资料ID），以便Fire TV将活动与正确的应用客户关联。 |
| 持续时间 | 是 | 内容时间长度（以毫秒为单位）。 |
| Current Playback Position（当前播放位置） | 是 | 与内容开头的偏移量（以毫秒为单位），不包括间隙内容（预览、广告等）。 |
| Credits Position（片尾位置） | 否 | 内容中的片尾位置。与内容开头的偏移量（以毫秒为单位），不包括间隙内容（预览、广告等）。此字段可帮助Fire TV了解客户何时看完内容。 |
| Event Timestamp（事件时间戳） | 否* | *对于设备外事件，此项为必填项；但对于有效事件，则并非必填项。 |
| Playback State（播放状态） | 是 | 表示内容播放状态的枚举。要查看枚举值列表，请参阅API文档。 |
单独内容权利
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID | 是 | 对应于通过亚马逊的目录集成提供给Fire TV的内容ID。 |
| Type（类型） | 是 | 以下其中一项： Recording（录像）、Purchase（购买）或Rental（租赁）。这让Fire TV能够在用户界面中为客户正确标记内容。 |
| Expiration Date（到期日期） | 否 | 此内容权利到期时的时间戳。值小于或等于0表示没有到期。 |
| Entitlement Acquisition Date（权利获取日期） | 是 | 客户购买内容时或是剧集录制时的时间戳。如果缺少该项，则表示使用当前时间。 |
观看列表
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
| Date When Added（添加日期） | 是 | 客户将条目添加到观看列表时的时间戳 |
| Internal Profile ID | 是 | 经过混淆处理的个人资料ID，以便Fire TV将活动与正确的应用客户关联。 |
内容交互
| 字段名 | 必填项（是/否） | 描述 |
|---|---|---|
| Content ID | 是 | 对应于通过目录集成提供给Fire TV的内容ID。 |
| Interaction Date（交互日期） | 是 | 交互发生时的时间戳。 |
| Internal Profile ID | 是 | 经过混淆处理的个人资料ID，以便Fire TV将活动与正确的应用客户关联。 |
| Interaciton Type（交互类型） | 是 | 表示交互类型的枚举。要查看枚举值列表，请参阅API文档。 |
后续步骤
要查看有关触发器和SDK调用的其他便捷参考资源，请参阅我们的摘要参考表。
Last updated: 2025年9月30日
