switchChannel method

Future<void> switchChannel (
  1. String token,
  2. String channelName,
  3. [ChannelMediaOptions options]
)

快速切换直播频道。

当直播频道中的观众想从一个频道切换到另一个频道时，可以调用该方法，实现快速切换。

成功调用该方切换频道后，本地会先收到离开原频道的回调 RtcEngineEventHandler.leaveChannel， 再收到成功加入新频道的回调 RtcEngineEventHandler.joinChannelSuccess。

用户成功加入（切换）频道后，默认订阅频道内所有其他用户的音频流和视频流，因此产生用量并影响计费。如果想取消订阅，可以通过调用相应的 mute 方法实现。

Note

  • 该方法仅适用直播频道中的观众用户。

Parameter token 在 App 服务器端生成的用于鉴权的 Token。详见从服务端生成 Token。

Parameter channelName 标识频道的频道名，最大不超过 64 字节。以下为支持的字符集范围（共 89 个字符）：

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

Parameter options 频道媒体设置选项，详见 ChannelMediaOptions。

Implementation

@override
Future<void> switchChannel(String token, String channelName,
    [ChannelMediaOptions options]) {
  return _invokeMethod('switchChannel', {
    'token': token,
    'channelName': channelName,
    'options': options?.toJson()
  });
}