Fire TV上的PMR
Fire TV上的PMR
您可以使用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。 |
示例推荐卡
以下示例推荐卡片显示了字段在卡上的显示方式。

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