• UIKit
  • SDK
  • 服务端 API
Chat/
UIKit/
Android/
功能/
UIKit
  • 界面库介绍
  • Run Demo
  • 快速开始
  • 集成组件
    • TUIKit
    • TUIChat
  • 构建基础界面
    • 聊天界面
    • 会话列表
    • 联系人列表
    • 添加联系人
    • 创建群聊
    • 音视频通话
  • 功能
    • 表情回应
    • 消息引用
    • 已读回执
    • 用户在线状态
    • 文本消息翻译
    • 语音转文本
    • 搜索消息
  • 自定义
    • 自定义消息
    • 自定义表情
  • 本地化
  • 更新日志
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

用户在线状态

功能描述

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

开启会话列表用户在线状态

TUIConversation 组件的 TUIConversationConfig.java 文件中提供了“用户在线状态”功能开关 isShowUserStatus, 其类型为 boolean,默认为 false 。
public class TUIConversationConfig {
private boolean isShowUserStatus;
}
如果想开启会话列表展示用户在线状态功能,首先请开通进阶套餐包,然后在 Chat 控制台 打开用户状态功能的开关,再将 isShowUserStatus 的默认值改为 true ,或者在会话页面初始化之前调用以下方法来开启。
TUIConversationConfig.getInstance().setShowUserStatus(true);

会话列表效果

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



开启联系人列表用户在线状态

TUIContact 组件的 TUIContactConfig.java 文件中提供了“用户在线状态”功能开关 isShowUserStatus , 其类型为 boolean,默认为 false 。
public class TUIContactConfig {
private boolean isShowUserStatus;
}
如果想开启联系人列表展示用户在线状态功能,首先请开通进阶套餐包,然后在 Chat 控制台 打开用户状态功能的开关,再将 isShowUserStatus 的默认值改为 true ,或者在联系人列表页面初始化之前调用以下方法来开启。
TUIContactConfig.getInstance().setShowUserStatus(true);

联系人列表效果

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



常见问题

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

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




Error: 套餐包不支持该接口的使用,请升级到进阶版套餐。

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

交流与反馈

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