数字角标使用说明_移动研发平台(EMAS)-阿里云帮助中心

如何在不同机型手机上适配数字角标。

前言

厂商支持说明

使用数字角标包含两个步骤：

第一步客户端配置

第二步服务端配置

重要

移动推送SDK V3.9.1及以上版本支持数字角标功能。

厂商支持说明

手机类型	自有通道	厂商通道	是否需要配置
华为	支持	支持	是
荣耀	支持	支持	是
小米	支持	支持	否
vivo	支持	不支持	是
oppo	不支持	不支持
魅族	不支持	不支持

说明

小米机型的角标数为应用在通知栏中的通知的数量。无法通过api设置角标数量。

第一步客户端配置

XML

<!--华为/荣耀Badge需要权限-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE " />
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE" />
<!--VIVO 角标需要权限-->
<uses-permission android:name="com.vivo.notification.permission.BADGE_ICON" />

说明

对华为/荣耀机型的角标支持，移动推送SDK只负责展示角标，角标的消除需要用户手动调用api完成。移除角标api请参考数字角标接口。
小米机型展示数字角标需要在设置中打开角标权限。

第二步服务端配置

服务端在发送通知时增加字段

关键字	类型	选项	含义	说明
AndroidBadgeAddNum	int	可选	设置角标累加值，在原角标的基础上进行累加	仅华为/荣耀厂商通道推送时有效 AndroidBadgeAddNum与AndroidBadgeSetNum同时存在，以AndroidBadgeSetNum为准
AndroidBadgeSetNum	int	可选	设置角标数字固定值	厂商通道推送时仅华为、荣耀通道生效。阿里云自有通道推送时仅华为机型、荣耀机型与vivo机型上生效。
AndroidBadgeClass	String	可选	应用入口Activity的全类名	仅华为/荣耀厂商通道推送时有效

说明

更详细字段说明请参考以下链接内容

请求参数

下发角标数据结构

JSON

{
  "AppKey": "******",
  "PushType": "NOTICE",
  "DeviceType": "ANDROID",
  "Target": "ACCOUNT",
  "TargetValue": "86",
  "StoreOffline": true,
  "Title": "通知标题",
  "Body": "通知正文",
  "AndroidOpenType": "APPLICATION",
  "AndroidPopupActivity": "******",
  "AndroidPopupTitle": "******",
  "AndroidPopupBody": "******",
  "AndroidNotificationChannel": "******",
  "AndroidTargetUserType": 1,
  "AndroidBadgeAddNum": 7,
  "AndroidBadgeClass": "******",
  "AndroidBadgeSetNum": 11
}