音视频通话

房间内人员管理

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. 监测发言者音量

参见 监测发言者音量。