房间内人员管理
1. 功能介绍
房间内人员管理相关接口主要用于:
- 查询成员信息:获取当前房间中所有成员或指定成员的详细资料;
- 控制音频:打开 / 关闭自己或他人的麦克风,查询麦克风状态、能量;
- 控制视频:打开 / 关闭自己或他人的视频,查询视频状态;
- 成员事件通知:监听有人进入 / 离开房间的通知;
- 强制管理:将指定成员请出房间。
以上接口均通过 RTCMeeting 对象提供,使用前需确保已成功进入房间。
2. 获取房间中所有人员信息
ArrayList<MemberInfo> members = RTCMeeting.getInstance().getAllMembers();
for (MemberInfo mb : members) {
// 使用成员信息
}
相关 API 请参考:
3. 获取房间中单人员信息
String userID = "user_001";
MemberInfo info = RTCMeeting.getInstance().getMemberInfo(userID);
if (info != null) {
String nickName = info.nickName;
// 根据业务逻辑做处理
}
相关 API 请参考:
4. 开关自己或他人的麦克风
String selfID = "my_userid";
String otherID = "user_002";
// 打开自己的麦克风
RTCMeeting.getInstance().openMic(selfID);
// 作为主持人,打开或关闭他人的麦(前提是有相应权限)
RTCMeeting.getInstance().openMic(otherID);
RTCMeeting.getInstance().closeMic(otherID);
// 查询麦克风状态
ASTATUS status = RTCMeeting.getInstance().getAudioStatus(otherID);
麦克风状态变化时,房间内所有人都会收到 audioStatusChanged 回调。
相关 API 请参考:
更多麦克风推送说明参见 推送我的声音到房间。
5. 开关自己或他人的视频
String selfID = "my_userid";
// 打开本端视频
RTCMeeting.getInstance().openVideo(selfID);
// 关闭本端视频
RTCMeeting.getInstance().closeVideo(selfID);
// 查询视频状态
VSTATUS vStatus = RTCMeeting.getInstance().getVideoStatus(selfID);
视频状态变化时,房间内所有人都会收到 videoStatusChanged 回调。
相关 API 请参考:
更多视频推送说明参见 推送视频流。
6. 昵称管理
// 设置昵称
RTCMeeting.getInstance().setNickName(userID, "新昵称");
// 获取昵称
String nickName = RTCMeeting.getInstance().getNickName(userID);
昵称变更成功后,其他用户会收到 notifyNickNameChanged 通知。
相关 API 请参考:
7. 成员进出通知
@Override
void userEnterMeeting(String userID) {
// 有人进入房间
}
@Override
void userLeftMeeting(String userID) {
// 有人离开房间
}
// 判断用户是否在房间中
boolean inMeeting = RTCMeeting.getInstance().isUserInMeeting(userID);
相关 API 请参考:
8. 请出成员
RTCMeeting.getInstance().kickout(userID);
被请出用户将收到 meetingDropped 通知。详见 进入/离开房间。
相关 API 请参考:
9. 监测发言者音量
参见 监测发言者音量。