iOS push payload
最近为了应对客户的需求,需要对群聊中根据用户的设置进行消息免打扰。抽空又仔细看了一下iOS push的格式,并且使用Knuff进行了一些实验。苹果官方guide其实说的还是很清楚的。
普通的remote push notification,有提示(APP在后台或closed状态时,1,响一声,2,手机上方出现横幅,3,消息显示在通知中心) 时,推送payload格式:
{
"aps":{
"alert": {
"body": "hello",
"title": "You have a new message"
},
"sound": "default",
"badge": 1
},
"custom1": "custom information"
}
其中:
body:消息的内容;
title:消息横幅中显示为粗体
sound:提示音
custom1:用户自定义的字段
badge: 红点角标(数字,不能...,可以很大)
如果APP在后台或者closed状态时,收到消息推送,不希望出现提示音,但是出现消息横幅,消息显示在通知中心,则payload里不能出现sound字段,为:
{
"aps":{
"alert": {
"body": "hello, no sound",
"title": "You have a new message"
}
},
"custom1": "custom information"
}
注意:没有"sound"字段就不会响一声提示,但是横幅和通知中心都不会受影响;
另外,iOS有一种推送,称为 "silent push",它的payload格式如下:
{
"aps":{
"content-available": 1
},
"custom1": "custom information"
}
silent push要求push payload必须满足下面两点:
1) The payload’s aps dictionary must include the content-available key with a value of 1.
必须有"content-available",且值为1;
2) The payload’s aps dictionary must not contain the alert, sound, or badge keys.
一定不能包含alert,sound 和 badge
当用户设备收到silent push后,它会在后台调起app并运行30秒,调用的delegate:
application:didReceiveRemoteNotifiacation:fetchCompletionHandler:
与收到普通remote push notification后,在通知中心(或横幅)点消息后,调起APP,系统调用的delegate一致。
但是开启silent push,必须给APP设置相应的capability:
在Xcode中,工程Targets->Capabilities->Background Modes 设置为ON,并且勾选 Remote notifications
但是需要注意的一点,在guide中也被标记为IMPORTANT,silent push不是用来保持APP在后台awake的,也不具有高优先级。APNs把silent push视为低优先级,并且如果消息总数过多,可能会限制其传送。实际的限制是动态且根据具体情况变化的,但是请不要在一小时内传送过多的数据。
但是,更重要的一点是,APP收到silent push后,调用delegate的前提条件是APP没有没杀死,比如:用户手动划走,被系统回收或者手机重启。在这3种情况下,silent push并不能唤醒APP并执行一段代码。