createGameRoom method
@detail api
@author shenpengliang
@brief 创建游戏房间实例。
调用此方法仅返回一个房间实例,你仍需调用 joinRoom:userInfo:{@link #ByteRTCGameRoom#joinRoom:userInfo} 才能真正地创建/加入房间。
多次调用此方法以创建多个 ByteRTCGameRoom{@link #ByteRTCGameRoom} 实例。分别调用各 GameRTCRoom 实例中的 joinRoom:userInfo:{@link #ByteRTCGameRoom#joinRoom:userInfo} 方法,同时加入多个房间。
多房间模式下,用户可以同时订阅各房间的音视频流。
@param roomId 标识通话房间的房间 ID。该字符串符合正则表达式:[a-zA-Z0-9_\@\\-\\.]{1,128}。
@param roomConfig 房间配置,参看 GameRoomConfig{@link #GameRoomConfig}。
@return 创建的 ByteRTCGameRoom{@link #ByteRTCGameRoom} 房间实例。
返回 NULL 时,请确认指定房间是否已经存在或 roomId 格式错误或当前场景是否是游戏场景。
@note
- 如果需要加入的房间已存在,你仍需先调用本方法来获取 GameRTCRoom 实例,再调用 joinRoom:userInfo:{@link #ByteRTCGameRoom#joinRoom:userInfo} 加入房间。
- 请勿使用同样的 roomId 创建多个房间,否则后创建的房间实例会替换先创建的房间实例。
Implementation
FutureOr<ByteRTCGameRoom> createGameRoom(
NSString roomId, GameRoomConfig roomConfig) async {
final result =
await nativeCall('createGameRoom:roomConfig:', [roomId, roomConfig]);
return packObject(result,
() => ByteRTCGameRoom(const NativeClassOptions([], disableInit: true)));
}