通知


通知

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

什么是通知?

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

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

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

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

Amazon Fire TV 支持的通知类型

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

提醒通知

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

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

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

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

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

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

Toast

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

标准通知

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

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

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

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

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

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

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

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

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

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

在显示为提醒通知时未被关闭的通知将显示在通知中心中。

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

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

通知的要求

下表列出了通知的要求。

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

代码示例

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

系统通知

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

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

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

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

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

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

应用更新通知

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

安装后通知

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

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

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

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