Java | 如何实现 Android 应用的图标徽章

1 概述

当用户解锁手机时，他们经常会在一些应用程序图标的右上角看到一个红色的椭圆或圆圈。这个红色对象被称为应用程序图标徽章，其中的数字被称为徽章计数。

应用程序图标徽章直观地告诉用户一个应用程序中有多少未读消息，给用户一种紧迫感，并鼓励他们点击应用程序图标来阅读消息。如果使用得当，图标徽章可以帮助提高应用内信息的点击率，从而提高应用的用户粘性。

2 使用客户端 API 设置应用程序图标徽章

2.1 支持的平台

• 操作系统版本: EMUI 4.1或更新
• 华为家庭版: 6.3.29

2.2 代码实现

声明所需的权限

<uses - permission android: name = "android.permission.INTERNET" />
<uses - permission android: name = "com.huawei.android.launcher.permission.CHANGE_BADGE " />

将数据传递给 Huawei Home 应用程序，以显示指定应用程序的徽章。

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);

... 

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 值。(如果 badgenumber 值为0，则不显示徽章，如果 badgenumber 值大于0，则显示徽章。)

2)如果应用程序包或类发生变化，开发人员需要传递新的应用程序包或类。

3)在调用徽章 API 之前，开发者不需要检查华为家庭是否支持徽章功能。如果华为家庭不支持徽章功能，API 将抛出异常。开发人员可以将 try... catch (Exception e)语句添加到调用 API 的位置，以防止应用程序崩溃。

3 使用 Push SDK 设置应用程序图标徽章

Push Kit 使用 BadgeNotification 中的三个参数来设置是否显示徽章和徽章中显示的数字。

参数	强制性	类型	描述
add_num	Yes	integer	累计徽章编号，为1ー99的整数。例如，一个应用程序目前有 n 条未读消息。如果这个参数设置为3，那么每当收到包含这个参数的消息时，应用标记中显示的数字就会增加3，也就是说，这个数字等于 n + 3。
class	Yes	string	App package name+App entry activity 格式
set_num	Yes	integer	徽章编号，是一个从0到99的整数。例如，如果将该参数设置为10，则无论收到多少条消息，应用程序徽章中显示的数字都是10。如果 set_num 和 add_num 都设置了，那么 set_num 的值将被使用。