基本操作
设置加入房间调用监听
调用加入房间接口之前需要先设置方法回调监听,用来判断是否成功加入房间。
-
示例代码:
engine.onRoomJoined = (int code, String? errMsg) {
if (code != 0) {
// 创建/加入失败
} else {
// 创建/加入成功
}
};
加入房间
调用 RCRTCEngine
下的 joinRoom
方法加入房间,如果该房间之前不存在,则会在调用时自动创建并加入。
-
参数说明:
参数 类型 说明 roomId 字符串 房间唯一 ID注1 setup RCRTCRoomSetup 加入房间时提供的初始化信息注2 注1:
roomId
支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式 最长 64 个字符。 注2:setup
内包含用户身份信息和房间的资源类型属性。 -
示例代码:
以会议成员身份加入房间:
RCRTCRoomSetup setup = RCRTCRoomSetup.create(
type: RCRTCMediaType.audio_video,
role: RCRTCRole.meeting_member, // 会议成员
);
engine.joinRoom(roomId, setup);以主播身份加入房间:
RCRTCRoomSetup setup = RCRTCRoomSetup.create(
type: RCRTCMediaType.audio_video,
role: RCRTCRole.live_broadcaster, // 主播
);
engine.joinRoom(roomId, setup);以观众身份加入房间:
RCRTCRoomSetup setup = RCRTCRoomSetup.create(
type: RCRTCMediaType.audio_video,
role: RCRTCRole.live_audience, // 观众
);
engine.joinRoom(roomId, setup);
设置退出房间调用监听
调用退出房间接口之前建议先设置方法回调监听,用来判断是否成功退出房间。
-
示例代码:
engine.onRoomLeft = (int code, String? errMsg) {
if (code != 0) {
// 退出失败
} else {
// 退出成功
}
};
退出房间
调用 RCRTCEngine
下的 leaveRoom
接口离开房间,离开时 SDK 内部会自动取消所有已发布和订阅的资源。
-
示例代码:
engine.leaveRoom();