HLS 协议

HLS（HTTP Live Streaming）是 Apple 提出的基于 HTTP 的流媒体协议。通过将直播流切割为 TS 片段并生成 M3U8 播放列表，HLS 具有极佳的 CDN 兼容性和设备覆盖率，是大规模分发的首选协议。

基本信息

属性	值
传输层	HTTP（共享引擎 HTTP 端口）
推流	❌ 不支持
拉流	✅ 支持
延迟	5-30 秒（取决于切片时长）
Feature Flag	hls

配置

Feature 启用

Cargo.toml

[features]
hls = ["dep:plugin-hls"]

配置文件

hls:
  enable: true
  segment_duration: 6
  max_segments: 5
  output_dir: "./hls"
  write_to_disk: true

配置项	类型	默认值	说明
enable	bool	true	是否启用 HLS 插件
segment_duration	u64	6	TS 切片时长（秒）
max_segments	usize	5	播放列表保留的最大切片数
output_dir	string	"./hls"	切片文件输出目录
write_to_disk	bool	true	是否将切片写入磁盘

提示

减小 segment_duration 可以降低延迟，但会增加请求频率。通常直播场景建议 2-6 秒，点播场景可以使用 6-10 秒。

URL 格式

M3U8 播放列表

http://host:port/hls/{streamPath}/index.m3u8

TS 切片

http://host:port/hls/{streamPath}/{sequence}.ts

示例：

http://localhost:8080/hls/live/test/index.m3u8
http://localhost:8080/hls/live/test/0.ts

拉流播放

使用 FFplay

ffplay http://localhost:8080/hls/live/test/index.m3u8

使用 VLC

1. 打开 VLC，选择 媒体 → 打开网络串流
2. 输入 URL：http://localhost:8080/hls/live/test/index.m3u8
3. 点击 播放

浏览器播放

使用 hls.js 在浏览器中播放：

<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
<video id="player" controls></video>
<script>
  const video = document.getElementById('player');
  if (Hls.isSupported()) {
    const hls = new Hls();
    hls.loadSource('http://localhost:8080/hls/live/test/index.m3u8');
    hls.attachMedia(video);
    hls.on(Hls.Events.MANIFEST_PARSED, () => video.play());
  } else if (video.canPlayType('application/vnd.apple.mpegurl')) {
    // Safari 原生支持
    video.src = 'http://localhost:8080/hls/live/test/index.m3u8';
    video.play();
  }
</script>

注意

Safari 浏览器原生支持 HLS，无需引入 hls.js。

HLS 录制

HLS 插件提供录制 API，可以将流录制为 HLS 格式（M3U8 + TS 文件）：

# 开始录制
curl -X POST http://localhost:8080/hls/record/start/live/test

# 停止录制
curl -X POST http://localhost:8080/hls/record/stop/live/test

# 查看录制列表
curl http://localhost:8080/hls/record/list

# 查看录制状态
curl http://localhost:8080/hls/record/status/live/test

# 查询历史录像
curl http://localhost:8080/hls/record/records

工作原理

1. 订阅流：当首次请求 HLS 播放列表时，插件自动订阅对应的流
2. 切片生成：从流中持续读取帧数据，按 segment_duration 切割为 TS 片段
3. 播放列表更新：每生成一个新切片，自动更新 M3U8 播放列表
4. 滑动窗口：保留最近 max_segments 个切片，旧切片自动清理
5. 存储策略：切片同时保存在内存和磁盘（取决于 write_to_disk 配置）

延迟优化

HLS 的延迟主要由以下因素决定：

总延迟 ≈ segment_duration × (max_segments - 1) + 播放器缓冲

优化建议：

# 低延迟配置
hls:
  segment_duration: 2
  max_segments: 3

此配置下理论最低延迟约 4-6 秒。

警告

过短的切片时长可能导致播放器频繁请求，在弱网环境下反而降低体验。请根据实际场景权衡。

典型工作流

# 1. 通过 RTMP 推流
ffmpeg -re -i input.mp4 -c copy -f flv rtmp://localhost:1935/live/test

# 2. 通过 HLS 拉流
ffplay http://localhost:8080/hls/live/test/index.m3u8

# 3. 也可以同时通过其他协议拉流
ffplay http://localhost:8080/flv/live/test.flv