# 加入多频道 (/zh-CN/realtime-media/rtc/build/advanced-channel/multiple-channel/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 声网 SDK 支持用户同时加入多个频道,同一时间可以在多个频道中接收和发布音视频流。 ## 技术原理 [#技术原理-1] SDK 提供 `AgoraRtcConnection` 对象和 `AgoraRtcEngineKit(Ex)` 类实现多频道功能。`AgoraRtcEngineKit(Ex)` 提供适用于指定 `AgoraRtcConnection` 对象的方法。 `AgoraRtcConnection` 对象包含用于识别连接的如下信息: - 频道名称 - 本地用户的用户 ID 你可以创建多个 `AgoraRtcConnection` 对象,并为每个对象设置不同的频道名称和用户 ID。 如果要加入多个频道,多次调用 `AgoraRtcEngineKit(Ex)` 类中的 `joinChannelExByToken[1/2]` 并设置不同的 `AgoraRtcConnection` 对象。加入多频道时请注意: - 每个 `AgoraRtcConnection` 对象的用户 ID 是唯一的,且不为 `0`。 - 可以为 `joinChannelExByToken[1/2]` 中的 `AgoraRtcConnection` 对象配置发布和订阅选项。 - 每个 `AgoraRtcConnection` 可以独立发布多路音频流和一路视频流。 - 不同频道的事件通过你在调用 `joinChannelExByToken` 方法时,向 `delegate` 所传入的不同 `AgoraRtcEngineDelegate` 对象来回调。 ## 前提条件 [#前提条件-1] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-1] 为实现多频道功能,你需要对每个频道进行如下设置: 1. 在项目的 `ViewController.swift` 文件中定义 `AgoraRtcConnection` 对象。 ```swift let connection1 = AgoraRtcConnection() ``` 2. 使用随机的用户 ID 加入频道。 ```swift var mediaOptions = AgoraRtcChannelMediaOptions() mediaOptions.autoSubscribeVideo = .of(true) mediaOptions.autoSubscribeAudio = .of(true) connection1.channelId = channelName1 connection1.localUid = UInt.random(in: 1001...2000) var result = agoraKit.joinChannelEx(byToken: "your token", connection: connection1, delegate: channel1, mediaOptions: mediaOptions, joinSuccess: nil) channel1.channelId = channelName1 channel1.connecitonDelegate = self if result != 0 { self.showAlert(title: "Error", message: "joinChannel1 call failed: \(result), please check your params") } ``` 3. 在 `didJoinedOfUid` 回调中设置远端视频。 ```swift func rtcEngine(_ engine: AgoraRtcEngineKit, didJoinedOfUid uid: UInt, elapsed: Int) { guard let channelId = channelId, let channel2RemoteVideo = view else { return } LogUtils.log(message: "remote user join room channel \(channelId): \(uid) \(elapsed)ms", level: .info) // 在该操作中,仅一个远端视频视图可用 // 此处,我们检查是否存在标签为该 uid 的视图 let videoCanvas = AgoraRtcVideoCanvas() videoCanvas.uid = uid // 待绑定的视图 videoCanvas.view = channel2RemoteVideo.videoView videoCanvas.renderMode = .hidden let connection = AgoraRtcConnection() connection.channelId = channelId connection.localUid = CONNECTION_2_UID engine.setupRemoteVideoEx(videoCanvas, connection: connection) remoteUid = uid } ``` ## 参考信息 [#参考信息-1] ### API 参考 [#api-参考-1] - [`joinChannelExByToken[1/2]`](/zh-CN/api-reference/rtc/ios/channel#api_irtcengineex_joinchannelex) - [`setupRemoteVideoEx`](/zh-CN/api-reference/rtc/ios/video/video-rendering#api_irtcengineex_setupremotevideoex) ### 示例项目 [#示例项目-1] 声网在 GitHub 上提供如下开源的示例项目。你可以前往下载,或查看其中的源代码: