hyphenate_SDK3.0 3.9.9.2
hyphenate java IM SDK
| Public 成员函数 | 所有成员列表
com.hyphenate.chat.EMContactManager类 参考

class  EMAContactListenerImpl
 

Public 成员函数

void addContact (String username, String reason) throws HyphenateException
 
void asyncAddContact (final String username, final String reason, final EMCallBack callback)
 
void deleteContact (String username) throws HyphenateException
 
void deleteContact (String username, boolean keepConversation) throws HyphenateException
 
void asyncDeleteContact (final String username, final EMCallBack callback)
 
List< String > getAllContactsFromServer () throws HyphenateException
 
void asyncGetAllContactsFromServer (final EMValueCallBack< List< String > > callback)
 
void setContactListener (EMContactListener contactListener)
 
void removeContactListener (EMContactListener contactListener)
 
void addUserToBlackList (String username, boolean both) throws HyphenateException
 
void asyncAddUserToBlackList (final String username, final boolean both, final EMCallBack callback)
 
void saveBlackList (List< String > blackList) throws HyphenateException
 
void asyncSaveBlackList (final List< String > blackList, final EMCallBack callback)
 
void removeUserFromBlackList (String username) throws HyphenateException
 
void asyncRemoveUserFromBlackList (final String username, final EMCallBack callback)
 
List< String > getBlackListUsernames ()
 
List< String > getBlackListFromServer () throws HyphenateException
 
void asyncGetBlackListFromServer (final EMValueCallBack< List< String > > callback)
 
void acceptInvitation (String username) throws HyphenateException
 
void asyncAcceptInvitation (final String username, final EMCallBack callback)
 
void declineInvitation (String username) throws HyphenateException
 
void asyncDeclineInvitation (final String username, final EMCallBack callback)
 
List< String > getContactsFromLocal () throws HyphenateException
 
List< String > getSelfIdsOnOtherPlatform () throws HyphenateException
 
void asyncGetSelfIdsOnOtherPlatform (final EMValueCallBack< List< String > > callback)
 

详细描述

EMContactManager 是用来记录,查询,修改用户的联系人/好友列表的类。

成员函数说明

◆ acceptInvitation()

void com.hyphenate.chat.EMContactManager.acceptInvitation ( String  username) throws HyphenateException

接受加好友的邀请。

同步方法,会阻塞当前线程。

参考: 异步方法见 asyncAcceptInvitation(String, EMCallBack)

参数
username发起好友申请的用户 ID。

◆ addContact()

void com.hyphenate.chat.EMContactManager.addContact ( String  username,
String  reason 
) throws HyphenateException

添加联系人。

同步方法,会阻塞当前线程。

参考: 异步方法见 asyncAddContact(String, String, EMCallBack)

参数
username用户名。
reason添加好友的原因。选填参数,可以设置为 null""
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ addUserToBlackList()

void com.hyphenate.chat.EMContactManager.addUserToBlackList ( String  username,
boolean  both 
) throws HyphenateException

把指定用户加入到黑名单中。 可以给黑名单的中用户发消息,但是接收不到对方发送的消息。

参考: 异步方法见asyncAddUserToBlackList(String, boolean, EMCallBack)。 批量加入黑名单见saveBlackList(List)

同步方法,会阻塞当前线程。

参数
username此用户 ID。
both此参数已废弃。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ asyncAcceptInvitation()

void com.hyphenate.chat.EMContactManager.asyncAcceptInvitation ( final String  username,
final EMCallBack  callback 
)

接受加好友的邀请。

异步方法。

参考: 同步方法见acceptInvitation(String)

参数
username发起好友请求的用户 ID。
callback该方法完成的回调。
  • Success表示添加成功;
  • Error表示失败,会包含失败原因。

◆ asyncAddContact()

void com.hyphenate.chat.EMContactManager.asyncAddContact ( final String  username,
final String  reason,
final EMCallBack  callback 
)

添加联系人。

异步方法。

同步方法见 addContact(String, String)

参数
username用户名。
reason原因、理由(optional)。
callback返回调用结果,失败会返回失败原因。

◆ asyncAddUserToBlackList()

void com.hyphenate.chat.EMContactManager.asyncAddUserToBlackList ( final String  username,
final boolean  both,
final EMCallBack  callback 
)

把指定用户加入到黑名单中。 可以给黑名单的中用户发消息,但是接收不到对方发送的消息。

参考: 同步方法见 addUserToBlackList(String, boolean)。 批量加入黑名单见 asyncSaveBlackList(List, EMCallBack)

参数
username此用户 ID。
both此参数已废弃。
callback该方法完成的回调。
  • Success表示加入成功;
  • Error表示失败,会包含失败原因。

◆ asyncDeclineInvitation()

void com.hyphenate.chat.EMContactManager.asyncDeclineInvitation ( final String  username,
final EMCallBack  callback 
)

拒绝加好友的邀请。

异步方法。

参考: 同步方法见declineInvitation(String)

参数
username发起好友申请的用户 ID。
callback该方法完成调用的回调。如果该方法调用失败,会包含调用失败的原因。

◆ asyncDeleteContact()

void com.hyphenate.chat.EMContactManager.asyncDeleteContact ( final String  username,
final EMCallBack  callback 
)

删除好友。

异步方法。

参考: 同步方法见 deleteContact(String)

参数
username要删除的用户 ID。
callbackSuccess 表示调用成功,Error 表示调用失败,会包含失败原因。

◆ asyncGetAllContactsFromServer()

void com.hyphenate.chat.EMContactManager.asyncGetAllContactsFromServer ( final EMValueCallBack< List< String > >  callback)

从服务器获取所有的好友。

参考: 同步方法见 getAllContactsFromServer()

参数
callback包含联系人列表。

◆ asyncGetBlackListFromServer()

void com.hyphenate.chat.EMContactManager.asyncGetBlackListFromServer ( final EMValueCallBack< List< String > >  callback)

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

参考: 同步方法见getBlackListFromServer()

参数
callback该方法调用成功会返回黑名单列表,失败时返回错误原因。

◆ asyncGetSelfIdsOnOtherPlatform()

void com.hyphenate.chat.EMContactManager.asyncGetSelfIdsOnOtherPlatform ( final EMValueCallBack< List< String > >  callback)

从服务器获取登录用户在其他设备上登录的 ID。这里 ID 是一个组合值,username + "/" + resource(设备的识别号)。

异步方法。

参考: 同步方法见 getSelfIdsOnOtherPlatform()

参数
callback该方法完成的回调,成功会包含用户在其他设备上登录的 ID;失败则包含失败原因。

◆ asyncRemoveUserFromBlackList()

void com.hyphenate.chat.EMContactManager.asyncRemoveUserFromBlackList ( final String  username,
final EMCallBack  callback 
)

将用户从黑名单中移除。

参考: 同步方法见removeUserFromBlackList(String)

参数
username要移除的用户名。
callback该方法完成的回调。
  • Success表示移除成功;
  • Error表示失败,会包含失败原因。

◆ asyncSaveBlackList()

void com.hyphenate.chat.EMContactManager.asyncSaveBlackList ( final List< String >  blackList,
final EMCallBack  callback 
)

上传黑名单列表到服务器。

参考: 同步方法见 saveBlackList(List)

参数
blackList黑名单列表。
callback该方法完成的回调。
  • Success表示上传成功;
  • Error表示失败,会包含失败原因。

◆ declineInvitation()

void com.hyphenate.chat.EMContactManager.declineInvitation ( String  username) throws HyphenateException

拒绝加好友的邀请。

同步方法,会阻塞当前线程。

参考: 异步方法见asyncDeclineInvitation(String, EMCallBack)

参数
username发起好友请求的用户 ID。

◆ deleteContact() [1/2]

void com.hyphenate.chat.EMContactManager.deleteContact ( String  username) throws HyphenateException

删除联系人及其相关的会话。

同步方法,会阻塞当前线程。

参数
username要删除的联系人用户名。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ deleteContact() [2/2]

void com.hyphenate.chat.EMContactManager.deleteContact ( String  username,
boolean  keepConversation 
) throws HyphenateException

删除好友。

同步方法,会阻塞当前线程。

参数
username
keepConversation是否保留会话和消息。true 表示保留,false 表示删除。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ getAllContactsFromServer()

List< String > com.hyphenate.chat.EMContactManager.getAllContactsFromServer ( ) throws HyphenateException

从服务器获取所有的好友。

同步方法,会阻塞当前线程。

参考: 异步方法见asyncGetAllContactsFromServer(EMValueCallBack)

返回
联系人列表。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ getBlackListFromServer()

List< String > com.hyphenate.chat.EMContactManager.getBlackListFromServer ( ) throws HyphenateException

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

参考: 异步方法见 asyncGetBlackListFromServer(EMValueCallBack)

同步方法,会阻塞当前线程。

返回
该方法调用成功会返回黑名单列表。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ getBlackListUsernames()

List< String > com.hyphenate.chat.EMContactManager.getBlackListUsernames ( )

从本地获取黑名单列表。

返回
The blocklist.

◆ getContactsFromLocal()

List< String > com.hyphenate.chat.EMContactManager.getContactsFromLocal ( ) throws HyphenateException

从数据库获取好友列表。

返回
调用成功会返回好友列表。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ getSelfIdsOnOtherPlatform()

List< String > com.hyphenate.chat.EMContactManager.getSelfIdsOnOtherPlatform ( ) throws HyphenateException

从服务器获取登录用户在其他设备上登录的设备 ID,这里的 ID 是由 username + "/" + resource 组成的。

同步方法,会阻塞当前线程。

参考: 异步方法见 asyncGetSelfIdsOnOtherPlatform(EMValueCallBack)

返回
该方法调用成功会返回 ID 列表。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ removeContactListener()

void com.hyphenate.chat.EMContactManager.removeContactListener ( EMContactListener  contactListener)

移除联系人监听。

参考: 添加联系人监听调用setContactListener(EMContactListener)

◆ removeUserFromBlackList()

void com.hyphenate.chat.EMContactManager.removeUserFromBlackList ( String  username) throws HyphenateException

将用户从黑名单中移除。

参考: 异步方法见asyncRemoveUserFromBlackList(String, EMCallBack)

同步方法,会阻塞当前线程。

参数
username要移除的用户名。
异常
HyphenateException如果有方法调用的异常会在这里抛出,可以看到具体错误原因。

◆ saveBlackList()

void com.hyphenate.chat.EMContactManager.saveBlackList ( List< String >  blackList) throws HyphenateException

上传黑名单列表到服务器。

参考: 异步方法见 asyncSaveBlackList(List, EMCallBack)

同步方法,会阻塞当前线程。

参数
blackList黑名单的列表。

◆ setContactListener()

void com.hyphenate.chat.EMContactManager.setContactListener ( EMContactListener  contactListener)

注册联系人监听。

参考: 调用removeContactListener(EMContactListener)移除监听。

参数
contactListener要注册的联系人监听。

该类的文档由以下文件生成: