# 录制端实时推流场景：推流即写入 front-moov
ffmpeg -i rtmp://live.example.com/meeting/room101 
  -c copy -movflags +faststart 
  -f mp4 /data/record/room101_$(date +%s).mp4

# 后处理场景：对已生成文件原地调整
ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4

ftyp (iso6/iso5/msdh)
moov
  ├ mvhd
  ├ trak (video)
  │   ├ tkhd
  │   ├ mdia → minf → stbl (样本表指向后续 moof)
  │   └ ...
  ├ trak (audio)
  └ mvex (mehd + trex*)  ← 关键：声明后续 moof 使用的默认参数
moof (Segment 1)
  ├ mfhd (sequence_number)
  └ traf
      ├ tfhd (track_fragment_header, 继承 trex)
      ├ tfdt (baseMediaDecodeTime)
      ├ trun (track_run, 样本 size/flags/offset)
      └ mdat (Segment 1 媒体数据)
moof (Segment 2)
  ...
moof (Segment N)
  ...

# GPAC MP4Box：生成标准 fMP4，自动计算 trex
MP4Box -dash 2000 -frag 2000 -rap -segment-name seg_ 
  -out room101_dash.mp4 input.mp4

# FFmpeg（需 6.0+）：单命令输出 fMP4
ffmpeg -i input.mp4 -c copy -f mp4 
  -movflags +frag_keyframe+empty_moov+default_base_moof 
  -segment_time 2 -reset_timestamps 1 
  room101_fmp4.mp4

// 伪代码：首屏加载流程
async function loadInitSegment(url) {
  // 1. 请求前 64 KB（覆盖 ftyp+moov+mvex）
  const initResp = await fetch(url, { headers: { Range: 'bytes=0-65535' } });
  const initBuf = await initResp.arrayBuffer();
  parseMoov(initBuf); // 解析 trex、timescale、track 信息
}

async function loadFirstMediaSegment(url, videoTrackId) {
  // 2. 根据 moov 中首个 moof 偏移，请求首段媒体数据
  const firstMoofOffset = findFirstMoofOffset(videoTrackId);
  const mediaResp = await fetch(url, {
    headers: { Range: `bytes=${firstMoofOffset}-${firstMoofOffset + 500_000}` }
  });
  // 送入 MSE SourceBuffer 解码渲染
}

// 伪代码：基于 libavformat 的增量 fMP4 写入循环
AVFormatContext *octx = nullptr;
avformat_alloc_output_context2(&octx, nullptr, "mp4", "rec_${room_id}.mp4");
// 关键标志：开启空 moov + 默认 base moof + 关键帧分片
octx->oformat->priv_class; // 设置 AVOutputFormat 私有选项
av_opt_set(octx->priv_data, "movflags", 
  "frag_keyframe+empty_moov+default_base_moof+delay_moov", 0); 
// delay_moov: 允许在写入首个 moof 前不写 moov，配合手动 flush

// 打开 IO 上下文（支持 S3/HDFS 自定义协议）
avio_open2(&octx->pb, url, AVIO_FLAG_WRITE, &intcb, &opts);

// 写入文件头（仅 ftyp + 空 moov + mvex/trex）
avformat_write_header(octx, nullptr); 

while (running) {
  AVPacket *pkt = av_packet_alloc();
  if (av_read_frame(ictx, pkt) >= 0) {
    // 时间基转换、关键帧标记修正
    av_packet_rescale_ts(pkt, ictx->streams[pkt->stream_index]->time_base,
                         octx->streams[pkt->stream_index]->time_base);
    pkt->flags |= (pkt->flags & AV_PKT_FLAG_KEY) ? AV_PKT_FLAG_KEY : 0;
    
    // 写入帧 → 自动触发 moof/mdat 写入（关键帧边界）
    av_interleaved_write_frame(octx, pkt);
    av_packet_unref(pkt);
  }
  
  // 每 30s 或积累 50MB 主动 flush，确保数据落盘/上传对象存储
  if (need_flush) avio_flush(octx->pb); 
}

// 正常结束：写入最终 moov 更新索引
av_write_trailer(octx);

输入流 (1080p) 
   │
   ├─► [转码集群] ──► 720p fMP4 (seg=2s, GOP=2s)
   │                 360p fMP4 (seg=2s, GOP=2s)
   │
   └─► [原画直通] ──► 1080p fMP4 (seg=2s, GOP=2s)

# FFmpeg 强制输出 hvc1 样本描述
ffmpeg -i input.mp4 -c:v libx265 -tag:v hvc1 
  -movflags +faststart+frag_keyframe+empty_moov 
  output_fmp4.mp4

# .gitlab-ci.yml 片段
stages:
  - ingest
  - process
  - qc
  - archive
  - notify

# 1. 入库校验（录制结束回调触发）
validate_container:
  stage: ingest
  image: gpac/gpac:latest
  script:
    - MP4Box -info "$INPUT" 2>&1 | tee probe.log
    - |
      if grep -q "moov not found" probe.log; then
        echo "❌ 缺失 moov，尝试恢复..."; 
        MP4Box -inter 500 -out "${INPUT%.mp4}_fixed.mp4" "$INPUT";
      fi
    - python3 scripts/check_duration.py "$INPUT" --expected $DURATION --tolerance 5

# 2. 智能转码/分片（按时长/码率分策略）
smart_transcode:
  stage: process
  image: ffmpeg:7.0
  script:
    - |
      DURATION=$(ffprobe -v error -show_entries format=duration -of csv=p=0 "$INPUT")
      if (( $(echo "$DURATION > 7200" | bc -l) )); then
        # >2h: 生成 fMP4 + 多码率
        ffmpeg -i "$INPUT" -filter_complex 
          "[v:0]split=3[v1][v2][v3]; 
           [v1]scale=1920:1080[v1o]; [v2]scale=1280:720[v2o]; [v3]scale=640:360[v3o]" 
          -map "[v1o]" -c:v:0 libx264 -b:v:0 3000k -g 60 
          -map "[v2o]" -c:v:1 libx264 -b:v:1 1500k -g 60 
          -map "[v3o]" -c:v:2 libx264 -b:v:2 600k  -g 60 
          -map a:0 -c:a aac -b:a 128k 
          -f mp4 -movflags "frag_keyframe+empty_moov+default_base_moov" 
          -segment_time 2 -reset_timestamps 1 
          "${OUTPUT_DIR}/${MEETING_ID}_%v.fmp4.mp4"
      else
        # ≤2h: 单文件 faststart
        ffmpeg -i "$INPUT" -c copy -movflags +faststart "${OUTPUT_DIR}/${MEETING_ID}.mp4"
      fi

# 3. 质检（QC）：黑帧、静音、码率波动、关键帧间隔
quality_check:
  stage: qc
  image: ffmpeg:7.0
  script:
    - |
      ffmpeg -i "$FILE" -vf "blackdetect=d=0.5:pix_th=0.1" -an -f null - 2>&1 | grep blackdetect
      ffmpeg -i "$FILE" -af "silencedetect=n=-50dB:d=2" -vn -f null - 2>&1 | grep silencedetect
      # 关键帧间隔抖动检测
      python3 scripts/check_gop_jitter.py "$FILE" --max-jitter 0.5

# 4. 分级归档（对象存储生命周期 + 数据库状态机）
archive_cold:
  stage: archive
  script:
    - python3 scripts/lifecycle_transition.py --meeting-id $MEETING_ID --tier IA
  rules:
    - if: $CI_COMMIT_BRANCH == "main" && $MEETING_AGE_DAYS > 30

# 特征工程示例
features = {
    "meeting_type": "weekly/quarterly/1v1",      # 类别特征
    "organizer_level": "VP/Director/IC",         # 组织层级
    "duration_sec": 7200,                        # 时长
    "attendee_count": 15,                        # 参会人数
    "days_since_record": 45,                     # 录制距今天数
    "last_access_days_ago": 12,                  # 最近一次访问间隔
    "tag_keywords": ["budget", "roadmap", "OKR"] # NLP 提取关键词
}
# 模型输出：P(access_next_30d) = 0.02
if P < 0.05: 
    transition_to("Archive")   # 归档存储，取回需 1 小时
elif P < 0.3:
    transition_to("IA")        # 低频存储，毫秒级取回
else:
    keep_in("Standard")        # 标准存储

graph LR
    A[原始 fMP4 分段] --> B(解码为 YUV420)
    B --> C[DCT 变换 8x8 块]
    C --> D[中频系数调制nWatermark Bit = sign(coeff) * α]
    D --> E[IDCT 重构]
    E --> F[重新编码 H.264/HEVC]
    F --> G[写入 fMP4 moof/mdat]
    G --> H[对象存储]

-- OpenResty + Lua: 请求进入边缘节点时预热
local moov_key = "moov:" .. meeting_id
local moov_data = redis:get(moov_key)
if not moov_data then
  -- 回源拉取前 64KB
  local res = ngx.location.capture("/internal/fetch_head", 
    { args = { url = s3_url, range = "0-65535" } })
  if res.status == 206 then
    moov_data = res.body
    redis:setex(moov_key, 86400, moov_data) -- 缓存 24h
  end
end
-- 直接返回给客户端，省去回源 RTT
ngx.header["Content-Range"] = "bytes 0-65535/*"
ngx.print(moov_data)

Base Layer (360p, 30fps, 500kbps)  ← 所有设备必解
  └ Enhance L1 (720p, 30fps, +1Mbps) ← 中端设备
      └ Enhance L2 (1080p, 30fps, +2Mbps) ← 高端设备