create method

最近更新时间:2022-09-20 05:17:40

Future<RtcChannel> create (
    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];
}