logo
当前页

订阅用户在线状态


功能简介

在一些场景中(如社交聊天、会议等),您可能需要订阅用户的在线状态,判断用户的状态是 在线,离线,还是登出。

本文介绍了如何使用 ZIM SDK 订阅用户在线状态。

前提条件

已在项目中集成了 ZIM SDK 并实现了基本收发消息的功能,详情请参考 快速开始 - 实现基本收发消息

获取用户在线状态

有以下两种方式可以获取用户在线状态: 实时获取用户在线状态

  • userA 通过 subscribeUsersStatus 接口订阅了 userB 的在线状态并且监听了 userB 的在线状态更新事件。
  • userB 的在线状态更新后(比如用户从在线状态变为离线状态),userA 会收到 onUserStatusUpdated 回调通知获取 userB 最新的在线状态。

主动查询用户在线状态

实现方式

订阅用户并监听已订阅用户的在线状态变更事件

说明
此方法适合实时获取已订阅用户的在线状态。

通过 subscribeUsersStatus 接口订阅需要关注在线状态的用户。

ZIMUserStatusSubscribeConfig config;
config.subscriptionDuration = 60 * 24; // 1 天
zim->subscribeUsersStatus({"userIdA", "userIdB"}, config, [](const std::vector<ZIMErrorUserInfo>& errorUserList, const ZIMError& errorInfo){
    
});

监听用户在线状态变更事件,已订阅用户的在线状态变更都将通过 onUserStatusUpdated 返回。

// 定义用户在线状态数据
std::unordered_map<std::string, ZIMUserStatus> myUserStatusMap;

// 用户状态更新回调
void onUserStatusUpdated(const std::vector<ZIMUserStatus>& userStatusList) {
    for (const auto& status : userStatusList) {
        myUserStatusMap[status.userID] = status;
    }
    // TODO: 刷新 UI
};

查询用户的在线状态

说明
此方法适合单次获取已订阅用户当前的在线状态。

通过 querySubscribedUserStatusList 接口可以主动查询已订阅用户的在线状态。

ZIMSubscribedUserStatusQueryConfig queryConfig;
queryConfig.userIDs = {"userIdA", "userIdB"};
zim->querySubscribedUserStatusList(queryConfig, [&](const std::vector<ZIMUserStatusSubscription>& subscriptions, const ZIMError& errorInfo){
    for (const auto& sub : subscriptions) {
        myUserStatusMap[sub.userStatus.userID] = sub.userStatus;
    }
    // TODO: 刷新 UI
});

Previous

自定义推送规则

Next

在聊天页面中渲染对话消息

当前页

返回到顶部