# 视频墙
Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-concurrent-videoplay-composition.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-concurrent-videoplay-composition.html)
**gst-concurrent-videoplay-composition** 应用程序支持 MP4 AVC（H.264）视频的并发视频播放，并在视频墙显示器上执行合成。
在并发视频播放和合成 pipeline 中，四路解码和合成 pipeline 并发运行。有关该 pipeline 中使用的插件的更多信息，请参见 [Pipeline 流](https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-concurrent-videoplay-composition.html#gst-concurrent-videoplay-composition__section_s22_qsf_4bc)。
Figure : 具有 4 个流的 gst-concurrent-videoplay-composition pipeline
## 前提条件
- 确保[下载并安装 eSDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-51/install-sdk.html#download-and-install-esdk-)（如果尚未安装）。
- 要访问您的主机设备，请设置 SSH。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh)。
Note: 如果已设置 SSH，则可以跳过此步骤。
- 从 Linux 主机推送文件。
scp root@:/etc/media/Copy to clipboard
- 使用 HDMI 端口将显示器连接到设备。有关说明，请参见[设置 HDMI 显示器](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-18/samples.html)。
- 激活显示器：
export XDG_RUNTIME_DIR=/dev/socket/weston && export WAYLAND_DISPLAY=wayland-1Copy to clipboard
- 连接扬声器以激活音频。有关说明，请参见[设置音频硬件](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-16/enable-audio.html)。
如果您遇到摄像头或显示器问题，请参阅[摄像头故障排查](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-17/troubleshooting.html)和[显示器故障排查](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-18/debug.html)。
## 运行应用程序
该应用程序至少需要一个输入视频文件。输入文件必须是 MP4 AVC (H.264) 文件。
下表列出了 gst-concurrent-videoplay-composition 应用程序支持的用例：| 用例 | 说明 |
| --- | --- |
| 视频会议 |
- 同时解码多个参与者的视频流。
- 这在多方视频会议场景中非常有用，此时该应用程序管理多个视频流。
|
| 监控系统 | 同时解码来自两个独立摄像头的视频源。 |
| 数字标牌 | 允许对集中管理的信息进行同步更改或更新，并在不同位置以电子方式显示。 |
请执行以下操作，以便运行用例：
1. 将 AVC 编码的 MP4（H.264）文件加载到设备上。
2. 要为您的用例运行应用程序，请使用以下命令：
gst-concurrent-videoplay-composition -c -i .mp4 -i .mp4Copy to clipboard
下表提供了命令行参数的说明： | 命令行参数 | 说明 |
| --- | --- |
| `-c` |
- 需要解码以进行合成的流的数量。
- 支持的值为 2、4、8 和 16。
|
| `-i` | 指定输入视频文件的绝对路径 |
使用以下命令运行并发播放用例：
- 同时播放两个会话：
gst-concurrent-videoplay-composition -c 2 -i .mp4 -i .mp4Copy to clipboard
如果提供一个视频作为输入，则同时播放同一文件。
- 同时播放四个会话：
gst-concurrent-videoplay-composition -c 4 -i .mp4 -i .mp4 -i .mp4 -i .mp4Copy to clipboard
要显示可用的帮助选项，请在 SSH shell 中运行以下命令：
gst-concurrent-videoplay-composition --helpCopy to clipboard
要停止用例，请按 CTRL + C。
## 预期输出
各个组合的流被平铺在一起，以显示为统一流。
Figure : gst-concurrent-videoplay-composition 应用程序的预期输出
## Pipeline 流
下表列出了用于运行视频墙 pipeline 的插件：| 插件 | 说明 |
| --- | --- |
| filesrc | 读取视频数据。 |
| qtdemux | 对视频数据进行解复用。 |
| h264parse | 渲染 H.264 视频流。 |
| [v4l2h264dec](https://docs.qualcomm.com/doc/80-70020-50SC/topic/v4l2h264dec.html) | 解码 H.264 视频流。 |
| [qtivcomposer](https://docs.qualcomm.com/doc/80-70020-50SC/topic/qtivcomposer.html) | 合成解码后的流并发送到显示器。 |
| [Waylandsink](https://docs.qualcomm.com/doc/80-70020-50SC/topic/waylandsink.html) | 在 Wayland 显示器上显示合成的视频流。 |
## 已知问题
视频播放关闭或冻结。约一小时后，继续运行 16 路 H.264 720p 并发视频播放会话。
## 相关信息
[使用 Python 并发视频播放（视频墙）](https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-wall-using-python.html)
**Parent Topic:** [运行视频和音频的示例应用程序](https://docs.qualcomm.com/doc/80-70020-50SC/topic/audio-sample-applications.html)
Last Published: Jul 23, 2025
[Previous Topic
运行视频和音频的示例应用程序](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/audio-sample-applications.md) [Next Topic
智能 codec](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/smart-codec.md)