# 视频播放
Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-video-playback-example.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-video-playback-example.html)
**gst-video-playback-example** 应用程序可以解码和播放视频文件。支持播放、暂停、恢复和快进等标准播放选项。
下图展示了视频播放 GStreamer 应用程序的 pipeline 工作流。对文件进行读取、解复用、解析、解码并显示在屏幕上。有关插件的更多信息，请参见 [Pipeline 流](https://docs.qualcomm.com/doc/80-70020-50SC/topic/gst-video-playback-example.html#gst-video-playback-example__section_op1_zwh_4bc)。
Figure : gst-video-playback-example 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)。
为了有效地使用此应用程序，您需要了解 GStreamer pipeline 结构。
## 运行应用程序
1. 将视频文件加载到设备上。
2. 播放视频文件：
gst-video-playback-example -e filesrc location=.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! video/x-raw,format=NV12 ! waylandsink enable-last-sample=false fullscreen=trueCopy to clipboard
下表提供了命令行参数的说明： | 命令行参数 | 说明 |
| --- | --- |
| `` | 指定要播放的 MP4 输入文件 |
| `` | 指定视频渲染器。
h264parse 用于 H.264
h265parse 用于 H.265
|
| `` | 指定视频解码器。
v4l2h264dec 用于 H.264
v4l2h265dec 用于 H.265
|
运行视频播放用例：
- 播放 AVC（H.264）视频：
gst-video-playback-example -e filesrc location=.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=4 output-io-mode=4 ! waylandsink enable-last-sample=false fullscreen=trueCopy to clipboard
- 播放 HEVC (H.265) 视频：
gst-video-playback-example -e filesrc location=.mp4 ! qtdemux ! queue ! h265parse ! v4l2h265dec capture-io-mode=4 output-io-mode=4 ! waylandsink enable-last-sample=false fullscreen=trueCopy to clipboard
要显示可用的帮助选项，请在 SSH shell 中运行以下命令：
gst-video-playback-example --helpCopy to clipboard
要停止用例，请按 CTRL + C。
## 预期输出
视频被采集、解码并在本地显示器上播放。
Figure : gst-video-playback-example 应用程序的预期输出
## Pipeline 流
下表列出了用于运行视频播放 pipeline 的插件：| 插件 | 说明 |
| --- | --- |
| filesrc | 读取 AVC 或 HEVC MP4 文件 |
| qtdemux | 解复用 AVC 或 HEVC MP4 文件 |
| h264parse | 渲染 H.264 格式的视频流。 |
| h265parse | 渲染 H.265 格式的视频流 |
| [v4l2h264dec](https://docs.qualcomm.com/doc/80-70020-50SC/topic/v4l2h264dec.html) | 解码 H.264 格式的视频流 |
| [v4l2h265dec](https://docs.qualcomm.com/doc/80-70020-50SC/topic/v4l2h265dec.html) | 将视频流解码为 H.265 格式。 |
| [Waylandsink](https://docs.qualcomm.com/doc/80-70020-50SC/topic/waylandsink.html) | 在 Wayland 显示器上以全屏模式显示视频。 |
## 已知问题
不支持倒退播放选项
## 相关信息
- [使用 OpenCV 进行视频转换](https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-playback-using-opencv.html)
- [视频播放用例](https://docs.qualcomm.com/doc/80-70020-50SC/topic/video-playback-use-cases.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/gst-video-transcode-example.md) [Next Topic
音频和视频编码](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/gst-audio-video-encode.md)