产品动态
公告
自定义角标
支持厂商
华为。
配置方法
控制台配置华为角标参数为应用的启动类，例如 “com.tencent.qcloud.tim.demo.SplashActivity”。组件会自动解析和更新角标；反之不会更新角标。
默认情况下，当 App 进入后台后，ChatSDK 会将当前 Chat 未读消息总数设置为角标。如果 App 接入了离线推送，当接收到新的离线推送时，App 角标会在基准角标（默认是 Chat 未读消息总数，如果自定义了角标，则以自定义角标为准）的基础上加 1 逐条递增。
配置方法
如果想自定义角标，可按照如下步骤设置：
1. App 调用 - (void)setAPNSListener:(id<V2TIMAPNSListener>)apnsListener 接口设置监听。
2. App 实现 - (uint32_t)onSetAPPUnreadCount 接口，并在内部返回需要自定义的角标。
// 1. 设置监听- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {// 监听推送[V2TIMManager.sharedInstance setAPNSListener:self];// 监听会话的未读数[[V2TIMManager sharedInstance] setConversationListener:self];return YES;}// 2. 未读数发生变化后保存未读数- (void)onTotalUnreadMessageCountChanged:(UInt64)totalUnreadCount {self.unreadNumber = totalUnreadCount;}// 3. App 推到后台后上报自定义未读数/** 程序进后台后，自定义 App 的未读数，如果不处理，App 未读数默认为所有会话未读数之和* <pre>** - (uint32_t)onSetAPPUnreadCount {* return 100; // 自定义未读数* }** </pre>*/- (uint32_t)onSetAPPUnreadCount {// 1. 获取自定义的角标uint32_t customBadgeNumber = ...// 2. 加上 IM 的消息未读数customBadgeNumber += self.unreadNumber;// 3. 通过 IMSDK 上报给 IM 服务器return customBadgeNumber;}
import ImSDK_Plusclass AppDelegate: UIResponder, UIApplicationDelegate, V2TIMAPNSListener, V2TIMConversationListener {// 存储未读数var unreadNumber: UInt64 = 0// 1. 设置监听func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {// 监听推送V2TIMManager.sharedInstance()?.setAPNSListener(self)// 监听会话的未读数V2TIMManager.sharedInstance()?.setConversationListener(self)return true}// 2. 未读数发生变化后保存未读数func onTotalUnreadMessageCountChanged(_ totalUnreadCount: UInt64) {self.unreadNumber = totalUnreadCount}// 3. App 推到后台后上报自定义未读数/// 程序进后台后，自定义 App 的未读数，如果不处理，App 未读数默认为所有会话未读数之和/// - Returns: 自定义未读数func onSetAPPUnreadCount() -> UInt32 {// 1. 获取自定义的角标var customBadgeNumber: UInt32 = 0 // ... 替换为你的自定义逻辑// 2. 加上 IM 的消息未读数customBadgeNumber += UInt32(self.unreadNumber)// 3. 通过 IMSDK 上报给 IM 服务器return customBadgeNumber}}
请参见 Android 和 iOS 进行配置即可。调用的方法均在 Flutter 版本的 IM SDK 中有同名方法。
支持厂商
华为。
配置方法
步骤1. 控制台配置华为角标参数为应用的启动类。
说明：
uniapp 应用的启动类为
io.dcloud.PandoraEntry。
步骤2. 监听 Chat SDK 未读总数变化自行设置角标数量。
1. 通过 TOTAL_UNREAD_MESSAGE_COUNT_UPDATED 监听 Chat SDK 会话未读总数更新。
2. 通过
plus.runtime.setBadgeNumber 设置角标数量。let onTotalUnreadMessageCountUpdated = function(event) {const unreadCount = event.data; // 当前会话的未读总数plus.runtime.setBadgeNumber(unreadCount); // 设置角标数量};chat.on(TencentCloudChat.EVENT.TOTAL_UNREAD_MESSAGE_COUNT_UPDATED, onTotalUnreadMessageCountUpdated);
文档反馈