Fire TV 上的 PMR
Fire TV 上的 PMR
您可以使用安卓通知向合作伙伴托管行 (PMR) 提交推荐。亚马逊通过在通知中使用额外字段来提供扩展功能。
安卓电视上的 PMR
安卓框架允许应用通过使用安卓通知提交推荐。在 API 级别 21 及更高版本中，通知可能会被标记为特殊推荐类别。您创建一个标准的安卓通知，并将类别设置为 Notification.CATEGORY_RECOMMENDATION。
请注意，安卓规定任何应用一次最多只能有 50 个通知处于活动状态。这包括归类为推荐的通知。
Fire TV 的 PMR 亚马逊增强功能
通知和推荐通过标准安卓设备和 Fire TV 设备上的相同机制提交。亚马逊的本地推荐机制基于标准的安卓 ContentRecommendation.Builder API 构建。
扩展功能可通过额外信息提供。开发者可以将以下额外信息值添加到其 Notification 对象中。
| 额外项名称 | 类型 | 请求 | 详情 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| com.amazon.extra.DISPLAY_NAME | 字符串 | 是 | 这是简洁版本的应用名称，显示为使用...立即观看上下文菜单的文本标签的一部分。长度限制为 15 个字符，必要时会截断。 | ||||||||||||||||||||||||||||
| com.amazon.extra.MATURITY_RATING | 字符串 | 是 |
Fire TV 设备上的家长监护设置将使用此评级来确定是否需要 PIN 码才能访问。没有此值的任何推荐都将被视为“成人”内容，可能需要 PIN，具体取决于设备上的家长监护设置。 支持的值包括：
|
||||||||||||||||||||||||||||
| com.amazon.extra.TAGS | ArrayList<String> | 否 |
这有助于确定推荐将在哪个 Fire TV UI 类别中显示。如果未提供，则默认为 Home。目前支持的值包括 Home、Your Videos、UHD：Home： 应出现在主屏幕上的电影或电视推荐Your Videos： 客户无需额外付费即可观看的电影和电视节目的推荐UHD： 用于 4K（超高清）推荐。这将在精简详情上添加一个超高清图标当前不受支持，但保留供将来使用： Movies、TV Shows、Trailers、Short Form。
|
||||||||||||||||||||||||||||
| com.amazon.extra.RANK | int | 否 |
这个额外项用于按排名的升序顺序排列项目，然后按提交时间进行二次排序（最新提交的最先列出）。如果缺少此值，则只使用提交时间。可能的值范围从 0 到 INTEGER.MAX_VALUE。值越低，排名越高；也就是说，低值显示在高值之前。
|
||||||||||||||||||||||||||||
| com.amazon.extra.CONTENT_ID | 字符串 | 否 | 此 ID 对应于目录集成中使用的内容 ID。 | ||||||||||||||||||||||||||||
| com.amazon.extra.ACTIONS | ArrayList<String> | 是 |
此标签有助于确定每个推荐的快捷菜单上可用的选项。注意： PMR 目前支持两个上下文菜单操作，但只有第一个操作是可配置的。单击推荐磁贴或其第一个上下文菜单选项时，随推荐一起传递的相应内容意图数据将用于启动应用。
|
||||||||||||||||||||||||||||
| com.amazon.extra.LIVE_CONTENT | int | 否 |
这将指定推荐是否为直播内容，在这种情况下，应根据 CONTENT_START_TIME 和 CONTENT_END_TIME 来管理其可见性。0 - 非直播内容 1 - 直播内容 目前不支持。 |
||||||||||||||||||||||||||||
| com.amazon.extra.CONTENT_RELEASE_DATE | 字符串 | 是 | 这表示内容的发布年份（2016 年、2015 年、1977 年等）。 | ||||||||||||||||||||||||||||
| com.amazon.extra.CONTENT_CAPTION_AVAILABILITY | int | 是 |
这表明内容是否具有字幕。 0 - 字幕不可用 1 - 字幕可用 |
||||||||||||||||||||||||||||
| com.amazon.extra.IMDB_ID | 字符串 | 否 | 指定内容的 IMDB ID。 | ||||||||||||||||||||||||||||
| com.amazon.extra.IMDB_SCORE | 字符串 | 否 | 指定内容的 IMDB 评级。 | ||||||||||||||||||||||||||||
| com.amazon.extra.CONTENT_START_TIME | long | 否 | 表示以毫秒为单位的开始时间 (EPOCH)。 | ||||||||||||||||||||||||||||
| com.amazon.extra.CONTENT_END_TIME | long | 否 | 表示以毫秒为单位的结束时间 (EPOCH)。 | ||||||||||||||||||||||||||||
| com.amazon.extra.LONG_DESCRIPTION | 字符串 | 否 | 这是推荐的详细描述，限制为 512 个字符，并在必要时进行截断。 | ||||||||||||||||||||||||||||
| com.amazon.extra.LAST_WATCHED_DATETIME | long | 否 | 表示推荐内容的上次观看时间（以毫秒为单位）(EPOCH)。 | ||||||||||||||||||||||||||||
| com.amazon.extra.PREVIEW_URL | 字符串 | 否 | 指定推荐的预览视频或图像 URL。 |
示例推荐卡
以下示例推荐卡片显示了字段在卡上的显示方式。
卡上的标注数字是指以下字段：