# 视频播放
Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/gst-video-playback-example.html](https://docs.qualcomm.com/doc/80-70022-50SC/topic/gst-video-playback-example.html)
**gst-video-playback-example** 应用程序可以解码和播放视频文件。支持播放、暂停、恢复和快进等标准播放选项。
下图展示了视频播放 GStreamer 应用程序的 pipeline 工作流。对文件进行读取、解复用、解析、解码并显示在屏幕上。有关插件的更多信息，请参见 [Pipeline 流](https://docs.qualcomm.com/doc/80-70022-50SC/topic/gst-video-playback-example.html#gst-video-playback-example__section_op1_zwh_4bc)。
Figure : gst-video-playback-example pipeline
为了有效地使用此应用程序，您需要了解 GStreamer pipeline 结构。
## 运行应用程序
1. 确保您已完成[前提条件](https://docs.qualcomm.com/doc/80-70022-50SC/topic/mm_sample_apps_prerequisites.html)。
2. 在目标设备上输入 `AVC.mp4 (H.264)` 和 `HEVC.mp4 (H.265)` 视频文件。
3. 在目标设备的终端中播放视频文件：
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
4. 要停止用例，请使用 CTRL +
C。
5. 在目标设备的终端中，在 SSH shell 中运行以下命令以显示可用的帮助选项：
gst-video-playback-example --helpCopy to clipboard
## 预期输出
视频被采集、解码并在本地显示器上播放。
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-70022-50SC/topic/v4l2h264dec.html) | 解码 H.264 格式的视频流 |
| [v4l2h265dec](https://docs.qualcomm.com/doc/80-70022-50SC/topic/v4l2h265dec.html) | 将视频流解码为 H.265 格式。 |
| [Waylandsink](https://docs.qualcomm.com/doc/80-70022-50SC/topic/waylandsink.html) | 在 Wayland 显示器上以全屏模式显示视频。 |
## 已知问题
不支持倒退播放选项
## 相关信息
- [使用 OpenCV 进行视频转换](https://docs.qualcomm.com/doc/80-70022-50SC/topic/video-playback-using-opencv.html)
- [视频播放用例](https://docs.qualcomm.com/doc/80-70022-50SC/topic/video-playback-use-cases.html)
**Parent Topic:** [运行视频和音频的示例应用程序](https://docs.qualcomm.com/doc/80-70022-50SC/topic/audio-sample-applications.html)
Last Published: Nov 05, 2025
[Previous Topic
视频转码](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/gst-video-transcode-example.md) [Next Topic
音频和视频编码](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/gst-audio-video-encode.md)