monibuca/plugin/mp4/README_CN.md

MP4 plugin for m7s

功能列表

• 支持 MP4 录制（支持分片,支持自定义文件名）
• 支持 HTTP 拉流
• 支持 录制 拉流（可从指定时间开始）
• 支持 MP4 文件拉流
• 支持下载指定时间段 MP4 文件（拼装）

录制

支持正则表达式替换录制文件名 配置示例：

mp4:
  onpub:
    record:
      ^live/(.+)$:
        fragment: 10s
        filepath: record/$1

MP4 文件拉流

mp4 文件拉流是指读取 MP4 文件，然后转换成 m7s 的流，从而可以订阅该流从而观看该 MP4 文件视频。

例如：

mp4:
  pull:
    live/test: /Users/dexter/Movies/test.mp4

此时，启动 m7s 后，会生成一条流 live/test，可以订阅该流从而观看该 MP4 文件视频。

录制拉流

录制拉流指的是从录制的 MP4 文件中拉流，支持从指定时间开始拉流。拉流后，会在服务器中产生一条流，可以订阅该流从而观看录像。 步骤：

1. 录制 mp4 通常采用分片录制方式，每次录制一个文件都会在数据库中存储信息
2. 配置按需拉流，录制拉流通常采用按需拉流方式

按需拉流就是由订阅驱动发布，例如：

mp4:
  onsub:
    pull:
      vod/test: live/test

此时如果有人订阅了 vod/test 流，那么就会从数据库中查询streamPath 为 live/test 录制文件，并且根据拉流参数中的 start 和 end（可选） 参数筛选录制文件。

例如使用 ffplay 播放：

ffplay rtmp://localhost/vod/test?start=2021-01-01T00:00:00

如果需要配置一个更通用的录制拉流，可以使用正则表达式：

mp4:
  onsub:
    pull:
      ^vod/(.+)$: live/$1

如果不同的订阅者希望看到不同时间的录像，就需要使得拉流的名称变成唯一的：

mp4:
  onsub:
    pull:
      ^vod/([^/]+)/([^/]+)$: live/$1

此时如果有人订阅了 vod/test/123 流，那么就会从数据库中查询streamPath 为 live/test 录制文件，并且根据拉流参数中的 start 参数筛选录制文件。 此时 123 就是某个订阅者的唯一标识。

拼装逻辑

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文件流