====== 好友管理 ======

更新时间：2021-12-31

新版文档见：[[ccim:android:relationship|用户关系管理]]。
----

===== 获取好友列表 =====

获取好友的 username list，开发者需要根据 username 去自己服务器获取好友的详情。

<code java>
List<String> usernames = EMClient.getInstance().contactManager().getAllContactsFromServer();
</code>

===== 查找好友 =====

SDK 不提供好友查找的服务，如需要查找好友，需要调用开发者自己服务器的用户查询接口。

为了保证查找到的好友可以添加，需要将开发者自己服务器的用户数据（用户的环信 ID），通过 SDK 的后台接口导入到环信服务器中。

===== 添加好友 =====

<code java>
//参数为要添加的好友的username和添加理由
EMClient.getInstance().contactManager().addContact(toAddUsername, reason);
</code>

===== 删除好友 =====

<code java>
EMClient.getInstance().contactManager().deleteContact(username);
</code>

===== 同意好友请求 =====

默认好友请求是自动同意的，如果要手动同意需要在初始化SDK时调用
''opptions.setAcceptInvitationAlways(false);'' 。

<code java>
EMClient.getInstance().contactManager().acceptInvitation(username);
</code>

===== 拒绝好友请求 =====

<code java>
EMClient.getInstance().contactManager().declineInvitation(username);
</code>

===== 监听好友状态事件 =====

<code java>
 EMClient.getInstance().contactManager().setContactListener(new EMContactListener() {
   
   @Override
   public void onContactAgreed(String username) {
       //好友请求被同意
   }
   
   @Override
   public void onContactRefused(String username) {
       //好友请求被拒绝
   }
   
   @Override
   public void onContactInvited(String username, String reason) {
       //收到好友邀请
   }
   
   @Override
   public void onContactDeleted(String username) {
       //被删除时回调此方法
   }
   
   
   @Override
   public void onContactAdded(String username) {
       //增加了联系人时回调此方法
   }
});
</code>

===== 黑名单 =====

==== 从服务器获取黑名单列表 ====

<code java>
EMClient.getInstance().contactManager().getBlackListFromServer();
</code>

==== 从本地db获取黑名单列表 ====

<code java>
EMClient.getInstance().contactManager().getBlackListUsernames();
</code>

==== 把用户加入到黑名单 ====

<code java>
//true和false的效果一样，都是我能给黑名单的中用户发消息，但是对方发给我时我是收不到的
EMClient.getInstance().contactManager().addUserToBlackList(username,true);
</code>

==== 把用户从黑名单中移除 ====

<code java>
EMClient.getInstance().contactManager().removeUserFromBlackList(username);
</code>


===== 获取同一账号在其他端登录的id =====
获取到该id 后可以用于不同端登录的账号之间互发消息，比如PC端与移动端可以互发消息。

<code java>
selfIds = EMClient.getInstance().contactManager().getSelfIdsOnOtherPlatform();
</code>
===== Demo 及 SDK 下载 =====

[[http://www.easemob.com/download/im|下载 Demo 及 SDK]]

详细文档请参考 [[im:android:sdk:apidoc|Java Doc]]


----
<WRAP group>
<WRAP half column>
上一页：[[im:android:basics:message|消息]]
</WRAP>

<WRAP half column>
下一页：[[im:android:basics:group|群组管理]]
</WRAP>
</WRAP>