合图
更新时间不可用
了解如何在 RTC 服务端 SDK 中合图，包括适用场景、配置步骤、实现要点和注意事项。
声网提供合图功能，可以混合多路远端或本地视频轨道并进行自定义格式输出。
你可以通过合图功能实现水印、画中画等场景。
实现方法
参考以下步骤实现合图功能。
-
创建一个
IVideoMixerSource对象。C++ agora::agora_refptr<agora::rtc::IVideoMixerSource> videoMixer = factory->createVideoMixer(); -
调用
createMixedVideoTrack创建合图轨道。通过合图轨道注册视频帧观测器获取视频。C++ agora::agora_refptr<agora::rtc::ILocalVideoTrack> mixVideoTrack = service->createMixedVideoTrack(videoMixer); if (!mixVideoTrack) { AG_LOG(ERROR, "Failed to create video track!"); return -1; } agora::rtc::VideoEncoderConfiguration encoderConfig; encoderConfig.codecType = agora::rtc::VIDEO_CODEC_H264; encoderConfig.dimensions.width = 1920; encoderConfig.dimensions.height = 1080; encoderConfig.frameRate = 15; mixVideoTrack->setVideoEncoderConfiguration(encoderConfig); // Register video frame observer to receive video stream agora::agora_refptr<agora::rtc::IVideoSinkBase> yuvFrameObserver = new agora::RefCountedObject<YuvFrameObserver>(options.videoFile); mixVideoTrack->addRenderer(yuvFrameObserver.get()); -
将视频轨道加入
IVideoMixerSource对象，用于合图。C++ if (remote_video_track_ && video_mixer_ && enable_video_mix_) { video_mixer_->addVideoTrack(userId, remote_video_track_); remote_video_track_map_[std::string(userId)] = remote_video_track_; } -
当第一个 YUV 帧解码后，先调用
setBackground设置背景，再调用refresh刷新IVideoMixerSource对象。C++ remote_source_map_[std::string(userId)] = calculate_layout(width, height); for (auto it = remote_source_map_.begin(); it != remote_source_map_.end(); it++) { video_mixer_->setStreamLayout(it->first.c_str(), it->second); } video_mixer_->setBackground(1920, 1080, 15); video_mixer_->refresh();