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

支持的值包括:
美国德国英国
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 字符串 此 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 字符串 这表示内容的发布年份(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。

示例推荐卡

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

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

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

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