tencent cloud

For Android phones, the opened badge capabilities vary by vendor. The support of Tencent Push Notification Service for push badge is as detailed below for your reference.

Overview

Configuring the Server Delivery Badge

You can configure the server delivery badge in the Tencent Push Notification Service console or through the push API.

{
    "audience_type": "token",
    "expire_time": 3600,
    "message_type": "notify",
    "message":{
            "android": {
                    "badge_type": -2,
                    "clearable": 1,
                    "ring": 1,
                    "ring_raw": "xtcallmusic",
                    "vibrate": 1,
                    "lights": 1,
                    "action": {
                            "action_type": 1,
                            "activity": "com.qq.xg4all.JumpActivity",
                            "aty_attr": {
                            "if": 0,
                            "pf": 0
                    }
                    }
            },
            "title": "android test",
            "content": "android test 21"
    },
    "token_list": [
        "01f6ac091755a79015b4a30c9c4c7ddba1ea"
    ],
    "multi_pkg": true,
    "platform": "android",
}

General APIs for Terminals

API for setting the badge number (for SDK v1.2.0.1 or later)

This API allows you to set the badge number. It applies to Huawei, OPPO, and vivo phones. For OPPO phones, you need to apply for the badge display permission from OPPO.

/**
* @param context   //Application context
* @param setNum   //Set the badge number
* @since v1.2.0.1
*/
XGPushConfig.setBadgeNum(Context context, int setNum);

Example: When an in-app message is received, call XGPushConfig.setBadgeNum(context, 8) to set the badge number to 8.

API for resetting the badge number (for SDK v1.2.0.1 or later)

This API allows you to reset the badge number. It applies to Huawei, OPPO, and vivo phones. For OPPO phones, you need to apply for the badge display permission from OPPO.

/**
* @param context   //Application context
* @since v1.2.0.1
*/
XGPushConfig.resetBadgeNum(Context context);

Example: When an in-app message is read or an application is opened, call XGPushConfig.resetBadgeNum(context) to reset the badge number.

Note：

For notifications delivered through vendor channels, the badge number cannot be automatically decreased by 1 when the notifications are cleared. It is recommended that you call this API to clear the badge value when appropriate, for example, when re-opening the application from the desktop.

Huawei Phone Badge Adaptation Guide

Use limits

Badge display is supported by Huawei phones on EMUI 8.0 or later.
Limited by the openness of Huawei phone badge capabilities, the badge feature varies by push scenario as detailed below. Please use the Huawei phone badge feature as instructed.

Configuration

Applying for permission to set the in-app badge

To implement the correct badge modification effect, please first add the Huawei phone badge read/write permission for your application by adding the following permission configuration under the manifest tag in the AndroidManifest.xml file of the application:

<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE" />
<!-- Compatible on HONOR phones -->
<uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE" />

Setting the notification delivery badge

Be sure to enable the Huawei channel in the console and enter the Activity class, such as com.test.badge.MainActivity, of the application entry corresponding to the desktop icon in the parameter configuration area. Otherwise, the badge settings will not take effect.

Getting startup class name:

Drag and drop the packaged APK file into AndroidStudio. Enter the AndroidManifest.xml file in the package and search for the keywords "android.intent.category.LAUNCHER" in the file. The activity.name attribute found is the startup class name.

Setting badge number auto increase/decrease for Huawei phones

For Huawei phones, the badge number can be auto increased or decreased by 1. The API is as follows:

/**
* Huawei phone badge modification API
*
* @param context   //Application context
* @param changeNum   //Changed number, which is incremental. For example, if the previous badge number is 5 and this input parameter is 1, the badge number will be set to 6. 
*Valid values: 1 (badge number increased by 1); -1 (badge number decreased by 1)
*/
XGPushConfig.changeHuaweiBadgeNum(Context context, int changeNum);

Example: when an in-app message is received, call XGPushConfig.changeHuaweiBadgeNum(context, 1) to increase the badge number by 1; when the message badge needs to be dismissed, call XGPushConfig.changeHuaweiBadgeNum(context, -1) to decrease the badge number by 1.

vivo Phone Badge Adaptation Guide

Use limits

Limited by the openness of vivo phone badge capabilities, the badge number currently can only be directly configured but cannot be auto increased or decreased. The badge feature supports only notifications delivered through the Tencent Push Notification Service channel.

Configuration

Applying for permission to set the in-app badge

To implement the correct badge modification effect, please first add the vivo phone badge read/write permission for your application by adding the following permission configuration under the manifest tag in the AndroidManifest.xml file of the application:

<uses-permission android:name="com.vivo.notification.permission.BADGE_ICON" />

Enabling badge in phone settings

After successful permission configuration, the Badge option is disabled by default and needs to be manually enabled.
Enablement path: Settings > Notification & Status Bar > Notifications Management > Application Name > Badge
For applications without the badge feature, the Badge option is not provided.

Note：

For different OS versions, the name Badge can also be App icon badges or Desktop badges.