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

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