合作伙伴托管行(Fire TV)
合作伙伴托管行(Fire TV)
您可以使用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对象中。
| 额外项名称 | 类型 | 必需 | 详情 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
com.amazon.extra.DISPLAY_NAME |
String | 是 | 这是简洁版本的应用名称，显示为使用...立即观看上下文菜单的文本标签的一部分。长度限制为15个字符，必要时会截断。 | ||||||||||||||||||||||||||||
com.amazon.extra.MATURITY_RATING |
String | 是 |
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 |
String | 否 | 此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 |
String | 是 | 这表示内容的发布年份（2016年、2015年、1977年等）。 | ||||||||||||||||||||||||||||
com.amazon.extra.CONTENT_CAPTION_AVAILABILITY |
int | 是 |
这表明内容是否具有字幕。 0 - 字幕不可用 1 – 字幕可用 |
||||||||||||||||||||||||||||
com.amazon.extra.IMDB_ID |
String | 否 | 指定内容的IMDB ID。 | ||||||||||||||||||||||||||||
com.amazon.extra.IMDB_SCORE |
String | 否 | 指定内容的IMDB评分。 | ||||||||||||||||||||||||||||
com.amazon.extra.CONTENT_START_TIME |
long | 否 | 表示以毫秒为单位的开始时间(EPOCH)。 | ||||||||||||||||||||||||||||
com.amazon.extra.CONTENT_END_TIME |
long | 否 | 表示以毫秒为单位的结束时间(EPOCH)。 | ||||||||||||||||||||||||||||
com.amazon.extra.LONG_DESCRIPTION |
String | 否 | 这是推荐的详细描述，限制为512个字符，并在必要时进行截断。 | ||||||||||||||||||||||||||||
com.amazon.extra.LAST_WATCHED_DATETIME |
long | 否 | 表示推荐内容的上次观看时间（以毫秒为单位）(EPOCH)。 | ||||||||||||||||||||||||||||
com.amazon.extra.PREVIEW_URL |
String | 否 | 指定推荐的预览视频或图像URL。 |
示例推荐卡
以下示例推荐卡片显示了字段在卡上的显示方式。
卡上的标注数字是指以下字段：