iOS静默通知
iOS Silent Notification(静默通知),属于特殊的远程推送通知,其目的不是为了弹出通知框提醒用户,而是用于后台运行的App和服务端同步数据。例:App在后台放置一段时间,网络已不再活跃,App内数据可能已经过时;服务端可推送一条携带参数的静默通知,处于后台的App可以触发静默通知回调,在后台运行状态下获取对应参数并发起网络请求,获取最新数据更新,整个过程用户无感知。
[backcolor=transparent]静默通知限制和注意事项:
- 静默通知主要用于更新和同步数据,用户对其无感知,因此静默通知一般不设置通知内容、声音和角标;
- 静默通知唤醒后台App并执行下载任务时,最多有30秒时间执行;
- App处于前台/后台时均可触发对应通知回调,App关闭后不能触发;
- 静默通知请求在APNs属于低优先级任务,苹果不保证静默通知的到达率;
- 不要利用静默通知对App进行保活,APNs若检测到较高频率的静默通知发送请求,可能会终止其发送(具体策略苹果未公开)。
服务端配置
静默通知一般不设置推送内容、声音和角标,发送到APNs的payload格式如下,其中需要设定content-available为1,标记为静默通知。
- [backcolor=transparent]{
- [backcolor=transparent] [backcolor=transparent]"aps"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]{
- [backcolor=transparent] [backcolor=transparent]"content-available"[backcolor=transparent] [backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]1
- [backcolor=transparent] [backcolor=transparent]},
- [backcolor=transparent] [backcolor=transparent]"key1"[backcolor=transparent] [backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"value1"[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"key2"[backcolor=transparent] [backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"value2"
- [backcolor=transparent]}
移动推送服务端发送静默通知,需要基于OpenAPI 2.0的推送高级接口:
- 接口描述参考OpenAPI 2.0 - API列表 - 推送高级接口;
- iOSSilentNotification设置为True时,表示使能静默通知;若通知内容字段Body为空串"",推送时忽略通知内容、声音和角标设置,推送一条用户无感知的静默通知;(建议使用方式)
- 若通知内容字段Body为非空串,通知内容、声音和角标都需要用户自行配置,用户可感知到该条静默通知。(不建议使用)
客户端适配
静默通知回调处理:
- 处理逻辑和普通通知回调一致;
- < iOS 10,触发didReceiveRemoteNotification回调,参考iOS API介绍的2.3 通知打开监听 - <iOS 10;
- >= iOS 10,App位于前台触发willPresentNotification回调,App位于后台触发didReceiveNotificationResponse回调,参考iOS API介绍的2.3 通知打开监听 - iOS 10+;
App若需要在后台处理静默通知,Xcode工程做以下修改:
- Xcode中选中App对应Project,并选中对应iOS App Target;
- 打开Capabilities Tab,使能Background Modes,并勾选Remote notifications。