好友管理
本文档旨在指导开发者如何使用融云即时通讯 Web IMLib SDK 实现添加好友、删除好友、查看好友列表、管理好友等功能。
提示
此功能从 5.12.0 版本开始支持。
开通服务
使用此功能前,您须在控制台开通信息托管服务。
好友事件监听
好友事件监听器用于接收好友相关事件通知,包括:添加、删除、申请状态变更、清空好友、好友资料变更等。
监听返回的数据类型如下:
- 添加好友:IFriendAdd。
- 删除好友:IFriendDelete。
- 清空好友:
number
时间戳代表清空好友的时间。 - 好友申请状态:IFriendApplicationStatusChange。
- 好友信息变更多端同步:IFriendInfoChangedSync。
javascript
// 添加好友事件监听
RongIMLib.addEventListener(RongIMLib.Events.FRIEND_ADDED, (data) => {
// data 类型为 IFriendAdd
console.info('添加好友监听', data);
});
// 删除好友事件监听
RongIMLib.addEventListener(RongIMLib.Events.FRIEND_DELETE, (data) => {
// data 类型为 IFriendDelete
console.info('删除好友监听', data);
});
// 清空好友监听
RongIMLib.addEventListener(RongIMLib.Events.FRIEND_CLEARED, (data) => {
// data 类型为 number,时间戳代表清空好友的时间
console.info('清空全部好友监听', data);
});
// 好友申请监听
RongIMLib.addEventListener(RongIMLib.Events.FRIEND_APPLICATION_STATUS_CHANGED, (data) => {
// data 类型为 IFriendApplicationStatusChange
console.info('好友申请监听', data);
});
// 好友资料变更多端同步监听
RongIMLib.addEventListener(RongIMLib.Events.FRIEND_INFO_CHANGED_SYNC, (data) => {
// data 类型为 IFriendInfoChangedSync
console.info('【多端同步】好友信息监听', data);
});