要发送的内容
对于每个触发器（参见“何时发送”），发送包含以下字段的事件。无需筛选您发送的数据或检查是否有重复数据。亚马逊会在必要时进行该操作。事件类型详情
提供了两种类型的播放事件：addPlaybackEvent function: Active和Off-Device。
Active（有效）事件在同一台设备上实时发生。例如，当客户在其Fire TV上播放您的应用中的某个作品时。只有当前在设备上发生事件时，才将该事件标记为Active。播放事件上的时间戳字段不用于有效事件，因为系统会在报告事件时捕获时间戳。
Off-Device（设备外）事件用于在另一个时间、另一台设备上发生的播放。这主要用于捕获最新的客户观看进度，以便Fire TV用户界面反映客户在不同设备上的最新互动数据。Fire TV的设备端服务会定期请求此类数据。此类事件需要时间戳。
如果您在有效播放之外发送播放事件，即使在同一台Fire TV设备上，也要将其标记为Off-Device，并提供事件发生时的精确时间戳。不要筛选掉同一设备上的非有效事件。亚马逊将删除重复的有效事件。
何时发送
当以下触发器发生时，发送事件信息：- 播放状态更改时：开始、停止、暂停或退出。
- 寻找新的播放位置时。
- 在播放器中每60秒发生一次，无论播放状态如何。
- 对于在其他类型的设备上发生的活动：
- Fire TV的设备端服务将定期唤醒并要求您的应用同步此类数据。这涉及一个参数，该参数会指示应共享数据的时间段。可以不发送在该时间段内发生的每个播放事件，而是发送播放退出事件，为我们提供相关内容及其上次观看的进度。
- 在Fire TV设备上处于前台时。让您的应用同步来自您的服务的此类数据，并将最新观看进度发送给我们。
发送方式
在用户与您的应用交互时，使用以下示例代码发送观看活动事件：客户体验验证
为何时发送下的每个项目实现SDK调用后，执行以下操作并验证结果。设置您的设备
- 设置并注册您的Fire TV设备。
- 应用内容应与Fire TV进行目录集成。
- 将启用Vega内容个性化功能的应用安装到设备上，然后启动该应用。
-
您必须为此账户同意Continue Watching功能。为此，请按照以下说明操作：
- 前往Settings（设置）> Preferences（首选项）> Privacy Settings（隐私设置）> Manage Sharing from Apps（管理来自应用的共享内容）> Share App Viewing and Content Info（共享应用查看权限和内容信息）> Turn On（开启）
- 前往Settings > Preferences > Privacy Settings > Manage Sharing from Apps > Sync Across Devices（跨设备同步）> Turn On
验证Continue Watching行中的内容更新
在视频播放期间，您的应用必须定期报告观看活动事件。用户开始观看内容后，系统会将该内容添加到Continue Watching（继续观看）行。- 在您的应用中，打开视频并播放。观看或滚动浏览视频，至少达到2%的进度。
- 单击停止或返回钮停止视频播放。
-
检查日志以验证是否已成功报告播放事件。如果成功报告，您将看到以下日志行。
- 使用遥控器，或通过退出应用或单击主页按钮，返回主屏幕。
- 您应该会看到更新后的Continue Watching行。您观看的视频应该正在播放。如果是，则表示工作正常。
- 如果Continue Watching行未更新，请从Home选项卡导航到任何其他选项卡，然后再次返回Home选项卡。
-
您还可以执行以下操作，从Continue Watching行中移除图块：
- 将鼠标悬停在图块上 > 单击遥控器上的菜单按钮 > 从Continue Watching中选择Remove（移除）。您可以通过这种方式，对相同的内容进行测试。
验证内容是否已从Continue Watching行中移除
在视频播放期间，您的应用必须定期报告观看活动事件，并在播放完成或中断时进行报告。如果当前播放位置接近总时间长度，则表示用户已完成视频的观看，系统将从Continue Watching行中移除该内容。- 打开您的应用，开始观看已在Continue Watching行中列出的内容的视频。
- 通过搜索视频的末尾或反复单击遥控器上的快进 (») 滚动按钮来转到视频的末尾。
-
检查日志以验证是否成功报告了播放停止事件。如果成功报告，您的日志将具有与以下所示类似的内容。
- 返回Home选项卡。
- Continue Watching行不应再显示内容。
- 如果Continue Watching行未更新，请从Home选项卡导航到任何其他选项卡，然后返回到Home选项卡以触发用户界面刷新。
验证场景
按照下面相关步骤在Continue Watching行中添加或移除图块。验证每个场景。故障排除
以下列出了您在集成过程中可能会遇到的一些常见问题：亚马逊内容ID不正确
确认您在SDK集成中使用的亚马逊内容ID与您在目录中使用的ID完全匹配至关重要。SDK日志不包含内容ID。因此，在开发过程中，可以考虑在您的应用中添加包含ID的调试日志。使用此日志来验证您是否在发送预期的内容ID。有关目录集成的详细信息，请参阅EMBER目录集成概述。不正确地报告播放事件
每个播放事件都必须准确地表示状态。Continue Watching行的构造依赖于应用报告的准确数据。以下列出了一些需要避免的行为，以及一些应做事项：
有关何时发送事件的更多详细信息，请查看何时发送。
