加入多频道
- Unity
更新时间
了解实时互动 RTC 在不同平台上的加入多频道方式,包括接入流程、关键配置和平台差异。
声网 SDK 支持用户同时加入多个频道,同一时间可以在多个频道中接收和发布音视频流。
技术原理
SDK 提供 RtcConnection 对象和 IRtcEngineEx 类实现多频道功能。IRtcEngineEx 提供适用于指定 RtcConnection 对象的方法。
RtcConnection 对象包含用于识别连接的如下信息:
- 频道名称
- 本地用户的用户 ID
你可以创建多个 RtcConnection 对象,并为每个对象设置不同的频道名称和用户 ID。
如果要加入多个频道,多次调用 IRtcEngineEx 类中的 JoinChannelEx 并设置不同的 RtcConnection 对象。加入多频道时请注意:
- 每个
RtcConnection对象的用户 ID 是唯一的,且不为0。 - 可以为
JoinChannelEx中的RtcConnection对象配置发布和订阅选项。 - 每个
RtcConnection可以独立发布多路音频流和一路视频流。 - 你可以通过每个具体回调中的
connection参数得知该回调对应哪个频道的事件。
前提条件
在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。
实现方法
本节介绍如何在已经加入一个频道的情况下,以主播身份加入第二个频道。
-
调用
JoinChannelEx加入第二个频道。C# ChannelMediaOptions options2 = new ChannelMediaOptions(); // 自动订阅远端的音频流 options2.autoSubscribeAudio.SetValue(true); // 自动订阅远端的视频流 options2.autoSubscribeVideo.SetValue(true); // 发布麦克风采集的音频流 options2.publishMicrophoneTrack.SetValue(true); // 发布摄像头采集的视频流 options2.publishCameraTrack.SetValue(true); // 设置用户角色为主播 options2.clientRoleType.SetValue(CLIENT_ROLE_TYPE.CLIENT_ROLE_BROADCASTER); // 加入第二个频道 // 请确保加入频道使用的用户 ID 是唯一的 ret = RtcEngine.JoinChannelEx(_token, new RtcConnection(_channelName, UID2), options2); Debug.Log("JoinChannelEx returns: " + ret); -
监听
OnUserJoined回调,并调用SetForUser设置远端用户视频渲染。C# public override void OnUserJoined(RtcConnection connection, uint uid, int elapsed) { Debug.Log(string.Format("OnUserJoined uid: ${0} elapsed: ${1}", uid, elapsed)); //创建远端用户视图 var videoSurface = MakeImageSurface(uid.ToString()); // 设置视频渲染 videoSurface.SetForUser(uid, connection.channelId, VIDEO_SOURCE_TYPE.VIDEO_SOURCE_REMOTE); // Texture 的宽高发生改变回调 videoSurface.OnTextureSizeModify += (int width, int height) => { var transform = videoSurface.GetComponent<RectTransform>(); if (transform) { // 如果在 RawImage 中渲染,只需设置 RawImage 的尺寸 transform.sizeDelta = new Vector2(width / 2, height / 2); transform.localScale = Vector3.one; } else { // 如果在 MeshRenderer 中渲染,只需设置 MeshRenderer 的本地尺寸 float scale = (float)height / (float)width; videoSurface.transform.localScale = new Vector3(-1, 1, scale); } Debug.Log("OnTextureSizeModify: " + width + " " + height); } } private static VideoSurface MakeImageSurface(string goName) { GameObject go = new GameObject(); go.name = goName; // to be renderered onto go.AddComponent<RawImage>(); // make the object draggable go.AddComponent<UIElementDrag>(); var canvas = GameObject.Find("VideoCanvas"); if (canvas != null) { go.transform.parent = canvas.transform; Debug.Log("add video view"); } else { Debug.Log("Canvas is null video view"); } // 设置 transform 属性 go.transform.Rotate(0f, 0.0f, 180.0f); go.transform.localPosition = Vector3.zero; go.transform.localScale = new Vector3(2f, 3f, 1f); // 添加 videoSurface 组件 var videoSurface = go.AddComponent<VideoSurface>(); return videoSurface; }