好友功能

本文介绍RTM基础功能中的好友功能,您可以了解好友功能的使用方法等内容。

功能简介

RTM提供了好友功能来为私聊、群聊、聊天室等业务场景提供好友关系管理功能,同时已有的好友关系也可以同步给RTM,用于管理。以下为好友功能的完整功能和描述。

功能 描述
添加好友 通过RTM客户端SDK添加用户为好友关系
删除好友 通过RTM客户端SDK删除用户的好友关系
获取好友关系 获取用户的好友列表
判断用户好友关系情况 判断两个用户之间是否为好友关系
设置用户黑名单 设置用户到黑名单中
移除用户黑名单 移除用户黑名单中的用户
获取黑名单列表 获取用户的黑名单列表
判断用户黑名单情况 判断用户是否在其他用户的黑名单中

控制台好友验证功能相关配置

控制台提供针对好友功能的相关开关,包括 “P2P消息好友验证” 和 “P2P消息黑名单验证”。

请参考:控制台操作-RTM项目创建和配置-设置项目消息

  • 当开启 “P2P消息好友验证” 后,则只有用户建立好友关系后才可以彼此发送P2P聊天。
  • 当开启 “P2P消息黑名单验证” 后,如果用户A将用户B加入黑名单,则用户A可以向用户B发送消息,用户B无法向用户A发送消息。用户A和用户B可以生成会话并获取历史消息。

控制台好友功能相关配置

功能详情

添加好友

使用RTM客户端SDK添加好友

如果项目未开启“P2P消息好友验证”开关,任何项目用户之间均可以发送P2P聊天。

删除好友

使用RTM客户端SDK删除好友

只有当用户和另一用户之间是好友关系时,才可以删除好友。

获取好友关系

使用RTM客户端SDK和RTM服务端SDK获取用户的好友列表

使用RTM客户端SDK获取好友关系功能时,用户只能获取自己的好友列表。

判断用户好友关系情况

使用RTM服务端SDK判断两个用户之间是否是好友关系

RTM服务端SDK支持批量操作判断用户好友关系情况。

设置用户黑名单

RTM提供用户黑名单,当用户被添加到其他用户黑名单中,该用户将无法向其他用户发送消息,其他用户可以向该用户发送消息。

使用"设置用户黑名单"功能,需在控制台操作-RTM项目创建和配置-设置项目消息中将 “P2P消息黑名单验证” 功能开启。

移除用户黑名单

RTM提供移除用户黑名单,当用户被移除出其他用户黑名单后,该用户可以向其他用户正常收发消息。

使用"移除用户黑名单"功能,需在控制台操作-RTM项目创建和配置-设置项目消息中将 “P2P消息黑名单验证” 功能开启。

获取黑名单列表

使用RTM客户端SDK和RTM服务端SDK获取用户的黑名单列表

使用RTM客户端SDK获取黑名单列表功能时,用户只能获取用户自己的黑名单列表。

判断用户黑名单情况

使用RTM服务端SDK判断用户是否被添加到其他用户黑名单中