# 多摄像头/多客户端用例
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
多摄像头/多客户端用例展示了以画中画、并排等模式显示多路摄像头视频流的场景。
在运行用例之前，请确保完成[运行多媒体用例](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multimedia-use-cases.html)中提到的先决条件。
### QCS8275 和 QCS9075 的 GMSL 摄像头限制
在现有的软件配置下，单个 GMSL 端口仅支持在其四个插槽中的任何一个上连接一台 GMSL 摄像头。
- GMSL 端口 0 支持单个 Bayer 摄像头。
- 当前版本支持 OX03f10 Bayer GMSL 和 OX03f10 YUV GMSL 摄像头。
Table : QCS8275 和 QCS9075 - GSML 端口支持和限制
| SoC | GMSL 端口连接 |
| :--- | :--- |
| QCS6490 | 确保将 MIPI 摄像头连接到 RB3 Gen 2 设备上的 CSI 插槽。
- 将 OV9282 MIPI 摄像头连接到 CAM 0A 插槽。
- 将 IMX577 MPI 摄像头连接到 CAM3 插槽。
|
| QCS8275 | 确保将 GMSL 摄像头传感器连接到 Ride SX 设备。
- 将 OX03F10 Bayer GMSL 摄像头连接到 GMSL 端口 0。
- 将 OX03F10 YUV GMSL 摄像头连接到端口 1 和端口 2。
|
| QCS9075 |
- MIPI：将四个 OV9282 MIPI 摄像头连接到 CSI 插槽。
- GMSL：将 OX03F10 Bayer GMSL 摄像头连接到 GMSL 端口 0，将 OX03F10 YUV GMSL 摄像头连接到端口 2 和端口 3。
|
## 两路流 - 4k AVC MP4、1080p YUV 预览作为客户端 1（主摄像头），720p AVC、720p YUV 作为客户端 2（辅助摄像头）
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
该用例使用来自主摄像头的两路流（4K 和 1080p）和来自辅助摄像头的两路 720p 流。对每个摄像头中的一路流进行复用和编码，同时显示另一对流。
Table : 用于编码和预览的多摄像头客户端用例
| 用例 | 摄像头（客户端） |
| :--- | :--- |
| 复用和编码 |
- 主摄像头 – 4k AVC MP4
- 辅助摄像头 – 720p AVC
|
| 预览 |
- 主摄像头 – 1080p YUV
- 辅助摄像头 – 720p YUV
|
运行 pipeline：
gst-launch-1.0 -e qtiqmmfsrc name=camsrc_0 video_1::type=preview ! video/x-raw,format=NV12,width=3840,height=2160,framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! queue ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! queue ! h264parse ! mp4mux ! queue ! filesink location="/opt/mux1.mp4" camsrc_0. ! video/x-raw,format=NV12,width=1920,height=1080,framerate=30/1 ! waylandsink sync=false qtiqmmfsrc name=camsrc_1 camera=1 video_1::type=preview ! video/x-raw,format=NV12,width=1280,height=720,framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! queue ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! queue ! h264parse ! mp4mux ! queue ! filesink location="/opt/mux2.mp4" camsrc_1. ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! waylandsink sync=falseCopy to clipboard
要停止用例，请按 CTRL + C。
使用以下 scp 命令从设备中拉取录制的内容，然后在主机上播放这些内容。
scp -r root@[DEVICE IP-ADDR]:/opt/mux1.mp4 user1@[HOST IP-ADDR]:/workspaceCopy to clipboard
scp -r root@[DEVICE IP-ADDR]:/opt/mux2.mp4 user1@[HOST IP-ADDR]:/workspaceCopy to clipboard
您可以在媒体播放器上播放 MP4 文件和照片，并在屏幕上查看预览流。
下图显示了 pipeline 执行流程：
Figure : 双摄像头客户端 pipeline - 编码和预览
## 两路 720p 流 - 每个摄像头各一路，采用并排拼接方式显示
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
该 pipeline 展示了分别来自主摄像头和辅助摄像头的两路 720p 流。这两路流并排合成后进行显示。
运行 pipeline：
gst-launch-1.0 -e qtivcomposer name=mixer sink_0::position="<0, 0>" sink_0::dimensions="<640, 360>" sink_1::position="<640, 0>" sink_1::dimensions="<640, 360>" mixer. ! queue ! waylandsink enable-last-sample=false fullscreen=true qtiqmmfsrc name=camsrc_0 camera=0 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer. qtiqmmfsrc name=camsrc_1 camera=1 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer.Copy to clipboard
显示来自摄像头的合成流。
要停止用例，请按 CTRL + C。
下图显示了 pipeline 执行流程：
Figure : 主摄像头和辅助摄像头的两路流 – 并排显示
## 两路 720p 流 - 每个摄像头各一路，采用并排拼接方式进行编码并通过 RTSP 流传输
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
该 pipeline 展示了分别来自主摄像头和辅助摄像头的两路 720p 流。两路流并排合成，然后进行复制并编码。一个数据流多路复用并保存到文件中，另一个则通过 RTSP 传输流。
使用 udpsrc 在目标设备的单独控制台中运行 RTSP 服务器。也可以将其作为服务在后台运行：
gst-rtsp-server -p 8900 -a -m /live "( udpsrc name=pay0 port=8554 caps=\"application/x-rtp,media=video,clock-rate=90000,encoding-name=H264,payload=96\" )"Copy to clipboard
在目标设备的同一控制台或其他控制台中运行 pipeline：
gst-launch-1.0 -e qtivcomposer name=mixer sink_0::position="<0, 0>" sink_0::dimensions="<640, 360>" sink_1::position="<640, 0>" sink_1::dimensions="<640, 360>" mixer. ! queue ! tee name=t_split t_split. ! queue ! video/x-raw,interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! h264parse ! queue ! mp4mux ! queue ! filesink location=/opt/mux.mp4 t_split. ! queue ! video/x-raw,interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! h264parse config-interval=-1 ! rtph264pay pt=96 ! udpsink host=127.0.0.1 port=8554 qtiqmmfsrc name=camsrc_0 camera=0 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer. qtiqmmfsrc name=camsrc_1 camera=1 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer.Copy to clipboard
要停止用例，请按 CTRL + C。
使用 `scp` 命令从设备中拉取录制的内容，然后在主机上播放这些内容。
scp root@:/opt/mux.mp4 Copy to clipboard
您可以在媒体播放器上播放 MP4 文件。通过流传输的视频以 RTSP 流形式显示在主机上。参见[在主机上查看 RTSP 流](https://docs.qualcomm.com/doc/80-70018-50SC/topic/camera-and-video-encode.html#one_stream_1080p_avc_rtsp_from_live_source__section_ayq_2nh_pyb)。
下图显示了 pipeline 执行流程：
Figure : 两路 720p 摄像头流的 pipeline - 并排显示、编码并通过 RTSP 进行传输
## 两路 720p 流 - 每个摄像头各一路，采用画中画合成方式，并发送到显示器
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
用例使用分别来自主摄像头和辅助摄像头的两路 720p 流。两者均以画中画形式组成并显示。
运行 pipeline：
gst-launch-1.0 -e qtivcomposer name=mixer sink_0::position="<0, 0>" sink_0::dimensions="<1280, 720>" sink_1::position="<590, 310>" sink_1::dimensions="<640, 360>" mixer. ! queue ! waylandsink enable-last-sample=false fullscreen=true qtiqmmfsrc name=camsrc_0 camera=0 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer. qtiqmmfsrc name=camsrc_1 camera=1 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer.Copy to clipboard
显示来自摄像头的合成流（画中画）。
要停止用例，请按 CTRL + C。
下图显示了 pipeline 执行流程：
Figure : 两路 720p 流的 pipeline - 画中画显示
## 两路 720p 流 - 每个摄像头各一路，采用画中画合成方式进行编码和 RTSP 流传输
Source: [https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-multi-client-use-cases.html)
用例使用分别来自主摄像头和辅助摄像头的两路 720p 流。两者均被合成为画中画，然后进行复制和编码。一路流复用并保存到文件中，另一路则通过 RTSP 进行流传输。
运行 pipeline：
- 使用 udpsrc 在目标设备的单独控制台中运行 RTSP 服务器。可以将其作为服务在后台运行：
gst-rtsp-server -p 8900 -a -m /live "( udpsrc name=pay0 port=8554 caps=\"application/x-rtp,media=video,clock-rate=90000,encoding-name=H264,payload=96\" )"Copy to clipboard
- 在目标设备的同一控制台或其他控制台中运行 pipeline：
gst-launch-1.0 -e qtivcomposer name=mixer sink_0::position="<0, 0>" sink_0::dimensions="<1280, 720>" sink_1::position="<590, 310>" sink_1::dimensions="<640, 360>" mixer. ! queue ! tee name=t_split t_split. ! queue ! video/x-raw,framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! h264parse ! queue ! mp4mux ! queue ! filesink location=/opt/mux.mp4 t_split. ! queue ! video/x-raw,framerate=30/1,interlace-mode=progressive,colorimetry=bt601 ! v4l2h264enc capture-io-mode=4 output-io-mode=5 ! h264parse config-interval=-1 ! rtph264pay pt=96 ! udpsink host= port=8554 qtiqmmfsrc name=camsrc_0 camera=0 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer. qtiqmmfsrc name=camsrc_1 camera=1 ! video/x-raw, format=NV12, width=1280, height=720, framerate=30/1 ! mixer.Copy to clipboard
- 要停止用例，请按 CTRL + C。
使用 `scp` 命令从设备中拉取录制的内容，然后在主机上播放这些内容。
scp root@:/opt/ Copy to clipboard
您可以在媒体播放器上播放 MP4 文件。视频通过主机上的 RTSP 进行流传输。参见[在主机上查看 RTSP 流](https://docs.qualcomm.com/doc/80-70018-50SC/topic/camera-and-video-encode.html#one_stream_1080p_avc_rtsp_from_live_source__section_ayq_2nh_pyb)。
下图显示了 pipeline 执行流程：
Figure : 两路 720p 摄像头流的 pipeline - 画中画显示、编码并通过 RTSP 进行流传输
**Related Resources**
- [多摄像头流传输](https://docs.qualcomm.com/doc/80-70018-50SC/topic/gst-multi-camera-stream-example.html)
- [使用 Python 的多摄像头流](https://docs.qualcomm.com/doc/80-70018-50SC/topic/multi-camera-streaming-python-sample-app.html)
Last Published: Nov 12, 2025
[Previous Topic
视频编码与解码](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/camera-and-video-encode.md) [Next Topic
转换和转码用例](https://docs.qualcomm.com/bundle/publicresource/80-70018-50SC/topics/transform-and-transcode-use-cases.md)