极光推送的角标问题——让人又爱又恨的小红点-极光社区

我们现在无论何时拿出自己的手机，解锁后的主页上，总能看到一个个的小红点，仿佛在呐喊：有消息啦，不管重不重要，快点我，快来消除我。

甚至曾有人掀起了一波潮流：在微信头像上加上小红点。这很直接很彻底地引发了大众的清除强迫症。

这也就是为什么我们做 App 的时候，希望在收到了推送消息时，App 能带上一个小红点。在使用得当的情况下，小红点有助于增加 App 的启动率，保持用户粘度。

那么 App 端怎么来实现呢？小红点中心的数值怎么来管理呢？

Android

角标不是 Android 的基本功能，也就是说 Google 原生系统是不支持的，不过国内某些 ROM 提供了各自的方法来支持自定义实现，只是跟随系统更新，提供的方法可能还会有所改变。因此极光推送并没有支持 Android 的角标，需要大家自己去实现与管理角标值。
如果你在自己没有做任何 Android 角标相关的操作时就有了角标，这代表手机系统自己做了展示，需要看下手机系统的相关文档。
分享几个实现 Android badge 的项目

从 JPush Android 336 版本开始，支持华为手机角标设置，阅读文档

文章
https://community.jiguang.cn/t/android-app/12364

iOS：推送时给 badge 传值，客户端收到即展示，之后再做其他处理。

一、客户端设置角标

设置本地显示的角标（Apple官方的接口）

[[UIApplication sharedApplication] setApplicationIconBadgeNumber:(int)value];
[[UIApplication sharedApplication] setApplicationIconBadgeNumber:0]; //清除角标
//以上方法在任何地方均可调用，根据自己的需要设定即可。譬如：

//杀死后点击icon进入时清除角标
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
application.applicationIconBadgeNumber = 0;
}
//从后台点击icon进入时清除角标
func applicationWillEnterForeground(_ application: UIApplication) {
application.applicationIconBadgeNumber = 0;
}

设置极光服务器存储的角标（不要忽略！）

+ (BOOL)setBadge:(int)value  //value 取值范围：[0,99999]
+ (void)resetBadge  //相当于  [setBadge:0]，清空角标

设通过调用 API ，使极光服务器为Ａ设备存储的角标数为 P，为 B 设备存储的角标数为 Q。
场景描述：

收到 P 条消息，角标为 P
点击了一条消息，此时你获取到消息中的 badge 值为 P，自行计算 -1，将 P-1 赋值给 setbadge
再推送消息（badge +1），角标为 P，不会是 P+1

二、服务端或控制台推送时，badge可设置为 N，+N，-N

//服务端发送 json 消息串
{
    "notification" : {
         "ios" : {
                 "alert" : "hello, JPush!", 
                 "sound" : "sound.caf", 
                 "badge" : 1, //可传值为N，+N，-N。
                 }
            }
       }
}

官网控制台的设置 badge 的步骤：推送>发送通知>选择一个iOS目标平台>展开可选设置> iOS > badge

N：推送时设置为固定的数值，收到时角标便显示该数值。
+N 或 -N：收到时角标值 = 极光服务器存储的值 ± N：
- A 收到时角标为 P ± N，B 收到时角标为 Q ± N。
- 因此如果推送时使用 ± N，那么客户端就需要注意本地和极光服务器的角标应同步设置。
- 很多人问咋个角标清除不了，清除后再次推送收到的却依旧是清除前的值+N，这就是因为服务器存储的角标你没同步修改咯。

这里应该有注意到，极光服务器帮大家完成了每个设备的角标的管理，所以一般使用的时候只需要在客户端预设好角标的处理逻辑，推送时固定好 + N，就可以不用再自己操心 badge 的值了。

拓展

「badge 清零了，但通知栏消息没有消失」如何做到

「Java SDK 的 badge+1 用什么方法」
用的不是 setBadge，而是 autoBadge 或者 incrBadge

「Java SDK 推送消息时不设置角标」需要调 disableBadge

PHP SDK 要达到不设置角标的效果，使用 v3.5.34 版本及以上设置badge => null 即可。

ps.ps：正经讲可能你不明白，那我再通俗点说：

1、官网-推送消息-选择iOS平台-可选设置-badge，设置1、2、3或者N，+1，+2之类的

2、iOS端收到消息，系统直接就会显示这个badge的值

3、如果你传的+1，那么就是在极光服务器存的值里面+1后直接显示，一开始App啥也没做，就从0加起，你一直不setbadge，就会一直+1下去，setbadge就改变这个+1起始值

4、点击了消息，一般逻辑就是要清除、修改角标，那么调用Apple原生方法，看上面代码，把显示的角标给清除了/修改了，同时setbadge也附同样的值，这样下次+1的消息发过来，就是在你当前显示的badge上+1显示了，不需要你自己再管理了。

「再不行的话就测下我们的demo，多推送，看效果总能明白(´･_･`)」

最后附赠一个ps.ps.ps：JPush和JMessage的角标是共用的，使用+1语义即可。

1、启动App，成功注册JPush和JMessage，登录JMessage账号

2、JPush推送消息-选择iOS平台-可选设置-badge，设置+1，极光服务器会处理你的角标，把badge值变为「当前存储的角标值」+1=N，然后推送下去

3、iOS端收到JPush消息，系统直接就会显示这个badge的值，暂定你现在App端不做处理（不清除和修改角标）

4、JMessage处于后台等情况，极光有自动的通知提醒（将你的会话消息转为apns通知发到设备上），发下来的消息，角标是在N上+1后发下来并展示，发第二条消息，就是N+1+1=M。（JMessage的apns通知是我们自动发的，所以角标也是自动默认+1的语义）

5、然后JPush发消息，你后台推送的时候也是写的badge+1（这里JPush是可以传固定值的，但是一旦传了固定值，收到消息就显示这个固定值了，所以后台推送一定要写上badge+1），那么此时收到，就展示的是M+1的角标

6、之后你点击了消息等要做处理，一般逻辑就是要清除、修改角标，那么调用Apple方法， UIApplication:setApplicationIconBadgeNumber ，把本地显示的角标给清除了/修改了，同时setbadge也附同样的值，就是告诉极光服务器下次+1，从这个值开始+。

还不收了我去祸害处女座(oﾟvﾟ)ノ

返回常见问题总目录

极光推送的角标问题——让人又爱又恨的小红点

拓展

0条评论