用户功能
更新时间:
本文介绍RTM基础功能中的用户功能，您可以了解用户功能的使用方法等内容。
功能简介
RTM提供了用户功能来为私聊、群聊、聊天室等业务场景提供用户信息管理类功能。以下为用户功能的完整功能和描述。
功能
描述
获取在线用户
获取项目/群组中的用户列表中的在线用户
设置用户信息
设置用户的公有信息和私有信息
获取用户信息
获取用户的公有信息或全部信息
设置项目黑名单用户
设置用户到项目黑名单中
移除项目黑名单用户
从项目黑名单中移除用户
判断用户黑名单情况
判断用户是否在项目黑名单中
功能详情
获取在线用户
使用RTM客户端SDK和RTM服务端SDK获取项目/群组中当前在线用户列表
使用RTM客户端SDK获取群组当前在线成员列表时，当前登录RTM客户端SDK用户必须为群组成员。
设置用户信息
用户信息包括用户公有信息和用户私有信息：
- 公有信息是用户的公开信息，任何项目中的成员都可以获取。用户公有信息 包括：用户名称、用户头像等内容。
- 私有信息是用户的非公开信息，仅允许用户本人设置。用户私有信息包括：用户私有数据等内容。
使用RTM客户端SDK设置用户信息功能时，用户只能设置用户自己的公有信息和私有信息。
获取用户信息
使用RTM客户端SDK和RTM服务端SDK获取用户信息
使用RTM客户端SDK获取用户信息功能时，用户只能获取其他用户的公有信息。
设置项目黑名单用户
RTM提供项目黑名单，当用户被添加到项目黑名单中，该用户将无法登录RTM服务，也无法收发消息，请参考：控制台操作-RTM项目创建和配置-设置项目信息。
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。
移除项目黑名单用户
RTM提供移除项目黑名单，当用户被移除出项目黑名单后，该用户可以登录RTM服务，并可以正常收发消息。
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。
判断用户黑名单情况
使用RTM服务端判断用户是否被添加到项目黑名单中
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。
本文介绍RTM基础功能中的用户功能，您可以了解用户功能的使用方法等内容。
功能简介
RTM提供了用户功能来为私聊、群聊、聊天室等业务场景提供用户信息管理类功能。以下为用户功能的完整功能和描述。
| 功能 | 描述 |
|---|---|
| 获取在线用户 | 获取项目/群组中的用户列表中的在线用户 |
| 设置用户信息 | 设置用户的公有信息和私有信息 |
| 获取用户信息 | 获取用户的公有信息或全部信息 |
| 设置项目黑名单用户 | 设置用户到项目黑名单中 |
| 移除项目黑名单用户 | 从项目黑名单中移除用户 |
| 判断用户黑名单情况 | 判断用户是否在项目黑名单中 |
功能详情
获取在线用户
使用RTM客户端SDK和RTM服务端SDK获取项目/群组中当前在线用户列表
使用RTM客户端SDK获取群组当前在线成员列表时，当前登录RTM客户端SDK用户必须为群组成员。
设置用户信息
用户信息包括用户公有信息和用户私有信息：
- 公有信息是用户的公开信息，任何项目中的成员都可以获取。用户公有信息 包括：用户名称、用户头像等内容。
- 私有信息是用户的非公开信息，仅允许用户本人设置。用户私有信息包括：用户私有数据等内容。
使用RTM客户端SDK设置用户信息功能时，用户只能设置用户自己的公有信息和私有信息。
获取用户信息
使用RTM客户端SDK和RTM服务端SDK获取用户信息
使用RTM客户端SDK获取用户信息功能时，用户只能获取其他用户的公有信息。
设置项目黑名单用户
RTM提供项目黑名单，当用户被添加到项目黑名单中，该用户将无法登录RTM服务，也无法收发消息，请参考：控制台操作-RTM项目创建和配置-设置项目信息。
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。
移除项目黑名单用户
RTM提供移除项目黑名单，当用户被移除出项目黑名单后，该用户可以登录RTM服务，并可以正常收发消息。
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。
判断用户黑名单情况
使用RTM服务端判断用户是否被添加到项目黑名单中
使用项目黑名单用户功能，需要提前为项目将“允许黑名单过滤” 功能开启。请参考：控制台操作-RTM项目创建和配置-设置项目信息。