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并执行一段代码。

苹果官方guide:https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/index.html#//apple_ref/doc/uid/TP40008194-CH3-SW1

你可能感兴趣的:(iOS push payload)