你有没有发现，咱们解锁手机后桌面上App右上角总能看到一个小红点，这就是推送角标。推送角标指的是挪动设施上App图标右上角的红色圆圈，圆圈内的红色数字示意未读音讯数量。角标是一种比拟轻的揭示形式，通过直观的展示用户尚未浏览的信息数量，能够给用户营造一种紧张感，激发用户浏览的好奇心，从而让用户忍不住点开。因而在应用切当的状况下，推送角标有助于进步App推送关上率，放弃用户粘性。

HMS Core推送服务提供了设置桌面角标的API接口，开发者能够在音讯中封装角标参数。那这个“小红点”性能是如何实现的呢？以下是具体的集成步骤。

一．客户端API设置华为推送角标

反对平台：

1.零碎版本：EMUI4.1 及以上

2.桌面版本：6.3.29

3.反对设施：华为设施

角标性能开发：

  1. 申明权限
    < uses - permission android: name = "android.permission.INTERNET" / >        <        uses - permission android: name ="com.huawei.android.launcher.permission.CHANGE_BADGE " / >
  1. 在须要进行角标显示中央，采纳如下办法传递数据给华为桌面利用。
    Bundle extra = new Bundle();    extra.putString("package", "xxxxxx");    extra.putString("class", "yyyyyyy");    extra.putInt("badgenumber", i);    context.getContentResolver().call(Uri.parse("content://com.huawei.android.launcher    .settings/badge/"), "change_badge", null, extra);

要害参数阐明：

package：利用包名

class：桌面图标对应的利用入口Activity类

badgenumber：角标数字

    boolean mIsSupportedBade = true;    if (mIsSupportedBade) {        setBadgeNum(num);    }    /** set badge number*/    public void setBadgeNum(int num) {        try {            Bundle bunlde = new Bundle();            // com.test.badge is your package name            bunlde.putString("package", "com.test.badge");         // com.test. badge.MainActivity is your apk main activity        bunlde.putString("class", "com.test. badge.MainActivity");        bunlde.putInt("badgenumber", num);                        this.getContentResolver().call(Uri.parse("content://com.huawei.android.launcher.settings/badge/"), "change_badge", null, bunlde);    } catch (Exception e) {        mIsSupportedBade = false;    }}

非凡情景思考：

（1）对于第三利用关上和退出时，是否还持续显示角标取决于利用传递的值（badgenumber为0时，不显示角标；badgenumber大于0时，显示角标）。

（2）当第三方利用package和class发生变化时，需传递该变动后的信息。

（3）在调用角标接口前不肯定要当时获取桌面是否反对角标性能此性能。当桌面不反对角标性能时，接口会抛出异样，利用能够在调用接口的中央加上try … catch(Exception e) 语句免得程序解体。

二．HMS Core推送服务sdk桌面角标设置

Push Kit发送上行音讯接口中由BadgeNotification的三个参数决定了角标是否显示以及显示的数量：

在设置时须要留神以下5点：

1.class字段利用包名+利用入口Activity类名，如果传错角标则无奈展现

2.add_num字段要求emui版本8.0.0以上，推送服务版本8.0.0

3.set_num字段要求emui版本10.0.0以上，推送服务版本10.1.0

4.关上利用或者点击、清理告诉栏音讯并不会清理角标数，需利用在端侧参考角标开发领导去清理角标。

  1. “class“必填，“add_num”和”set_num”参数选填。

若“add_num”和“set_num”都设置为空，则利用角标数字默认加1

理解更多详情>>

拜访华为开发者联盟官网
获取开发领导文档
华为挪动服务开源仓库地址：GitHub、Gitee

关注咱们，第一工夫理解 HMS Core 最新技术资讯~