splitmuxsink生成的最后一段录屏视频无法播放问题求助

问题原因 #

当通过CTRL-C强制终止程序或系统崩溃时，splitmuxsink来不及完成当前MKV文件的封装收尾——MKV容器需要写入关键索引和元数据才能被播放器识别，异常终止会导致这部分数据缺失，最终造成视频无法播放。

解决方案 #

1. 捕获信号实现优雅退出（针对CTRL-C场景） #

直接使用gst-launch-1.0无法处理信号触发的优雅退出，建议用GStreamer的Python绑定编写简单脚本，捕获SIGINT信号后给管道发送EOS事件，让splitmuxsink完成当前文件的封装：

import gi
import signal
import sys

gi.require_version('Gst', '1.0')
from gi.repository import Gst, GObject

Gst.init(None)
GObject.threads_init()

def handle_sigint(sig, frame):
    print("\n收到终止信号，正在优雅关闭管道...")
    pipeline.send_event(Gst.Event.new_eos())

# 构建管道
pipeline_str = """
ximagesrc startx=0
! video/x-raw, framerate=15/1
! videoscale
! videoconvert
! x264enc speed-preset=superfast tune=zerolatency key-int-max=10
! h264parse
! splitmuxsink location=video%02d.mkv \
    async-finalize=true \
    muxer-factory=matroskamux \
    max-size-time=60000000000 \
    muxer-properties="properties, streamable=true"
"""

pipeline = Gst.parse_launch(pipeline_str)
bus = pipeline.get_bus()
bus.add_signal_watch()

def on_message(bus, message):
    t = message.type
    if t == Gst.MessageType.EOS:
        print("管道已正常关闭")
        pipeline.set_state(Gst.State.NULL)
        sys.exit(0)
    elif t == Gst.MessageType.ERROR:
        err, debug = message.parse_error()
        print(f"错误: {err.message}, 调试信息: {debug}")
        pipeline.set_state(Gst.State.NULL)
        sys.exit(1)

bus.connect("message", on_message)
signal.signal(signal.SIGINT, handle_sigint)

# 启动管道
pipeline.set_state(Gst.State.PLAYING)

# 运行主循环
loop = GObject.MainLoop()
try:
    loop.run()
except Exception as e:
    print(f"异常: {e}")
    pipeline.set_state(Gst.State.NULL)
    sys.exit(1)

2. 调整管道参数优化容错 #

修改splitmuxsink参数，提升异常场景下的容错能力：

• 启用send-keyframe-requests=true：让splitmuxsink在分割文件前请求关键帧，即使最后一段文件损坏，也能从最近的关键帧开始修复
• 保留async-finalize=true：让splitmuxsink异步完成文件收尾，减少阻塞

修改后的splitmuxsink片段：

! splitmuxsink location=video%02d.mkv \
    async-finalize=true \
    send-keyframe-requests=true \
    muxer-factory=matroskamux \
    max-size-time=60000000000 \
    muxer-properties="properties, streamable=true"

3. 修复已损坏的视频文件 #

对于已生成的损坏MKV文件，可通过ffmpeg重建索引和元数据，修复后即可正常播放：

ffmpeg -i videoXX.mkv -c copy fixed_videoXX.mkv

系统崩溃场景的额外建议 #

如果是系统异常崩溃导致的问题，无法通过信号处理优雅退出，可采取以下措施：

• 降低max-size-time的值，比如设置为5分钟（30000000000），减少单次崩溃丢失的视频时长
• 定期用ffmpeg扫描并修复最新的视频文件，确保即使崩溃也能恢复最近的录屏内容

内容的提问来源于stack exchange，提问作者Maynafiesta