如何编写可根据网速切换画质的简易自适应视频流服务器

你要做的带宽自适应切画质需求，用HLS（HTTP Live Streaming）协议实现成本最低，完全匹配你“预存多版本视频、验证切换逻辑”的要求，不需要从零开发复杂的流处理、带宽检测逻辑，30分钟就能搭完可验证的环境。 #

核心逻辑说明 #

• 自适应切换的核心逻辑不需要你自己写：HLS协议原生支持多码率适配，成熟的播放器端会自动测算实时下载带宽，自动选择匹配当前网络的最高画质流加载，不需要服务端做实时带宽计算。
• 服务端仅需提供静态文件托管能力即可，不需要开发专门的流媒体服务逻辑，完全符合极简要求。

分步实现步骤 #

1. 预处理多码率视频资源 #

你已经准备好同一视频的不同画质/码率版本，只需要用ffmpeg把每个版本转成HLS要求的切片格式，再生成统一的主索引文件即可。
首先为每个画质版本生成独立的切片目录和索引，示例命令（按你自己的文件名、码率调整参数即可）：

# 以10秒为一个切片单位，转换1080p 8Mbps版本
ffmpeg -i 1080p_8mbps.mp4 -c copy -start_number 0 -hls_time 10 -hls_list_size 0 -f hls ./1080p/index.m3u8
# 转换720p 4Mbps版本
ffmpeg -i 720p_4mbps.mp4 -c copy -start_number 0 -hls_time 10 -hls_list_size 0 -f hls ./720p/index.m3u8
# 转换480p 2Mbps版本
ffmpeg -i 480p_2mbps.mp4 -c copy -start_number 0 -hls_time 10 -hls_list_size 0 -f hls ./480p/index.m3u8

参数说明：-hls_time 10代表每个视频切片时长为10秒，切片越短，画质切换的响应速度越快，验证场景下设10秒足够。
转换完成后，在根目录创建主索引文件master.m3u8，标注所有可选画质的码率、分辨率和对应索引路径，播放器读取这个文件就能知道所有可选的画质版本：

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=8000000,RESOLUTION=1920x1080
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=4000000,RESOLUTION=1280x720
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2000000,RESOLUTION=854x480
480p/index.m3u8

注意：BANDWIDTH字段要填写对应画质版本的实际码率，单位为bps，数值偏差太大会导致切换逻辑不符合预期。

2. 搭建静态文件服务器 #

不需要复杂的流媒体服务程序，任何能正常提供HTTP静态文件访问的服务都能用，本地验证直接用Python自带的HTTP服务即可：
进入存放所有m3u8索引、ts切片文件的根目录，执行命令：

python3 -m http.server 8000

启动后访问http://localhost:8000能看到文件目录即代表服务正常。

3. 编写最简播放页面 #

写一个简单的HTML页面实现播放，Safari浏览器原生支持HLS播放，其他浏览器引入hls.js库即可支持，示例代码：

<!DOCTYPE html>
<html>
<head>
    <title>自适应码率测试</title>
</head>
<body>
    <video id="player" controls autoplay width="1280"></video>
    <script src="hls.min.js"></script>
    <script>
        const video = document.getElementById('player');
        if (Hls.isSupported()) {
            const hls = new Hls();
            // 加载主索引文件后，播放器会自动执行带宽检测和画质切换
            hls.loadSource('/master.m3u8');
            hls.attachMedia(video);
        } else if (video.canPlayType('application/vnd.apple.mpegurl')) {
            video.src = '/master.m3u8';
        }
    </script>
</body>
</html>

把这个html文件和hls.min.js一起放到静态服务的根目录即可。 #

切换效果验证方法 #

• 打开浏览器访问播放页，视频正常加载播放后，打开浏览器开发者工具，切换到「网络」面板
• 开启网络限速功能，将带宽调整为低速率（比如Slow 3G），等待1-2个切片周期（10-20秒），就能看到播放器自动请求低码率目录下的ts切片，画质自动降低
• 关闭限速恢复正常网络，等待1-2个切片周期，播放器会自动切回高码率流
• 你可以直接查看网络请求的文件路径，确认当前加载的是哪个画质目录下的切片，直观验证切换逻辑是否符合预期

补充说明 #

不推荐从零手写带宽检测、流切换逻辑：自适应码率的边界情况非常多（比如卡顿回退、缓冲预判、切换平滑处理），重复造轮子的成本很高，用成熟的HLS标准实现完全能满足你的验证需求，不需要额外开发复杂逻辑。 #

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