mirror of
https://github.com/langhuihui/monibuca.git
synced 2025-12-24 13:48:04 +08:00
176 lines
5.4 KiB
Markdown
176 lines
5.4 KiB
Markdown
# MP4 plugin for m7s
|
||
|
||
## 功能列表
|
||
|
||
- [x] 支持 MP4 录制（支持分片,支持自定义文件名）
|
||
- [x] 支持 HTTP 拉流
|
||
- [x] 支持 录制 拉流（可从指定时间开始）
|
||
- [x] 支持 MP4 文件拉流
|
||
- [x] 支持下载指定时间段 MP4 文件（拼装）
|
||
|
||
### 录制
|
||
支持正则表达式替换录制文件名
|
||
配置示例：
|
||
```yaml
|
||
mp4:
|
||
onpub:
|
||
record:
|
||
^live/(.+)$:
|
||
fragment: 10s
|
||
filepath: record/$1
|
||
```
|
||
|
||
### MP4 文件拉流
|
||
|
||
mp4 文件拉流是指读取 MP4 文件，然后转换成 m7s 的流，从而可以订阅该流从而观看该 MP4 文件视频。
|
||
|
||
例如：
|
||
|
||
```yaml
|
||
mp4:
|
||
pull:
|
||
live/test: /Users/dexter/Movies/test.mp4
|
||
```
|
||
此时，启动 m7s 后，会生成一条流 `live/test`，可以订阅该流从而观看该 MP4 文件视频。
|
||
|
||
### 录制拉流
|
||
|
||
录制拉流指的是从录制的 MP4 文件中拉流，支持从指定时间开始拉流。拉流后，会在服务器中产生一条流，可以订阅该流从而观看录像。
|
||
步骤：
|
||
1. 录制 mp4 通常采用分片录制方式，每次录制一个文件都会在数据库中存储信息
|
||
2. 配置按需拉流，录制拉流通常采用按需拉流方式
|
||
|
||
按需拉流就是由订阅驱动发布，例如：
|
||
|
||
```yaml
|
||
mp4:
|
||
onsub:
|
||
pull:
|
||
vod/test: live/test
|
||
```
|
||
|
||
此时如果有人订阅了 vod/test 流，那么就会从数据库中查询streamPath 为 `live/test` 录制文件，并且根据拉流参数中的 start 和 end（可选） 参数筛选录制文件。
|
||
|
||
例如使用 ffplay 播放：
|
||
|
||
```shell
|
||
ffplay rtmp://localhost/vod/test?start=2021-01-01T00:00:00
|
||
```
|
||
|
||
如果需要配置一个更通用的录制拉流，可以使用正则表达式：
|
||
|
||
```yaml
|
||
mp4:
|
||
onsub:
|
||
pull:
|
||
^vod/(.+)$: live/$1
|
||
```
|
||
|
||
如果不同的订阅者希望看到不同时间的录像，就需要使得拉流的名称变成唯一的：
|
||
|
||
```yaml
|
||
mp4:
|
||
onsub:
|
||
pull:
|
||
^vod/([^/]+)/([^/]+)$: live/$1
|
||
```
|
||
|
||
此时如果有人订阅了 vod/test/123 流，那么就会从数据库中查询streamPath 为 `live/test` 录制文件，并且根据拉流参数中的 start 参数筛选录制文件。
|
||
此时 123 就是某个订阅者的唯一标识。
|
||
|
||
|
||
## 拼装逻辑
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant Client
|
||
participant Handler as download()
|
||
participant DB as Database
|
||
participant Muxer as MP4Muxer
|
||
participant File1 as RecordFile1
|
||
participant File2 as RecordFile2
|
||
participant FileN as RecordFileN
|
||
participant Writer as ResponseWriter
|
||
|
||
Client->>Handler: GET /download?start=xxx&end=xxx
|
||
Handler->>Handler: 解析时间范围参数
|
||
Handler->>DB: 查询时间范围内的录制文件
|
||
DB-->>Handler: 返回 streams[]
|
||
|
||
Handler->>Muxer: NewMuxer(flag)
|
||
Handler->>Muxer: CreateFTYPBox()
|
||
|
||
Note over Handler: 初始化变量：lastTs, tsOffset, parts[], audioTrack, videoTrack
|
||
|
||
loop 遍历每个录制文件
|
||
Handler->>File1: os.Open(stream.FilePath)
|
||
File1-->>Handler: file handle
|
||
Handler->>File1: NewDemuxer(file)
|
||
Handler->>File1: demuxer.Demux()
|
||
File1-->>Handler: 解析完成
|
||
|
||
alt 第一个文件
|
||
Handler->>Handler: 处理开始时间偏移
|
||
loop 处理每个track
|
||
Handler->>Muxer: AddTrack(track.Cid)
|
||
Muxer-->>Handler: 新轨道
|
||
end
|
||
end
|
||
|
||
Note over Handler: 设置 tsOffset = lastTs
|
||
|
||
loop 处理每个样本 (RangeSample)
|
||
alt 最后一个文件 && 超出结束时间
|
||
Handler->>Handler: break (跳出循环)
|
||
else
|
||
Handler->>Handler: 创建 ContentPart
|
||
Handler->>Handler: 计算调整后时间戳
|
||
|
||
alt flag == 0 (常规MP4)
|
||
Handler->>Handler: 调整样本偏移量
|
||
Handler->>Muxer: AddSampleEntry(fixSample)
|
||
else flag == FLAG_FRAGMENT (分片MP4)
|
||
Handler->>File1: 读取样本数据
|
||
File1-->>Handler: sample.Data
|
||
Handler->>Muxer: CreateFlagment(track, sample)
|
||
Muxer-->>Handler: moof, mdat boxes
|
||
Handler->>Handler: 添加到 part.boxies
|
||
end
|
||
|
||
Handler->>Handler: 更新 lastTs
|
||
end
|
||
end
|
||
|
||
Handler->>Handler: 添加 part 到 parts[]
|
||
Handler->>File1: Close()
|
||
end
|
||
|
||
alt flag == 0 (常规MP4模式)
|
||
Handler->>Muxer: MakeMoov()
|
||
Muxer-->>Handler: moov box
|
||
Handler->>Handler: 计算总大小
|
||
Handler->>Writer: Set Content-Length header
|
||
Handler->>Writer: 调整样本偏移量
|
||
Handler->>Muxer: CreateBaseBox(MDAT)
|
||
Muxer-->>Handler: mdat box
|
||
|
||
Handler->>Writer: WriteTo(ftyp, moov, free, mdat header)
|
||
|
||
loop 写入所有内容片段
|
||
Handler->>Handler: part.Seek(part.Start)
|
||
Handler->>Writer: io.CopyN(writer, part.File, part.Size)
|
||
Handler->>Handler: part.Close()
|
||
end
|
||
|
||
else flag == FLAG_FRAGMENT (分片MP4模式)
|
||
Handler->>Handler: 组装所有 children boxes
|
||
Handler->>Handler: 计算总大小
|
||
Handler->>Writer: Set Content-Length header
|
||
Handler->>Writer: WriteTo(所有boxes)
|
||
|
||
loop 关闭所有文件
|
||
Handler->>Handler: part.Close()
|
||
end
|
||
end
|
||
|
||
Handler-->>Client: MP4文件流
|
||
``` |