Docs Overview/
Chat/
UIKit/
iOS 和 macOS/
功能/
用户在线状态/

用户在线状态

功能描述

TUIKit 从 6.5.2803 版本开始支持用户在线状态展示。
开启“显示用户在线状态” 后，会在会话列表和联系人列表的用户头像上显示用户的在线状态。当绿圈出现时表示对方在线，没有绿圈则表示对方当前离线。
关闭“显示用户在线状态” 时，不再显示好友的用户在线状态。
注意：
“用户在线状态”功能仅专业版、专业版plus或企业版套餐支持，使用前请确认已开通专业版、专业版plus或企业版套餐。
“用户在线状态”功能需要在 Chat 控制台 打开用户状态开关，使用前请确认开关已经打开。

开启用户在线状态

在 TUICore 组件的 TUIConfig 文件中提供了“用户在线状态”功能开关 displayOnlineStatusIcon, 其类型为 BOOL，默认为 NO 。
- (id)init
{
self = [super init];
if(self){
//...其他配置
self.displayOnlineStatusIcon = NO;
}
return self;
}
如果想开启会话列表展示用户在线状态功能，首先请开通进阶套餐包，然后在 Chat 控制台 打开用户状态功能的开关，再将 displayOnlineStatusIcon 的默认值改为 YES ，或者在会话页面初始化之前调用以下方法来开启。
[TUIConfig defaultConfig].displayOnlineStatusIcon = YES;

效果展示

会话列表

Enabling "Show User Online Status"
Disabling "Show User Online Status"



联系人列表

开启“显示用户在线状态”
关闭“显示用户在线状态”



常见问题

调用订阅/取消订阅接口时，接口提示 “72001” 的错误码。

72001 错误码表示在控制台上并没有开启对应的能力，请登录 Chat 控制台 打开对应的功能开关。




Error: 套餐包不支持该接口的使用，请升级到专业版、专业版plus或企业版套餐。

“用户在线状态”功能仅专业版、专业版plus或企业版套餐包支持，该报错信息表示您当前的套餐包不支持此能力，请登录 Chat 购买页 开通专业版、专业版plus或企业版套餐包进行体验。

交流与反馈

加入Telegram 技术交流群组或 WhatsApp 交流群，享有专业工程师的支持，解决您的难题。