编码与格式 / 系统课时

项目需求与架构

项目需求与架构

本课为综合项目确定可交付边界:同一套应用既能播放本地或网络媒体,也能接入直播流。你将得到一份可执行的需求清单、模块划分和数据流设计,后续实现可以据此逐项开发与验收。

学习目标

  • 区分播放器与直播功能的最小需求
  • 设计可复用的媒体处理模块与控制层
  • 用配置和验收项约束项目范围

明确最小交付范围

播放器模式负责打开文件或点播地址、解封装、音视频解码、同步、渲染,以及暂停、继续和跳转。直播模式负责接入实时流、低延迟播放、断线重连和基础统计,不承诺任意时刻跳转。

首个版本不加入转码集群、内容审核、多路合成和复杂账号系统。这些能力会显著扩大基础设施范围,却不能帮助验证核心媒体链路。项目先保证单路输入、单窗口播放和可观察性。

架构与数据流

控制层接收“打开、播放、暂停、停止”命令,并维护会话状态;媒体流水线负责数据处理;基础设施层提供线程池、时钟、缓存、日志和指标。播放器与直播共用解封装、解码、同步和渲染模块,只在输入策略与缓冲策略上分开。

播放器与直播综合项目架构

媒体数据从输入适配器进入解封装器,再按轨道写入音频队列和视频队列。解码后的帧交给同步模块,音频通常作为主时钟,视频根据时间差等待、立即显示或丢帧。控制命令不直接修改底层对象,而是通过会话服务改变状态并协调各模块。

用配置固化边界

下面的 JSON 是项目基线配置,不是某个框架的固定格式。它把两种模式、缓冲目标和模块开关集中管理,便于开发环境与测试环境使用同一份约束。

json
{
  "project": {
    "name": "av-player-live-demo",
    "modes": {
      "player": {
        "enabled": true,
        "seek": true,
        "reconnect": false
      },
      "live": {
        "enabled": true,
        "seek": false,
        "reconnect": true
      }
    }
  },
  "pipeline": {
    "demuxer": true,
    "audioDecoder": true,
    "videoDecoder": true,
    "synchronizer": true,
    "audioOutput": true,
    "videoRenderer": true
  },
  "buffer": {
    "playerTargetMs": 1500,
    "liveTargetMs": 300,
    "liveMaxMs": 1000
  },
  "observability": {
    "structuredLog": true,
    "metrics": [
      "input_fps",
      "render_fps",
      "audio_video_drift_ms",
      "reconnect_count"
    ]
  }
}

生效行为是:播放器允许跳转但不自动重连;直播禁止跳转并开启重连;两种模式共用同一媒体流水线。将配置保存为 project.json,再用下面的 Python 脚本检查关键约束。

python
import json
from pathlib import Path

config = json.loads(Path("project.json").read_text(encoding="utf-8"))

player = config["project"]["modes"]["player"]
live = config["project"]["modes"]["live"]
buffer_config = config["buffer"]

assert player["seek"] is True
assert live["seek"] is False
assert live["reconnect"] is True
assert buffer_config["liveTargetMs"] < buffer_config["playerTargetMs"]

required_modules = {
    "demuxer",
    "audioDecoder",
    "videoDecoder",
    "synchronizer",
    "audioOutput",
    "videoRenderer",
}
enabled_modules = {
    name for name, enabled in config["pipeline"].items() if enabled
}
assert required_modules <= enabled_modules

print("architecture config valid")

将脚本保存为 validate_architecture.py 后运行:

bash
python validate_architecture.py

预期输出:

text
architecture config valid

状态与异常策略

会话状态可简化为 IDLE、OPENING、PLAYING、PAUSED、RECONNECTING、STOPPED 和 FAILED。播放器读取失败通常直接进入失败状态;直播发生短暂网络错误时先进入重连状态,超过最大次数后再失败。

所有异步任务都必须绑定同一个会话 ID。停止会话时,先禁止新数据进入,再唤醒阻塞队列、停止解码线程、释放输出设备,最后关闭输入。这个顺序可以避免线程仍在使用已释放资源。

项目验收标准

播放器验收包括:能打开测试文件、音画同步、暂停恢复、跳转后继续播放、停止后资源释放。直播验收包括:能接入测试流、延迟保持在配置范围、网络中断后自动恢复、连续重连失败时给出明确状态。

两种模式都要输出结构化日志和基础指标。发生黑屏、无声或卡顿时,至少能判断问题位于输入、解封装、解码、同步还是渲染阶段,而不是只得到“播放失败”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与架构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通