开发人员控制台

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,具体取决于设备上的家长监护设置。

支持的值包括:
美国德国英国
G
PG
PG13
R
NC17
TVY
TVY7
TVG
TVPG
TV14
TVMA
FSK0
FSK6
FSK12
FSK16
FSK18
BBFCPG
BBFC12
BBFC15
BBFC18
BBFCU
日本印度
EIRIN_G
EIRIN_PG12
EIRIN_R15
EIRIN_R18
ALL
7+
13+
16+
18+
NR
com.amazon.extra.TAGS ArrayList<String> 这有助于确定推荐将在哪个Fire TV UI类别中显示。如果未提供,则默认为Home

目前支持的值包括HomeYour VideosUHD

Home: 应出现在主屏幕上的电影或电视推荐

Your Videos: 客户无需额外付费即可观看的电影和电视节目的推荐

UHD: 用于4K(超高清)推荐。这将在精简详情上添加一个超高清图标

目前不受支持,但保留供将来使用: MoviesTV ShowsTrailersShort 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目前支持两个上下文菜单操作,但只有第一个操作是可配置的。单击推荐磁贴或其第一个上下文菜单选项时,随推荐一起传递的相应内容意图数据将用于启动应用。

值​操作
1使用<应用名称>立即观看
101观看
2使用<应用名称>继续
102继续
3切换<应用名称>配置文件
103切换配置文件
4更改<应用名称>设置
5使用<应用名称>查看
105查看
6使用<应用名称>播放
106播放
7使用<应用名称>收听
107收听
com.amazon.extra.LIVE_CONTENT int 这将指定推荐是否为直播内容,在这种情况下,应根据CONTENT_START_TIMECONTENT_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。

示例推荐卡

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

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

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

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