开发者控制台
登录
登录
开发者控制台

合作伙伴托管行

合作伙伴托管行

您可以使用Android通知将推荐提交到合作伙伴托管行 (PMR)。亚马逊通过在通知中使用额外字段来提供扩展功能。

Android电视上的PMR

Android框架允许应用通过使用Android通知提交推荐。在API级别21及更高级别中，通知可能会被标记为特殊推荐类别。您创建一个标准的Android通知，并将类别设置为Notification.CATEGORY_RECOMMENDATION。

请注意，Android规定任何应用一次最多只能有50个通知处于有效状态。这包括归类为推荐的通知。

Fire TV的PMR亚马逊增强功能

通知和推荐在标准Android设备和Fire TV设备上通过相同机制提交。亚马逊的本地推荐机制基于标准的Android ContentRecommendation.Builder API构建。

扩展功能可通过额外信息提供。开发者可以将以下额外信息值添加到其Notification对象中。

下表列出了可以添加到PreviewProgram对象的额外信息。

额外项名称 数据类型 详情
com.amazon.extra.DISPLAY_NAME 字符串 Launch（启动）菜单中显示的较短应用名称（在选择推荐时按菜单按钮会显示该名称）。长度限制为15个字符。其他字符将被截断，且被截断字符不会显示为省略号。
com.amazon.extra.ACTION_OPTION 整数 确定为每个推荐显示的上下文菜单选项。支持并可配置一个上下文菜单操作。当用户单击推荐磁贴或其第一个上下文菜单选项后，亚马逊Fire TV会使用随推荐传递的相应内容意图数据启动应用。注意：​ 如果您的应用提供了操作数组列表，则必须提供com.amazon.extra.DISPLAY_NAME（如上所述）。ACTION_OPTION包含的可能值如下所示：

1： Watch with <应用名称>（使用<应用名称>观看）
2： Watch（观看）
3： Resume with <应用名称>（使用<应用名称>继续）
4： Resume（继续）
5： Switch <应用名称> Profile（切换<应用名称>配置文件）
6： Change <应用名称> Settings（更改<应用名称>设置）
7： Change Settings（更改设置）
8： View with <应用名称>（使用<应用名称>查看）
9： View（查看）
10： Play with <应用名称>（使用<应用名称>播放）
11： Play（播放）
12： Listen with <应用名称>（使用<应用名称>收听）
13： Listen（收听）

如果未提供任何值，则默认操作将为Open（打开），下面是Launch <应用名称>（启动<应用名称>）。
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY 整数 内容的字幕可用性：
0： 内容没有字幕可用。
1： 内容有字幕可用。

示例推荐卡

以下示例推荐卡片显示了字段在卡上的显示方式。

卡上的标注数字是指以下字段：

  1. 名称
  2. 文本
  3. 内容图像
  4. 显示名称(com.amazon.extra.DISPLAY_NAME)

    根据您与推荐关联的标签，按钮显示标签会有所不同：
    类别按钮显示标签
    Home使用<DISPLAY_NAME>立即观看
    Your Videos使用<DISPLAY_NAME>立即观看

Last updated: 2025年6月9日