【FAQ】HMS Core推送服务推送角标的开发及常见问题解答
目录
1、发送消息并显示桌面数字角标。
2、如何清除数字角标?
3、如何设置圆点角标?
4、应用桌面图标角标开关无法开启或未显示开关。
5、推送消息设置了角标字段但未显示角标?
6、未设置角标参数,但收到消息后显示了角标。
解决方案
Q1:发送消息并显示桌面数字角标。
实现设备收到消息后显示数字角标业务,需要在发送消息时设置角标 “badge”字段,请参考以下示例及说明。
消息体示例:
{
"validate_only": false,
"message": {
"android": {
"notification": {
"title": "test title",
"body": "test body",
"click_action": {
"type": 3
},
"badge": {
"add_num": 1,
"class": "com.zrgj.push.activity.MainActivity",
"set_num": 10
}
}
},
"token": ["pushtoken1"]
}
}
参数说明:
“add_num”:应用角标累加数字,在已有的角标数量上累加。参数为大于0小于100的整数。
“class”:设置角标路径,参数为应用入口Activity类的全路径。样例:com.example.hmstest.MainActivity
“set_num”:设置角标数字,指定角标为设置的数量。
注意事项:
“add_num”与“set_num”字段使用其一即可,如果同时设置以set_num为准。
Q2:如何清除数字角标?
数字角标和通知消息没有关联,打开应用或者点击、清理通知栏消息并不会清理角标数字或圆点,客户端可配合业务需求使用以下方法清除。
示例代码:
Bundle extra = new Bundle();
extra.putString("package", "xxxxxx");//应用包名
extra.putString("class", "yyyyyyy");//应用入口Activity类全路径
extra.putInt("badgenumber", i);//i为0即可清除
context.getContentResolver().call(Uri.parse("content://com.huawei.android.launcher.settings/badge/"), "change_badge", null, extra);
Q3:如何设置圆点角标?
圆点角标无需开发配置,圆点角标和通知栏消息相关联,通知栏中有应用消息圆点是清除不了的,如果通知栏没有应用消息则圆点会自动清除掉。
开启方式:
圆点角标需手动开启,以HarmonyOS 3.0系统举例:设置->通知和状态栏->桌面图标角标->角标显示方式(数字角标/圆点角标)。
Q4:应用桌面图标角标开关无法开启或未显示开关。
这种情况说明未成功设置过角标,只有成功设置桌面角标后才可以开启或显示开关。
Q5:推送消息设置了角标字段但未显示角标?
1、检查是否同时设置了set_num为0,同时配置“add_num”与“set_num”以set_num数量为准。
2、检查“class”字段参数是否正确,参数为应用入口Activity类的全路径。(易错)
例如:com.huawei.codelabpush.MainActivity。
<activity android:name="com.huawei.codelabpush.MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
Q6:未设置角标参数,但收到消息后显示了角标。
检查是否只设置了“class”字段,设置了“class”字段“add_num”和“set_num”都设置为空,则应用角标数字默认累加1。
例如:
"badge":{
"class":" com.huawei.codelabpush.MainActivity"
}
了解更多详情>>
关注我们,第一时间了解 HMS Core 最新技术资讯~