开发者控制台

通知

通知

Fire TV设备通过Android通知API支持标准Android通知。这些通知显示在“通知中心”中,如下所述。

什么是通知?

通知是在应用用户界面之外为用户显示的消息。Amazon Fire TV支持Android通知API,但存在一些限制。

通常,您可以使用通知用户,告知他们您的应用存在可用的更新。此更新可能是以下任何一种:

  • 推出的新内容
  • 游戏中的新关卡
  • 现有电视剧的新剧集
  • 电视直播频道阵容变更
  • 应用中推出新游戏包
  • 新功能
  • 获得新徽章或奖励
  • 新版本

您可能习惯于从智能手机上的各种应用接收消息。针对您的Amazon Fire TV应用的通知可以提供相同类型的用户参与。通知是联系用户的一种方式,以鼓励他们以某种方式重新与您的应用进行互动。

Amazon Fire TV支持的通知类型

您可以在Amazon Fire TV上创建多种类型的通知:

提醒通知

Amazon Fire TV支持Android系统的提醒通知。通常在Android设备上,提醒通知是浮动窗口,显示在屏幕顶部,允许用户与窗口进行交互(例如,在您使用其他应用时接听来电)。

在Fire TV上,提醒通知会显示在屏幕底部,并在几秒钟后消失。显示通知时允许进行某些交互。例如,用户可以单击某个按钮或使用“后退”按钮关闭通知。

所有未关闭的提醒通知都将显示在通知中心,用户可以在通知中心随时查看通知。这还可以确保用户实际看到通知。(以前,如果用户错过了提醒通知,则无法返回到该通知。)

创建提醒通知时,必须将通知设置为高优先级:

.setPriority(Notification.PRIORITY_HIGH) // 提醒必须是高优先级

Amazon Fire TV不支持进度显示堆叠通知。关于布局,提醒通知的高度仅限于普通布局的高度(不存在扩展布局)。

Toast

虽然很少使用,但Fire TV也支持toast。Toast是一个小弹出窗口,它会在您的应用中短暂显示,然后消失,用户无法与消息交互。与提醒通知不同,toast不存储在通知中心内。

标准通知

标准通知本质上是信息性的,不会中断当前的前台活动(与屏幕右下角弹出的提醒通知不同)。应用中的通知一旦发出,就会立即添加到通知中心。

通知中心位于“设置”菜单下。当用户有未查看的通知时,“设置”旁边会出现一个小铃铛。

在“设置”中,用户可以选择“通知”。这将打开文档中所指的“通知中心”。

通知中心使用单一列表排列通知,最新通知排在最前面。当您的应用有更新时,Amazon Fire TV应用商店客户端本身会发送通知(因此您不必担心如何推送这些类型的通知)。在以下屏幕截图中,有两个应用有更新。

当用户单击图标时,他们会看到该应用可用的更新。用户可以选择更新应用,也可选择不更新。

通知应包含足够的信息来传达通知的原因。它们还可以包括在选择通知时启动的可选意图。例如,您的通知可以允许用户通过深层链接启动您的应用,该链接指向与意图相关的特定活动。

更新完成后,系统会提示用户启动应用。

用户还可以基于每个设备打开或关闭应用通知。(无法进行更精细的通知配置。) 用户可以通过转至首选项 >通知设置 >应用通知来控制应用通知。

用户还可以选择Do Not Interrupt(请勿中断)来禁止在屏幕上显示提醒通知。(您仍会在通知中心看到标准通知,并在主导航上看到“设置”上的铃铛图标。)

所有通知都会显示在通知中心,直到用户与通知互动、关闭通知、禁用应用的通知,或者直到应用删除通知。

如果在一条通知显示为提醒通知时未将其清除,则该通知将在通知中心显示。

每个通知都会指明收到的时间或日期。

一旦用户访问通知中心,无论是否点击通知,“设置”上的铃铛图标都将被删除。

通知的要求

下表列出了通知的要求。

功能 描述 是否必需?
大图像 用作通知卡片中磁贴图像的大图像。此图像在通知中心显示。图像应该是16:9的宽高比。图像容器的实际大小为228dp x 128dp,因此图像应至少为这些尺寸(或更大)。较大的图像将被缩小。请参阅setLargeIcon了解更多详细信息。如果未提供大图像,Fire TV将使用大应用图标。 可选
操作 启动应用或深层链接的Android意图。 可选
名称 通知的标题。 必需
描述 通知的说明。 必需
操作文本 菜单按钮的文本(默认为“立即启动”);这仅包含在标记为“紧急”的通知中。 可选
优先级 通知的Android优先级(范围为-2到+2)。如果优先级为+1或+2(HIGH或MAX),则该通知将被视为紧急通知。如果未提供值,则默认优先级为0。 可选

代码示例

有关如何创建通知的代码示例和技术说明,请参阅Android文档中的通知

系统通知

Amazon Fire TV还会向用户发送系统通知。尽管第三方应用无法复制或启动系统消息通知,但仍值得在此一提。常见Fire TV系统通知可能包括以下内容:

  • 电池电量低
  • 耳机断开连接
  • 蓝牙配对
  • 应用下载/安装完成
  • 其他系统更新

这些通知显示为屏幕一角的小弹出窗口,并且可以针对屏幕上的任何内容发出。系统通知也将存储在通知中心中(除非用户在初次显示时将其取消)。

当您的应用有更新时,Amazon Fire TV也会提供通知。这些通知不是您使用应用创建的内容,而是由Fire TV应用商店客户端触发的。

Fire TV创建两种类型的应用更新消息。“Required Update(必需更新)”消息是应用图标上的可视提示,指示有新的更新可用。

另一种更新消息通过设备上的对话框向用户显示。当用户在您的应用或游戏中启动新会话时,他们会看到“Update Now(立即更新)”或“Launch without Updating(启动而不更新)”选项,以及描述更新中新增内容的详细信息。

应用更新通知

安装应用后,用户会收到一个快速通知,告诉他们应用已准备好启动:

安装后通知

从已弃用的Amazon Fire TV通知API迁移

过去,Amazon Fire TV包含专为电视使用而设计的自定义通知API。自Fire OS 5起,亚马逊通知API已弃用。如果您的应用使用Fire TV通知API,这些通知将继续工作,但稍后将从平台中删除该API。如果您的应用使用亚马逊通知API,我们强烈建议您改用标准Android (Lollipop)通知API

要从亚马逊通知API迁移您的应用,请执行以下操作:

  • 删除所有对AmazonNotificationAmazonNotificationManager以及程序包com.amazon.device.notification的引用。这些可以替换为Android通知API中的普通NotificationNotificationManager类。
  • 应删除对AmazonNotification.setType()方法以及TYPE_INFOTYPE_MEDIA_INFO常量的引用。Android通知不指定这些类型。