上云无忧 > 文档中心 > 环信IM即时通讯使用教程(Android) - 管理用户关系
IM即时通讯
环信IM即时通讯使用教程(Android) - 管理用户关系

文档简介:
用户登录后,可进行添加联系人、获取好友列表等操作。 SDK 提供用户关系管理功能,包括好友列表管理和黑名单管理: 好友列表管理:查询好友列表、申请添加好友、同意好友申请、拒绝好友申请和删除好友等操作。 黑名单管理:查询黑名单列表、添加用户至黑名单以及将用户移除黑名单等操作。
*此产品及展示信息均由环信官方提供。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

用户登录后,可进行添加联系人、获取好友列表等操作。

SDK 提供用户关系管理功能,包括好友列表管理和黑名单管理:

  • 好友列表管理:查询好友列表、申请添加好友、同意好友申请、拒绝好友申请和删除好友等操作。
  • 黑名单管理:查询黑名单列表、添加用户至黑名单以及将用户移除黑名单等操作。

本文介绍如何通过环信即时通讯 IM SDK 管理好友关系。

技术原理

环信即时通讯 IM Android SDK 提供 EMContactManager 类实现好友的添加移除,黑名单的添加移除等功能。主要方法如下:

  • addContact 申请添加好友。
  • acceptInvitation 同意好友申请。
  • declineInvitation 拒绝好友申请。
  • deleteContact 删除好友。
  • getAllContactsFromServer 从服务器获取好友列表。
  • addUserToBlackList 添加用户到黑名单。
  • removeUserFromBlackList 将用户从黑名单移除。
  • getBlackListFromServer 从服务器获取黑名单列表。

前提条件

开始前,请确保满足以下条件:

  • 完成 SDK 初始化,并连接到服务器,详见 快速开始。
  • 了解环信即时通讯 IM 的使用限制,详见 使用限制。

实现方法

本节展示如何在项目中管理好友的添加移除和黑名单的添加移除。

添加好友

好友申请部分主要功能是发送好友请求、接收好友请求、处理好友请求和好友请求处理结果回调等。

  1. 申请指定用户添加好友

示例代码如下:

// 添加好友。 // 同步方法,会阻塞当前线程。异步方法为 asyncAddContact(String, String, EMCallBack)。
 EMClient.getInstance().contactManager().addContact(toAddUsername, reason); 
 

  1. 添加监听

请监听与好友请求相关事件的回调,这样当用户收到好友请求,可以调用接受请求的 RESTful API 添加好友。服务器不会重复下发与好友请求相关的事件,建议退出应用时保存相关的请求数据。设置监听示例代码如下:

EMClient.getInstance().contactManager().setContactListener(new EMContactListener() { // 对方同意了好友请求。
 @Override public void onFriendRequestAccepted(String username) { } // 对方拒绝了好友请求。
 @Override public void onFriendRequestDeclined(String username) { } // 接收到好友请求。
 @Override public void onContactInvited(String username, String reason) { } // 联系人被删除。
 @Override public void onContactDeleted(String username) { } // 联系人已添加。
@Override public void onContactAdded(String username) { } }); 
 

  1. 收到好友请求后,可以选择同意加好友申请或者拒绝加好友申请,示例代码如下:

// 同意好友申请。 // 同步方法,会阻塞当前线程。异步方法为 asyncAcceptInvitation(String, EMCallBack)。
 EMClient.getInstance().contactManager().acceptInvitation(username); // 拒绝好友申请。 // 同步方法,
会阻塞当前线程。异步方法为 asyncDeclineInvitation(String, EMCallBack)。 EMClient.getInstance().
contactManager().declineInvitation(username); 
 

当你同意或者拒绝后,对方会通过好友事件回调,收到 onContactAgreed 或者 onContactRefused。

删除好友

删除联系人时会同时删除对方联系人列表中的该用户,建议执行双重确认,以免发生误删操作。删除操作不需要对方同意或者拒绝。

示例代码如下:

// 同步方法,会阻塞当前线程。 // 异步方法为 asyncDeleteContact(String, EMCallBack)。 EMClient.
getInstance().contactManager().deleteContact(username); 
 

调用 deleteContact 删除好友后,对方会收到 onContactDeleted 回调。

获取好友列表

你可以从服务器获取好友列表,也可以从本地数据库获取已保存的好友列表。

注意

需要从服务器获取好友列表之后,才能从本地数据库获取到好友列表。

示例代码如下:

// 从服务器获取好友列表。 // 同步方法,会阻塞当前线程。异步方法为 asyncGetAllContactsFromServer
(EMValueCallBack)。 List<String> usernames = EMClient.getInstance().contactManager().
getAllContactsFromServer(); // 从本地数据库获取好友列表。 List<String> usernames = EMClient.
getInstance().contactManager().getContactsFromLocal(); 
 

添加用户到黑名单

将指定用户加入黑名单后,对方将无法给你发送消息。黑名单部分主要功能是获取黑名单列表、添加用户至黑名单以及将用户从黑名单移除等。获取黑名单时,可从服务器获取黑名单列表,也可从本地数据库获取已保存的黑名单列表。

黑名单是与好友无任何关系的独立体系。可以将任何用户加入黑名单,不论该用户与你是否是好友关系。好友加入黑名单后仍在好友列表上显示。

你可以调用 addUserToBlackList 添加用户到黑名单,示例代码如下:

// 同步方法,会阻塞当前线程。 // 异步方法为 asyncAddUserToBlackList(String, boolean, EMCallBack)。
 EMClient.getInstance().contactManager().addUserToBlackList(username,true); 
 

将用户从黑名单移除

你可以调用 removeUserFromBlackList 将用户从黑名单移除,示例代码如下:

// 同步方法,会阻塞当前线程。 // 异步方法为 asyncRemoveUserFromBlackList(String, EMCallBack)。
 EMClient.getInstance().contactManager().removeUserFromBlackList(username); 
 

查看当前用户黑名单列表

从服务器获取黑名单列表

你可以调用 getBlackListFromServer 从服务端获取黑名单列表。示例代码如下:

// 同步方法,会阻塞当前线程。 // 异步方法为 asyncGetBlackListFromServer(EMValueCallBack)。 
EMClient.getInstance().contactManager().getBlackListFromServer(); 
 

从本地数据库获取黑名单列表

从服务器获取黑名单列表之后,才能从本地数据库获取到黑名单列表。

示例代码如下:

EMClient.getInstance().contactManager().getBlackListUsernames();
相似文档
  • 功能描述: 群组是支持多人沟通的即时通讯系统,成员关系相对稳定。所有群成员可以收到群中的消息,可以在群中发送消息。群成员离线时可以收到推送消息。群组成员支持多种角色:群主、群管理员和普通成员。群组提供丰富的管理能力,如群组禁言、群公告和群文件等。
  • 群组是支持多人沟通的即时通讯系统,本文介绍如何使用环信即时通讯 IM SDK 在实时互动 app 中创建和管理群组,并实现群组相关功能。 如需查看消息相关内容,参见 消息管理。
  • 群组是支持多人沟通的即时通讯系统,本文指导你如何使用环信即时通讯 IM SDK 在实时互动 app 中实现群组成员管理相关功能。 技术原理: 环信即时通讯 IM Android SDK 提供 EMGroupManager 类和 EMGroup 类用于群组管理,支持你通过调用 API 在项目中实现如下功能:
  • 群组是支持多人沟通的即时通讯系统,本文指导你如何使用环信即时通讯 IM Android SDK 在实时互动 app 中实现群组属性相关功能。
  • 功能描述: 聊天室是支持多人加入的类似 Twitch 的组织。聊天室中的成员没有固定关系,用户离线后,超过 5 分钟会自动退出聊天室。聊天室成员在离线后,不会收到推送消息。聊天室可以应用于直播、消息广播等。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部