joinChannel method

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

@override
Future<void> joinChannel (
    String token,
    String optionalInfo,
    String optionalUid,
    ChannelMediaOptions options
)

使用 UID 加入频道。

Note

  • 该方法不支持相同的用户重复加入同一个频道。
  • AR 建议不同频道中使用不同的 UID。
  • 如果想要从不同的设备同时接入同一个频道,请确保每个设备上使用的 UID 是不同的。
  • 请确保用于生成 Token 的 App ID 和创建 RtcEngine 对象时用的 App ID 一致。

Parameter token 在 App 服务器端生成的用于鉴权的 Token:

  • 安全要求不高:你可以使用控制台生成的临时 Token,详见获取临时 Token
  • 安全要求高:将值设为你的服务端生成的正式 Token,详见从服务端生成 Token

Parameter optionalInfo 开发者需加入的任何附加信息。一般可设置为空字符串,或频道相关信息。该信息不会传递给频道内的其他用户。

Parameter optionalUid 用户 ID,32 位无符号整数。建议设置范围:1 到 (232-1),并保证唯一性。 如果不指定(即设为 0),SDK 会自动分配一个, 并在 JoinChannelSuccess{@link RtcChannelEvents.JoinChannelSuccess} 回调方法中返回,App 层必须记住该返回值并维护,SDK 不对该返回值进行维护。

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

Implementation


Future<void> joinChannel(String token, String optionalInfo, String optionalUid,
    ChannelMediaOptions options) {
  return _invokeMethod('joinChannel', {
    'token': token,
    'optionalInfo': optionalInfo,
    'optionalUid': optionalUid,
    'options': options.toJson()
  });
}