如何实现数字角标 |
您所在的位置：网站首页 › 华为图标角标设置在哪 › 如何实现数字角标 |
如何实现数字角标
| 如何实现数字角标
通道支持说明
由于不同手机系统的限制，仅部分通道支持角标展示，支持情况如下： 手机类型 极光通道 厂商通道 是否需要配置 iOS - 支持 是 华为 支持 支持 是 荣耀 支持 支持 是 小米 支持 支持 否 vivo 支持 不支持 是 OPPO 不支持 不支持 - 魅族 不支持 不支持 -注意：仅 JPush SDK 4.4.0 及以上版本支持 vivo 角标。 iOS 角标JPush 封装 badge 功能，允许应用上传 badge 值至 JPush 服务器，由 JPush 后台帮助管理每个用户所对应的推送 badge 值，简化了设置推送 badge 的操作。 支持的版本开始支持的版本：1.7.4 上传本地角标值设置 JPush 服务器中存储的 badge 值，接口如下： + (BOOL)setBadge:(int)value + (BOOL)setBadge:(int)value 此代码块在浮窗中显示 value 取值范围：[0,99999] 本地仍须调用 [application setApplicationIconBadgeNumber:0] 函数设置图标上显示的 badge 值。 服务端设置服务端推送时需要在 ios 字段下设置 badge 值。 关键字 类型 选项 含义 说明 badge int 可选 应用角标 可设置为 N、+N、-N，N 的取值范围为 [0,99]。若上传的角标值 value 为 10，表示角标会设置为 N、10+N、10-N（值小于 0 时默认清除角标）。为 0 或空字符串，则表示清除角标。如果不填，表示不改变角标数字。JPush 官方服务端 SDK 会默认填充 badge 值为 "+1"，详情参考：badge +1。 //服务端发送 json 消息串 { "notification": { "ios": { "alert": "hello, JPush!", "badge": "+1" //可传值为N，+N，-N， 0表示清除。 } } } //服务端发送 json 消息串 { "notification": { "ios": { "alert": "hello, JPush!", "badge": "+1" //可传值为N，+N，-N， 0表示清除。 } } } 此代码块在浮窗中显示 清除角标1.点击通知时，客户端需要调用原生接口 setApplicationIconBadgeNumber 清除本地角标显示值。 - (void)applicationWillEnterForeground:(UIApplication *)application { [application setApplicationIconBadgeNumber:0]; [application cancelAllLocalNotifications]; } - (void)applicationWillEnterForeground:(UIApplication *)application { [application setApplicationIconBadgeNumber:0]; [application cancelAllLocalNotifications]; } 此代码块在浮窗中显示2.清空 JPush 服务器中存储的 badge 值，即 [setBadge:0]，接口如下： + (void)resetBadge + (void)resetBadge 此代码块在浮窗中显示 华为/荣耀角标 支持的版本华为开始支持的版本：3.3.6 荣耀开始支持的版本：4.7.0 客户端配置华为设备 EMUI 8.0 及以上、荣耀设备 Magic UI 5.0+ 支持数字角标展示，需要在 AndroidManifest.xml 里配置指定的权限 ： 此代码块在浮窗中显示 控制台设置若集成了厂商通道，需要在【消息推送】-【推送设置】-【集成设置】-【华为/荣耀】点击编辑配置应用入口 Activity 类。注意必须是应用入口 Activity 类，且荣耀和华为厂商配置一致，否则无法显示角标。 完成客户端和控制台配置后，服务端推送时在 android 字段下配置 badge_class、badge_add_num 或 badge_set_num 字段，则可显示角标。 badge_add_num 表示设置角标数字累加值，在原角标的基础上进行累加。 badge_set_num 表示设置角标数字固定值。 关键字 类型 选项 含义 说明 badge_add_num int 可选 设置角标数字累加值，在原角标的基础上进行累加 此属性目前仅针对华为 EMUI 8.0 及以上、小米 MIUI 6 及以上、vivo、荣耀设备生效。 此字段如果不填，表示不改变角标数字。 取值范围为：1-99，若设置了取值范围内的数字，下一条通知栏消息配置的 badge_add_num 数据会和原角标数量进行相加，建议取值为 1。 举例：badge_add_num 取值为 1，原角标数为 2，发送此角标消息后，应用角标数显示为 3。 针对华为 / 荣耀通道，如果 badge_set_num 与 badge_add_num 同时存在，则以 badge_set_num 为准。 badge_set_num int 可选 设置角标数字固定值 此属性目前仅针对华为 EMUI 8.0 及以上、荣耀设备走厂商通道时生效，如果 badge_set_num 与 badge_add_num 同时存在，则以 badge_set_num 为准。 取值范围为：0-99，若设置了取值范围内的数字，对应下一条通知栏消息配置的 badge_set_num 数字则为角标数值，举例：badge_set_num 取值为 1，无论应用之前角标数为多少，发送此角标消息后，应用角标数均显示为 1。 badge_class string 可选 桌面图标对应的应用入口 Activity 类， 比如“com.test.badge.MainActivity” 仅华为和荣耀通道推送时生效，此值如果填写非主 Activity 类，以厂商限制逻辑为准。若需要实现角标累加功能，需配合 badge_add_num 使用，二者需要共存，缺少其一不可。若需要实现角标固定值功能，需配合 badge_set_num 使用，二者需要共存，缺少其一不可。 //服务端发送 json 消息串 { "notification": { "android": { "alert": "hello, JPush!", "badge_add_num": 1, //角标增加值，取值范围1-99 "badge_set_num": 1, //角标固定值，取值范围0-99 "badge_class": "com.test.badge.MainActivity", //默认为 APP 的主 Activity } } } //服务端发送 json 消息串 { "notification": { "android": { "alert": "hello, JPush!", "badge_add_num": 1, //角标增加值，取值范围1-99 "badge_set_num": 1, //角标固定值，取值范围0-99 "badge_class": "com.test.badge.MainActivity", //默认为 APP 的主 Activity } } } 此代码块在浮窗中显示 清除角标点击通知时，客户端需要手动清除角标数： 接口定义 public static void setBadgeNumber(Context context, int num) public static void setBadgeNumber(Context context, int num) 此代码块在浮窗中显示 参数说明 context 是应用的 ApplicationContext num 新的角标数字，传入负数将会修正为0示例如下： JPushInterface.setBadgeNumber(this,0); JPushInterface.setBadgeNumber(this,0); 此代码块在浮窗中显示 小米角标小米 MIUI 6 及以上设备支持数字角标，小米系统自动处理数字角标展示功能，默认收到通知+1处理，打开 App 清零。 vivo 角标vivo 设备仅支持走极光通道时可以显示角标。 支持版本开始支持的版本：4.4.5 客户端配置1.vivo 需要在 AndroidManifest.xml 里配置指定的权限： /> /> 此代码块在浮窗中显示2.“桌面图标角标”默认关闭，需要用户手动开启。 开启路径：“设置”-“通知与状态栏”-“应用通知管理”-应用名称-“桌面图标角标”。 未成功接入“桌面图标角标”的应用，无“桌面图标角标”选项。 视OS版本差异，“桌面图标角标”名称可能为“应用图标标记”或“桌面角标”。3.只有走极光通道，有 onNotifyMessageArrived 回调的前提下，角标才可生效。 服务端设置完成客户端配置后，服务端推送时在 android 字段下配置 badge_add_num 和 badge_class 字段，则可显示角标。 关键字 类型 选项 含义 说明 badge_add_num int 可选 角标数字，取值范围1-99 此字段如果不填，表示不改变角标数字； 若设置了取值范围内的数字，下一条通知栏消息配置的 badge_add_num 数据会和之前角标数量进行增加。建议 badge_add_num 配置为1； 举例：badge_add_num 配置1，应用之前角标数为2，发送此角标消息后，应用角标数显示为3。 //服务端发送 json 消息串 { "notification": { "android": { "alert": "hello, JPush!", "badge_add_num": 1, //角标增加值，取值范围1-99 "badge_class": "com.test.badge.MainActivity", //默认为 APP 的主 Activity } } } //服务端发送 json 消息串 { "notification": { "android": { "alert": "hello, JPush!", "badge_add_num": 1, //角标增加值，取值范围1-99 "badge_class": "com.test.badge.MainActivity", //默认为 APP 的主 Activity } } } 此代码块在浮窗中显示 清除角标点击通知时，客户端需要手动清除角标数： 接口定义 public static void setBadgeNumber(Context context, int num) public static void setBadgeNumber(Context context, int num) 此代码块在浮窗中显示 参数说明 context 是应用的 ApplicationContext num 新的角标数字，传入负数将会修正为0示例如下： JPushInterface.setBadgeNumber(this,0); JPushInterface.setBadgeNumber(this,0); 此代码块在浮窗中显示 |
【本文地址】
公司简介
联系我们
今日新闻 |
点击排行 |
|
推荐新闻 |
图片新闻 |
|
专题文章 |