2. 使用gst-launch-1.0测试硬件解码

任务目标

在嵌入式平台（如Rockchip、NXP i.MX8等）上，使用gst-launch-1.0命令行工具快速验证硬件视频解码器是否正常工作。通过构建一条从文件读取→硬件解码→渲染显示的Pipeline，确认硬件解码链路可用，并区分硬解与软解的行为差异。

环境准备

确保系统已安装GStreamer及对应平台的硬件解码插件。不同平台插件名称不同：

• Rockchip平台：mpph264dec、mpph265dec（通常由gst-rockchip包提供）
• NXP i.MX8平台：v4l2h264dec、v4l2h265dec（由gst-plugins-good的v4l2插件配合内核驱动提供）
• 通用检查命令：gst-inspect-1.0 | grep -i dec 查看可用解码器

核心实现

以下命令以Rockchip平台为例，测试H.264硬件解码。若使用其他平台，替换解码器名称即可。

# 1. 查看硬件解码器是否存在
gst-inspect-1.0 mpph264dec

# 2. 硬解Pipeline：文件→硬解→渲染（带帧率统计）
gst-launch-1.0 -v filesrc location=test.h264 ! h264parse ! mpph264dec ! fpsdisplaysink video-sink=xvimagesink text-overlay=false

# 3. 软解对照Pipeline（用于对比CPU占用）
gst-launch-1.0 -v filesrc location=test.h264 ! h264parse ! avdec_h264 ! fpsdisplaysink video-sink=xvimagesink text-overlay=false

# 4. 无显示环境下的硬解测试（仅验证解码能力，不渲染）
gst-launch-1.0 filesrc location=test.h264 ! h264parse ! mpph264dec ! fakesink

验证方法与判定标准

执行上述命令后，按以下标准判断硬件解码是否正常工作：

• 插件存在性：gst-inspect-1.0 mpph264dec能正常输出插件信息（含Pad、属性等），说明插件已安装。
• 解码成功标志：Pipeline运行后终端出现Setting pipeline to PLAYING且无ERROR日志；视频窗口正常显示画面，或fakesink模式下Pipeline运行数秒后能通过Ctrl+C正常退出。
• 硬解生效确认：对比第2步与第3步命令，在播放相同视频时，使用top命令观察CPU占用率。硬解模式下CPU占用率应显著低于软解模式（例如软解占用80%以上时，硬解通常低于30%，具体数值取决于平台与视频分辨率）。
• 帧率验证：使用fpsdisplaysink时，终端会周期性打印实际渲染帧率。若视频源帧率为30fps，硬解Pipeline显示的帧率应接近30fps且不出现大量丢帧警告。

常见问题排查

• 提示no element "mpph264dec"：插件未安装或平台不匹配。执行sudo apt install gstreamer1.0-rockchip（Debian/Ubuntu）或从源码编译安装对应插件。
• 视频窗口黑屏但无报错：显示环境问题。尝试将video-sink改为waylandsink（Wayland环境）或kmssink（DRM环境）。
• 解码报DRM_IOCTL或MMU错误：多为硬件解码器被占用或驱动异常。重启设备或检查是否有其他进程占用/dev/video*或/dev/dri/*设备节点。

测试视频文件test.h264可使用以下命令生成（需安装gst-plugins-base）：

gst-launch-1.0 videotestsrc num-buffers=300 ! video/x-raw,width=1280,height=720,format=I420 ! x264enc ! h264parse ! qtmux ! filesink location=test.mp4

若需裸H.264流，将qtmux去掉并修改文件后缀为.h264即可。