最佳实践和常见问题解答 (Fire TV)
本节介绍合作伙伴托管行 (PMR) 的最佳实践和常见问题解答。
最佳实践
- 请勿提高优先级 - 许多应用使用的优先级值似乎高于官方文档指定的优先级值。我们使用
EXTRA_AMAZON_RANK。如果不存在该值，我们将使用推荐新近度来确定排序位置。如果存在该值，则首先按排名的升序顺序对项目排序，然后按提交时间排序，最近的项目最先列出。 -
不要保留陈旧卡片 - 确保您的内容仍然相关，并删除陈旧或过时的卡片。此外，不要实例化“已经过时”的卡片，确保您在某种程度上跟踪之前显示（和访问过）的内容。例如，如果用户观看完了推荐内容，您可能希望使用上述删除推荐的说明删除该特定项目。
如果您不遵循这些建议做法，用户可能会手动完全关闭您的推荐；在最坏的情况下，用户可能会感到沮丧，以至于他们寻找更快的途径，直接卸载您的应用，并可能会在亚马逊应用商店中留下负面评级。
- Android的50个通知限制 - Android强制对每个程序包施加最多50个通知的限制。这包括应用打算使用的推荐和任何其他通知。（请参阅NotificationServiceManager中的
MAX_PACKAGE_NOTIFICATIONS。） 因此，请确保在发送新通知之前取消旧通知（如果数量超过50）。否则，您可能会看到日志错误，例如： W/NotificationManager﹕ notify: id corrupted: sent 51, got back 0。 - 个性化 - 根据应用中用户的兴趣、个人资料和最近活动以及其他参数进行个性化设置的推荐最为有效。用户可能会发现个性化推荐比一般推荐更有效且更具吸引力。
- 限制一次性提出的推荐数量 - 我们建议不要一次发送很多推荐。请考虑以较小数量（一次大约5个）批处理推荐。PMR显示的最低推荐数量为5。此要求是为了确保Fire TV用户界面看起来一致。
- 作为后台应用发送推荐 - 发送推荐的可能触发点是按重复间隔安排
AlarmManager，并在到期日安排AndroidJobScheduler作业或Syncadapter任务。 - 如果您的应用签名发生变化 - 我们会使用应用签名来检查推荐发送者的有效性。如果您将来打算更改应用签名，请联系亚马逊开发者门户。此外，请遵循有关向亚马逊应用商店提交应用更新的标准操作程序。请使用发布签名和程序包名称作为开发的生产应用，这可能涉及到侧载应用。
- 处理返回按钮事件 - “返回”按钮应将用户返回到上一个屏幕或操作。根据需要提供确认对话框，例如 “确定要退出应用吗？”，但要确保应用不会进入打开和关闭菜单的无限循环。这些对话框允许用户以自然的流程在应用的屏幕之间导航返回，而不是在按 “返回” 按钮时意外退出应用。
常见问题解答
重新启动后PMR行丢失
在用户导航到特定类别时，用户界面不会更新PMR行的内容。例如，从Home（主页）部分遍历到其他部分（如Movie [电影] 或TV Shows [电视节目]）（以及反向遍历）将强制更新用户界面。然后PMR将反映您的应用自启动以来发送的推荐。
OTA更新后PMR行丢失
服务器API调用生存时间 (TTL) 为5小时。要强制刷新，请按照下列步骤操作：
- 转到Settings（设置）。
- 选择My Account（我的账户）。
- 单击Sync Amazon Content（同步亚马逊内容）。
- 推荐行现在应显示在Home和/或Your Videos（我的视频）部分下。
启用Developer Row
Developer Row（开发者行）可帮助应用开发者在PMR示例行上测试他们的推荐。开发者可以测试他们的推荐在Fire TV上显示时的外观和风格。从第2代Fire TV和第2代Fire TV Stick上的Fire OS 5.2.4.0版本开始提供Developer Row。
要启用Developer Row，请按照以下步骤操作：
-
按住SELECT + 向下方向键3秒钟打开Developer Tools（开发者工具）菜单，然后按Fire TV遥控器上的MENU（菜单）。同样，在亚马逊游戏控制器上，按住A + Y 3秒钟，然后按MENU按钮。
-
打开Developer Options（开发者选项）。
-
打开Developer Row。所有已安装的应用程序包将显示在列表视图中。要在PMR示例行中测试您的推荐，请选择您的程序包名称。
-
按OK（确定）。
-
重新启动设备。
资源
PMR参考
- https://developer.android.com/training/tv/discovery/recommendations?hl=zh-cn
- https://developer.nvidia.com/content/android-tv-recommendations（仅提供英文版）
PMR API指南
- http://developer.android.com/reference/android/support/app/recommendation/ContentRecommendation.html（仅提供英文版）
Last updated: 2025年6月9日
