合作伙伴托管行
合作伙伴托管行
您可以使用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对象中。
注意： “已使用”（最右侧的列）表示Amazon Fire TV当前是否在主屏幕上显示的Fire TV推荐中使用此数据。即使现在没有使用额外信息，它也可能在将来发布的Fire TV版本中使用。
| 额外项名称 | 数据类型 | 详情 | 已使用 |
|---|---|---|---|
com.amazon.extra.DISPLAY_NAME |
字符串 | “启动”菜单中显示的较短应用名称（在选择推荐时按菜单按钮会显示该名称）。长度限制为15个字符。其他字符将被截断，且被截断字符不会显示为省略号。 | 是 |
com.amazon.extra.MATURITY_RATING |
字符串 | 在标题下方显示评级。Amazon Fire TV上的“家长监护”设置也使用该评级来确定播放内容是否需要PIN。任何没有此额外信息或者没有setMaturityRating()值的推荐将被视为成人内容，可能需要PIN码才能播放，具体取决于设备上的“家长监护”设置。
目前，支持的值如下所示：
|
是 |
com.amazon.extra.ACTION_OPTION |
ArrayList<int> | 确定为每个推荐显示的上下文菜单选项。支持两个上下文菜单操作，但只有第一个操作是可配置的。 当用户单击推荐磁贴或其第一个上下文菜单选项时，Amazon Fire TV会使用随推荐传递的相应内容意图数据启动应用。注意： 如果您的应用提供了操作数组列表，则必须提供
如果未提供任何值，则默认操作将为 |
是 |
com.amazon.extra.RANK |
int | 这个额外项用于按排名的升序顺序排列项目，然后按提交时间进行二次排序（最新提交的最先列出）。如果缺少此值，则只按提交时间排序。可能值范围为0到INTEGER.MAX_VALUE。值越低，排名越高；也就是说，低值在高值之前显示 |
否 |
com.amazon.extra.CONTENT_ID |
字符串 | 此ID对应于目录集成中使用的内容ID。 | 否 |
com.amazon.extra.LIVE_CONTENT |
int | 根据CONTENT_START_TIME和CONTENT_END_TIME帮助确定推荐是否为直播内容，以及是需要显示还是隐藏。支持的值如下：
| 否 |
com.amazon.extra.CONTENT_RELEASE_DATE |
字符串 | 内容发布年份。示例： 2016、2015、1977等。 | 是 |
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY |
int | 内容的字幕可用性。
| 是 |
com.amazon.extra.IMDB_ID |
字符串 | 内容的IMDB ID。（例如，如果URL为http://www.imdb.com/title/tt0417148，则该ID为tt0417148。） |
否 |
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。 | 否 |
com.amazon.extra.TAGS |
ArrayList<String> | 如果您的内容是4K（超高清），请添加标签["UHD"]。 |
是 |
com.amazon.extra.CONTENT_CUSTOMER_RATING |
int | 客户评分，可能值范围为0到10。 | 是 |
com.amazon.extra.CONTENT_CUSTOMER_RATING_COUNT |
int | 对此内容进行评分的客户数量。 | 是 |
示例推荐卡片
以下示例推荐卡片显示了字段在卡上的显示方式。
卡上的标注数字是指以下字段：