QML Multimedia无法播放FFmpeg生成的m3u8流问题排查

问题背景 #

我用FFmpeg将IP摄像头RTSP流转为HLS直播流，命令如下：

ffmpeg -re -i "rtsp://<user>:<password>@<ip>:<port>" -c:v copy -c:a copy -hls_segment_type mpegts -hls_list_size 5 -hls_wrap 5 -hls_time 2 -hls_flags split_by_time -segment_time_delta 1.00 -reset_timestamps 1 -hls_allow_cache 0 -movflags faststart live.m3u8

命令能正常生成live.m3u8和5个循环覆盖的TS片段，某时刻live.m3u8内容：

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:2
#EXT-X-MEDIA-SEQUENCE:92
#EXTINF:2.000000,
live2.ts
#EXTINF:2.000000,
live3.ts
#EXTINF:2.035800,
live4.ts
#EXTINF:2.000000,
live0.ts
#EXTINF:1.963278,
live1.ts

但用以下QML代码播放时，仅能播放首个片段：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtMultimedia 5.15

Window
{
    width: 640
    height: 480
    visible: true

    Item
    {
        anchors.fill: parent

        MediaPlayer
        {
            id: mediaplayer
            source: "path-to-live/live.m3u8"
            videoOutput: videoOutput
        }

        VideoOutput
        {
            id: videoOutput
            anchors.fill: parent
        }

        MouseArea
        {
            anchors.fill: parent
            onPressed: mediaplayer.play();
        }
    }
}

奇怪的是，手动删除live.m3u8让FFmpeg重新生成后，QML就能正常持续播放。

问题根源分析 #

1. FFmpeg参数冗余+直播模式未明确

   • -movflags faststart是MP4文件优化参数，对HLS完全无用，反而可能干扰FFmpeg的输出逻辑
   • 未指定-hls_type live，FFmpeg默认可能以点播模式生成m3u8，导致Qt误判为静态列表
   • 初始生成的m3u8是完整的静态列表，Qt加载后不会主动检测文件更新

2. Qt MediaPlayer本地文件缓存逻辑

   • 直接加载本地m3u8文件时，Qt会缓存文件内容，不会实时监听文件变化
   • 手动删除m3u8后，FFmpeg重新生成的是动态追加的文件，Qt加载新文件时会触发直播模式的轮询机制，从而持续获取更新的片段

解决方案 #

1. 调整FFmpeg命令（核心） #

去掉无用参数，明确直播模式，添加自动指向最新片段的标志：

ffmpeg -re -i "rtsp://<user>:<password>@<ip>:<port>" -c:v copy -c:a copy -hls_segment_type mpegts -hls_list_size 5 -hls_wrap 5 -hls_time 2 -hls_flags split_by_time+live_start_index -segment_time_delta 1.00 -reset_timestamps 1 -hls_allow_cache 0 -hls_type live live.m3u8

参数说明：

• 移除-movflags faststart：完全无用的MP4优化参数
• 添加-hls_type live：明确标记为直播流，FFmpeg不会写入EXT-X-ENDLIST标签
• 添加live_start_index：让m3u8默认指向最新片段，避免Qt加载旧序列

2. 优化QML代码（确保实时刷新） #

改用Playlist组件，并监听播放状态，在流结束时重新加载列表：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtMultimedia 5.15

Window
{
    width: 640
    height: 480
    visible: true

    Item
    {
        anchors.fill: parent

        Playlist {
            id: playlist
            PlaylistItem { source: "path-to-live/live.m3u8" }
        }

        MediaPlayer
        {
            id: mediaplayer
            playlist: playlist
            videoOutput: videoOutput
            playbackRate: 1.0

            onMediaStatusChanged: {
                // 直播流"结束"时重新加载播放列表，触发m3u8更新检测
                if (mediaStatus === MediaPlayer.EndOfMedia) {
                    playlist.load();
                    mediaplayer.play();
                }
            }
        }

        VideoOutput
        {
            id: videoOutput
            anchors.fill: parent
        }

        MouseArea
        {
            anchors.fill: parent
            onPressed: mediaplayer.play();
        }
    }
}

3. 进阶优化：改用HTTP提供HLS流 #

Qt对HTTP协议的HLS直播支持更完善，会自动定期请求m3u8更新。可以用简单的HTTP服务器托管流文件：

• 用Python启动临时服务器：python -m http.server 8000（在流文件目录执行）
• QML中修改source为http://localhost:8000/live.m3u8

总结 #

问题核心是FFmpeg未明确直播模式，且Qt对本地文件HLS的实时更新支持有限。通过调整FFmpeg参数标记直播流，配合QML的Playlist组件或HTTP托管，即可解决仅播放首个片段的问题。

内容的提问来源于stack exchange，提问作者LeXela-ED