本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用移动推送通知的 Amazon SNS 生存时间 (TTL) 消息属性
Amazon Simple Notification Service (Amazon SNS) 支持设置移动推送通知消息的生存时间 (TTL) 消息属性。除此之外,还可以在Amazon SNS消息正文中为支持此功能的移动推送通知服务(例如亚马逊设备消息 (ADM) 和Firebase云消息 (FCM))在发送到安卓系统时设置TTL。
TTL 消息属性用于指定有关消息的过期元数据。这允许您指定推送通知服务(如 Apple Push Notification Service (APNs)或 FCM)必须在多长的时间内将消息传送至终端节点。如果因为某种原因(如移动设备已关闭),消息无法在指定的 TTL 内传达,则系统将丢弃该消息,且不再尝试传送它。要在消息属性中指定 TTL,您可以使用 Amazon 软件开发套件 (SDK) 或查询 API。 Amazon Web Services Management Console
推送通知服务的 TTL 消息属性
以下是推送通知服务的 TTL 消息属性列表,您可以在使用 Amazon SDK 或查询 API 时使用这些属性进行设置:
推送通知服务 | TTL 消息属性 |
---|---|
Amazon Device Messaging (ADM) | AWS.SNS.MOBILE.ADM.TTL |
Apple Push Notification Service (APNs)。 | AWS.SNS.MOBILE.APNS.TTL |
Apple Push Notification Service 沙盒 (APNs_SANDBOX) | AWS.SNS.MOBILE.APNS_SANDBOX.TTL |
百度云推送(百度) | AWS.SNS.MOBILE.BAIDU.TTL |
Firebase 云端消息传递(发送到安卓系统时为 FCM) | AWS.SNS.MOBILE.FCM.TTL |
Windows 推送通知服务 (WNS) | AWS.SNS.MOBILE.WNS.TTL |
每个推送通知服务以不同的方式处理 TTL。Amazon SNS 提供了涵盖所有推送通知服务的 TTL 抽象视图,使您能够更方便地指定 TTL。当您使用指定 TTL( Amazon Web Services Management Console 以秒为单位)时,您只需输入一次 TTL 值,然后 Amazon SNS 将在发布消息时计算每种选定推送通知服务的 TTL。
TTL 是相对于发布时间的。在将推送通知消息转交给特定的推送通知服务之前,Amazon SNS 会计算该推送通知的停留时间(发布时间戳与将消息转交给推送通知服务之间的时间差),并将剩余的 TTL 传递给特定的推送通知服务。如果 TTL 短于停留时间,Amazon SNS 不会尝试发布。
如果您为推送通知消息指定 TTL,则 TTL 值必须为正整数,除非值对推送通知服务0
有特定的含义,例如 APN 和 FCM(发送到 Android 时)。如果 TTL 值设为 0
,但该推送通知服务对 0
无具体意义,则 Amazon SNS 将丢弃该消息。有关使用 APNs 时设置为 0
的 TTL 参数的更多信息,请参阅二进制提供程序 API
决定 TTL 的优先顺序
Amazon SNS 根据以下顺序来决定推送通知消息的 TTL,数字越小,优先级越高:
-
消息属性 TTL
-
消息正文 TTL
-
推送通知服务默认 TTL(随服务而变)
-
Amazon SNS 默认 TTL(4 周)
如果您为同一条消息设置了不同的 TTL 值(分别是消息属性和消息正文的 TTL),则 Amazon SNS 会修改消息正文中的 TTL,以匹配消息属性中指定的 TTL。
使用指定 TTL Amazon Web Services Management Console
登录 Amazon SNS 控制台
。 -
在导航面板中,选择移动,推送通知。
-
在 Mobile push notifications (移动推送通知) 页面上的平台应用程序部分中,选择应用程序。
-
在该
MyApplication
页面的终端节点部分,选择应用程序终端节点,然后选择发布消息。 -
在消息详细信息部分中,输入 TTL(推送通知服务必须向终端节点发送消息的秒数)。
-
选择发布消息。