编码与格式 / 系统课时
项目需求与架构
项目需求与架构
本课为综合项目确定可交付边界:同一套应用既能播放本地或网络媒体,也能接入直播流。你将得到一份可执行的需求清单、模块划分和数据流设计,后续实现可以据此逐项开发与验收。
学习目标
- 区分播放器与直播功能的最小需求
- 设计可复用的媒体处理模块与控制层
- 用配置和验收项约束项目范围
明确最小交付范围
播放器模式负责打开文件或点播地址、解封装、音视频解码、同步、渲染,以及暂停、继续和跳转。直播模式负责接入实时流、低延迟播放、断线重连和基础统计,不承诺任意时刻跳转。
首个版本不加入转码集群、内容审核、多路合成和复杂账号系统。这些能力会显著扩大基础设施范围,却不能帮助验证核心媒体链路。项目先保证单路输入、单窗口播放和可观察性。
架构与数据流
控制层接收“打开、播放、暂停、停止”命令,并维护会话状态;媒体流水线负责数据处理;基础设施层提供线程池、时钟、缓存、日志和指标。播放器与直播共用解封装、解码、同步和渲染模块,只在输入策略与缓冲策略上分开。

媒体数据从输入适配器进入解封装器,再按轨道写入音频队列和视频队列。解码后的帧交给同步模块,音频通常作为主时钟,视频根据时间差等待、立即显示或丢帧。控制命令不直接修改底层对象,而是通过会话服务改变状态并协调各模块。
用配置固化边界
下面的 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 脚本检查关键约束。
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 后运行:
python validate_architecture.py预期输出:
architecture config valid状态与异常策略
会话状态可简化为 IDLE、OPENING、PLAYING、PAUSED、RECONNECTING、STOPPED 和 FAILED。播放器读取失败通常直接进入失败状态;直播发生短暂网络错误时先进入重连状态,超过最大次数后再失败。
所有异步任务都必须绑定同一个会话 ID。停止会话时,先禁止新数据进入,再唤醒阻塞队列、停止解码线程、释放输出设备,最后关闭输入。这个顺序可以避免线程仍在使用已释放资源。
项目验收标准
播放器验收包括:能打开测试文件、音画同步、暂停恢复、跳转后继续播放、停止后资源释放。直播验收包括:能接入测试流、延迟保持在配置范围、网络中断后自动恢复、连续重连失败时给出明确状态。
两种模式都要输出结构化日志和基础指标。发生黑屏、无声或卡顿时,至少能判断问题位于输入、解封装、解码、同步还是渲染阶段,而不是只得到“播放失败”。