开发人员控制台

最佳实践和常见问题解答


最佳实践和常见问题解答

本节介绍合作伙伴托管行(PMR)的最佳实践和常见问题解答。

最佳实践

  • 请勿提高优先级 - 许多应用使用的优先级值似乎高于官方文档指定的优先级值。我们使用EXTRA_AMAZON_RANK。如果不存在该值,我们将使用推荐新近度来确定排序位置。如果存在该值,则首先按排名的升序顺序对项目排序,然后按提交时间排序,最近的项目最先列出。
  • 不要保留陈旧卡片 - 确保您的内容仍然相关,并删除陈旧或过时的卡片。此外,不要实例化“已经过时”的卡片,确保您在某种程度上跟踪之前显示(和访问过)的内容。例如,如果用户观看完了推荐内容,您可能希望使用上述删除推荐的说明删除该特定项目。

    如果您不遵循这些建议做法,用户可能会手动完全关闭您的推荐;在最坏的情况下,用户可能会感到沮丧,以至于他们寻找更快的途径,直接卸载您的应用,并可能会在Amazon Appstore中留下负面评级。

  • Android的50个通知限制 - Android强制对每个程序包施加最多50个通知的限制。这包括应用打算使用的推荐和任何其他通知。(请参阅NotificationServiceManager中的MAX_PACKAGE_NOTIFICATIONS。) 因此,请确保在发送新通知之前取消旧通知(如果数量超过50)。否则,您可能会看到日志错误,例如: W/NotificationManager﹕ notify: id corrupted: sent 51, got back 0.
  • 个性化 - 根据应用中用户的兴趣、个人资料和最近活动以及其他参数进行个性化设置的推荐最为有效。用户可能会发现个性化推荐比一般推荐更有效且更具吸引力。
  • 限制一次性提出的推荐数量 - 我们建议不要一次发送很多推荐。请考虑以较小数量(一次大约5个)批处理推荐。PMR显示的最低推荐数量为5。此要求是为了确保Fire TV UI看起来一致。
  • 作为后台应用发送推荐 - 发送推荐的可能触发点是按重复间隔安排AlarmManager,并在到期日安排Android JobScheduler作业或Syncadapter任务。
  • 如果您的应用签名发生变化 - 我们会使用应用签名来检查推荐发送者的有效性。如果您将来打算更改应用签名,请联系亚马逊开发者门户。此外,请遵循有关向Amazon Appstore提交应用更新的标准操作程序。请使用发布签名和程序包名称作为开发的生产应用,这可能涉及到旁加载应用。
  • 处理后退按钮事件 - 如果您的应用捕获后退按钮事件,请勿发送导航至Fire TV主页的意图,而是在处理应用中最后一个后退按钮事件时退出应用。这将允许用户导航回PMR行。

常见问题解答

重新启动后PMR行丢失
在用户导航到特定类别时,UI不会更新PMR行的内容。例如,从主页部分遍历到其他部分(如电影电视节目)(以及反向遍历)将强制更新UI。然后PMR将反映您的应用自启动以来发送的推荐。

OTA更新后PMR行丢失
服务器API调用生存时间(TTL)为5小时。要强制刷新,请按照下列步骤操作:

  1. 遍历到“设置”选项。
  2. 在此选择“我的账户”选项。
  3. 单击“同步亚马逊内容”部分。
  4. 推荐行现在应显示在“主页”和/或“我的视频”部分下。

启用开发者行
开发者行可帮助应用开发者在PMR示例行上测试他们的推荐。开发者可以测试他们的推荐在Fire TV上显示时的外观和风格。从第2代Fire TV和第2代Fire TV Stick上的Fire OS 5.2.4.0版本开始提供开发者行。

要启用开发者行,请按照以下步骤操作:

  1. 按住SELECT + 向下方向键3秒钟打开“开发者工具”菜单,然后按Fire TV遥控器上的“菜单”。同样,在亚马逊游戏控制器上,按住A + Y 3秒钟,然后按MENU按钮。

  2. 打开“开发者选项”。

  3. 打开“开发者行”。所有已安装的应用程序包将显示在列表视图中。要在PMR示例行中测试您的推荐,请选择您的程序包名称。

  4. 按“确定”。

  5. 重新启动设备。

资源

PMR参考

PMR API指南