步骤1：
设置您的账户
设置您的账户
步骤3： 在暂存环境中测试您的目录
步骤3： 在暂存环境中测试您的目录
重要须知： 目录集成仅可用于部分合作伙伴。
在将目录提交给亚马逊进行验收之前，您必须在暂存环境中对Fire TV设备上的内容集成进行全面测试。通过验证您的目录，您可以确保您的内容可被发现、显示正确，并且深层链接在所有用户场景中都能按预期运行。
先决条件
在测试您的目录之前，请务必完成以下内容：
- 您的内容类型所需的任何相关集成：
- Fire TV启动器集成 - VOD和直播活动内容所必需（支持深层链接和权利）。
- 线性电视集成 - 线性和广播内容所必需（支持电视台调谐验证）。
- 要在设备上查看您的暂存目录，请发送测试设备列表以供亚马逊添加到允许列表中。这是您在提供详细信息以设置您的账户中的账户设置的一部分。
测试场景
针对目录中的每种内容类型（VOD、直播活动和线性内容）完成以下测试场景。
| 测试类别 | 测试步骤 | 预期行为 |
|---|---|---|
| 语音搜索 |
|
您的内容标题出现在搜索结果中。 注意： 您可能需要滚动浏览一行中的标题或滚动多行，才能在搜索结果中找到您的内容标题。 |
| 详情页面报价 |
|
|
| 授权用户的深层链接 |
|
内容开始在您的应用中播放。 注意： 在开始播放内容之前，用户可能需要在应用内选取器屏幕上选择配置文件。 |
作为目录验收流程的一部分，您必须记录测试结果。有关详细说明，请参阅步骤4： 通过亚马逊对目录的验收。
故障排除指南
如果您在测试期间遇到问题，请查看以下解决方案。
问题： 内容未出现在搜索结果中
症状
当您搜索内容时，它不会出现在搜索结果中。此问题可能由于以下任何原因而发生：
- 目录文件缺失或存在不完整的搜索元数据。
- 您使用的搜索短语与目录标题不匹配。
- 内容尚未正确编入索引以供搜索。
试试这个
- 验证您的目录文件包含所有必需的搜索元数据字段和图像。检查标题、描述和关键字字段。
- 尝试使用其他标题变体进行搜索。
- 等待八个小时以完成搜索索引。
问题： 您的报价未显示在详情页面上
症状
当您导航到内容详情页面时，您的报价不会出现。如果目录文件缺少报价数据或报价数据不正确，例如权利信息不完整或可用性时段不正确，则可能会出现此问题。
试试这个
- 验证您提交的目录中是否包含带权利信息的报价数据。
- 验证报价对象结构是否与架构相匹配。
- 确认可用日期是最新的。
问题： 深层链接会打开浏览器而不是应用
症状
当您选择深层链接时，内容将在浏览器中打开，而不是在您的应用中打开。此问题可能由于以下任何原因而发生：
- 深层链接URL格式不正确。
- 应用意图筛选器配置不正确。
- 该应用未安装或不在测试设备的允许列表中。
试试这个
- 检查深层链接URL格式是否与预期模式相匹配。
- 验证Android清单中的应用意图筛选器是否正确。
- 确认该应用已安装并在设备的允许列表中。
- 要找出问题，请使用Android调试桥 (ADB) 命令直接测试深层链接URL。如果该链接可通过ADB运行，但无法通过Fire TV运行，则问题可能出在您的应用之外，需要进一步调查。
问题： 自动播放不适用于授权用户
症状
当授权用户选择内容时，它不会在您的应用中自动播放。此问题可能由于以下任何原因而发生：
- 权利验证失败。
- 未授予播放权限。
- 内容权限限制阻止了播放。
试试这个
- 验证测试账户是否具备有效权利。
- 查看应用中的权利验证逻辑，并确保它没有拒绝有效的权利。必要时更新逻辑。
- 确保您的应用为授权用户授予播放权限。
- 确认内容具有适当的播放权限和许可。
问题： 播放或加载的内容不正确
症状
当您选择内容时，应用中会播放或加载错误的作品。此问题可能由于以下任何原因而发生：
- 目录和应用之间的内容ID不匹配。
- 深层链接参数不正确。
- 应用路由逻辑存在问题。
试试这个
- 验证您的目录文件和应用之间的内容ID是否匹配。
- 验证传递给应用的深层链接参数是否正确。
- 使用多个内容项进行测试以识别模式。如果标题之间出现同样的不匹配，则问题可能出在路由逻辑上，而不是单个内容条目中。
- 查看应用中的内容路由逻辑，确保其正确无误。如果逻辑映射ID不正确，请更新路由以匹配目录文件中的ID。
Last updated: 2026年5月27日
