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

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

这也就是为什么我们做 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 ,使极光服务器为A设备存储的角标数为 P,为 B 设备存储的角标数为 Q。
场景描述:

  1. 收到 P 条消息,角标为 P
  2. 点击了一条消息,此时你获取到消息中的 badge 值为 P,自行计算 -1,将 P-1 赋值给 setbadge
  3. 再推送消息 (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゚)ノ

返回常见问题总目录