createChannel

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


flutter ARRtmChannel ARRtmClient.createChannel          ({
         String                 channelId,
         RtmChannelListener     channelListener 
})                                      throws RuntimeException

创建一个 AR RTM 频道。一个 ARRtmClient 实例中可以创建多个频道。但是同一个用户只能同时加入最多 20 个频道。请调用 ARRtmChannel.release() 方法销毁不再使用的 ARRtmChannel 实例资源。你当然可以调用 ARRtmClient.release() 方法释放当前 ARRtmClient 实例的 所有 资源,但是我们 不建议 你依赖 SDK 去释放 ARRtmChannel 资源。

参数

channelIdAR RTM 频道名称。channelId 不能设为空、null,或 "null"。该字符串长度在 64 字节以内。以下为支持的字符集范围:

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

channelListener一个 RtmChannelListener 对象。

  • 方法调用成功:SDK 返回一个 ARRtmChannel 实例。如果具有相同 channelId 的频道不存在,此方法会返回已创建的频道实例。如果已经存在具有相同 channelId 的频道,此方法会返回已存在的频道实例。

  • 方法调用失败:SDK 返回 null。原因可能是 channelId 无效或频道数量超过限制。

    返回

    一个 ARRtmChannel 实例。

Implementation

Future <void>   ARRtmClient.createChannel{
    String  RtmChannelListener  channelListener
}