create method Null safety

Future<RtcChannel> create(
  1. String channelId
)

创建并返回 RtcChannel 对象。

你可以多次调用该方法，创建多个 RtcChannel 对象，再调用各 RtcChannel 对象中的 RtcChannel.joinChannel 方法，实现同时加入多个频道。

加入多个频道后，你可以同时订阅各个频道的音、视频流；但是同一时间只能在一个频道发布一路音、视频流。

Parameter channelId 标识通话的频道名称，长度在 64 字节以内的字符串。以下为支持的字符集范围（共 89 个字符）：

  • 26 个小写英文字母 a-z
  • 26 个大写英文字母 A-Z
  • 10 个数字 0-9
  • 空格
  • "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","

Note

  • 该参数没有默认值，请确保对参数设值。
  • 请勿将该参数设为空字符 ""，否则 SDK 会返回 ErrorCode(5)。

Returns

  • 方法调用成功，返回 RtcChannel 对象。
  • 方法调用失败，返回 null。
  • 如果将 channelId 设为空字符 ""，则返回错误码 ErrorCode(5)。

Implementation

static Future<RtcChannel> create(String channelId) async {
  if (_channels.containsKey(channelId)) return _channels[channelId]!;
  await _methodChannel.invokeMethod('create', {
    'channelId': channelId,
  });
  _channels[channelId] = RtcChannel._(channelId);
  return _channels[channelId]!;
}