群组管理

发送文字、语音、图片、位置消息。收发消息及聊天记录相关等。

这部分与单聊是一样的，详情见单聊。

私有群，不能被搜索到，只能通过群主加人进群，或者设置了 allowInvite 为 true，即允许群成员邀请，那么群成员也可以邀请群外面的人进入群聊，此种群群成员可以邀请，不能踢人，类似微信群。

//groupName：要创建的群聊的名称
//desc：群聊简介
//members：群聊成员，为空时这个创建的群组只包含自己
//allowInvite:是否允许群成员邀请人进群
EMGroupManager.getInstance().createPrivateGroup(groupName, desc, members,allowInvite);//需异步处理

//前一种方法创建的群聊默认最大群聊用户数为200，传入maxUsers后设置自定义的最大用户数，最大为2000
EMGroupManager.getInstance().createPrivateGroup(groupName, desc, members,allowInvite,maxUsers);//需异步处理

公开群可以被用户搜索到，并且可以直接加入或者申请加入。

//前面三个参数和创建私有群一致
//needApprovalRequired: 如果创建的公开群用需要户自由加入，就传false。否则需要申请，等群主批准后才能加入，传true
EMGroupManager.getInstance().createPublicGroup(groupName, desc, members, needApprovalRequired);//需异步处理
	
//前一种方法创建的群聊默认最大群聊用户数为200，传入maxUsers后设置自定义的最大用户数，最大可以设为2000
EMGroupManager.getInstance().createPublicGroup(groupName, desc, members, needApprovalRequired,maxUsers);//需异步处理

//群主加人调用此方法
EMGroupManager.getInstance().addUsersToGroup(groupId, newmembers);//需异步处理
//私有群里，如果开放了群成员邀请，群成员邀请调用下面方法
EMGroupManager.getInstance().inviteUser(groupId, newmembers, null);//需异步处理

//把username从群聊里删除
EMGroupManager.getInstance().removeUserFromGroup(groupId, username);//需异步处理

只能用于加入公开群。

//如果群开群是自由加入的，即group.isMembersOnly()为false，直接join
EMGroupManager.getInstance().joinGroup(groupid);//需异步处理
//需要申请和验证才能加入的，即group.isMembersOnly()为true，调用下面方法
EMGroupManager.getInstance().applyJoinToGroup(groupid, "求加入");//需异步处理

EMGroupManager.getInstance().exitFromGroup(groupId);//需异步处理

EMGroupManager.getInstance().exitAndDeleteGroup(groupId);//需异步处理

//从服务器获取自己加入的和创建的群聊列表（两种方式），此API获取的群组SDK会自动保存到内存和db。
//注意，获取到的列表里的群聊只有groupname和groupid等简单配置信息
1.List<EMGroup> grouplist = EMGroupManager.getInstance().getGroupsFromServer();//需异步处理
	
2.EMGroupManager.getInstance().asyncGetGroupsFromServer(newEMValueCallBack<List<EMGroup>>() {
			
    @Override
	public void onSuccess(List<EMGroup> value) {
		// TODO Auto-generated method stub
				
	}
			
	@Override
	public void onError(int error, String errorMsg) {
		// TODO Auto-generated method stub
				
	}
});

//从本地加载群聊列表
List<EMGroup> grouplist = EMGroupManager.getInstance().getAllGroups();

//获取所有公开群列表（两种方式）
1.List<EMGroupInfo> groupsList = EMGroupManager.getInstance().getAllPublicGroupsFromServer();//需异步处理
	
2.EMGroupManager.getInstance().asyncGetAllPublicGroupsFromServer(new EMValueCallBack<List<EMGroupInfo>>() {
			
    @Override
	public void onSuccess(List<EMGroupInfo> value) {
		// TODO Auto-generated method stub
	}
			
	@Override
	public void onError(int error, String errorMsg) {
	    // TODO Auto-generated method stub
				
	}
});

//groupId 需要改变名称的群组的id
//changedGroupName 改变后的群组名称
EMGroupManager.getInstance().changeGroupName(groupId,changedGroupName);//需异步处理

//根据群聊ID从本地获取群聊基本信息
EMGroup group = EMGroupManager.getInstance().getGroup(groupId);
//根据群聊ID从服务器获取群聊基本信息
EMGroup group =EMGroupManager.getInstance().getGroupFromServer(groupId);
//保存获取下来的群聊基本信息
EMGroupManager.getInstance().createOrUpdateLocalGroup(returnGroup);
group.getMembers();//获取群成员
group.getOwner();//获取群主
...

其它方法详见环信接口文档。

/**
* 屏蔽群消息后，就不能接收到此群的消息 （群创建者不能屏蔽群消息）（还是群里面的成员，但不再接收消息）  
* @param groupId， 群id
* @throws EasemobException
*/
EMGroupManager.getInstance().blockGroupMessage(groupId);//需异步处理

/**
* 取消屏蔽群消息，就可以正常收到群的所有消息
* @param groupId
* @throws EaseMobException
*/
EMGroupManager.getInstance().unblockGroupMessage(groupId);//需异步处理

//如果群聊只是想提示数目，不响铃。可以通过此属性设置，此属性是本地属性
EMChatManager.getInstance().getChatOptions().setReceiveNotNoifyGroup(List<String>)

/**
* 将用户加到群组的黑名单，被加入黑名单的用户无法加入群，无法收发此群的消息
* （只有群主才能设置群的黑名单）
* @param groupId, 群组的id
* @param username, 待屏蔽的用户名
* @exception EaseMobException 出错会抛出
*/
EMGroupManager.getInstance().blockUser(groupId, username);//需异步处理

/**
* 将用户从群组的黑名单移除（只有群主才能调用此函数）
* @param groupId, 群组的id
* @param username, 待解除屏蔽的用户名
*/
EMGroupManager.getInstance().unblockUser(groupId, username);//需异步处理

/**
* 获取群组的黑名单用户列表
* （只有群主才能调用此函数）
* @return List<String> 
* @throws EaseMobException 获取失败
*/
EMGroupManager.getInstance().getBlockedUsers(groupId);//需异步处理

EMGroupManager.getInstance().addGroupChangeListener(new GroupChangeListener() {
	@Override
	public void onUserRemoved(String groupId, String groupName) {
		//当前用户被管理员移除出群聊
	}
	@Override
	public void onInvitationReceived(String groupId, String groupName, String inviter, String reason) {
		//收到加入群聊的邀请
	}
	@Override
	public void onInvitationDeclined(String groupId, String invitee, String reason) {
		//群聊邀请被拒绝
	}
	@Override
	public void onInvitationAccpted(String groupId, String inviter, String reason) {
		//群聊邀请被接受
	}
	@Override
	public void onGroupDestroy(String groupId, String groupName) {
		//群聊被创建者解散
	}
	@Override
	public void onApplicationReceived(String groupId, String groupName, String applyer, String reason) {
		//收到加群申请
	}
	@Override
	public void onApplicationAccept(String groupId, String groupName, String accepter) {
		//加群申请被同意
	}
	@Override
	public void onApplicationDeclined(String groupId, String groupName, String decliner, String reason) {
	    // 加群申请被拒绝
	}
});

下载 Demo 及 SDK

详细文档请参考 Java doc