Flutter 音视频架构：播放状态机、Texture、缓存、DRM 与采集

维度	示例
生命周期	idle、initializing、ready、disposed
播放意图	playWhenReady / pausedByUser
播放推进	playing、stalled、ended
Buffer	buffered ranges、buffering、buffer exhausted
错误	recoverable、fatal、DRM、source、decoder

如果只使用 isPlaying、isLoading、hasError 三个布尔值，会产生矛盾组合：

用户希望播放，但正在缓冲，所以实际没有推进；
已有旧画面且后台补 Buffer，不应显示全屏 Loading；
到达结尾后 isPlaying=false，但语义不是用户暂停；
音频焦点临时丢失导致暂停，恢复策略不同于用户主动暂停。

4.1 Sealed 生命周期状态

sealed class PlayerLifecycleState {
  const PlayerLifecycleState();
}
 
final class PlayerIdle extends PlayerLifecycleState {
  const PlayerIdle();
}
 
final class PlayerInitializing extends PlayerLifecycleState {
  const PlayerInitializing();
}
 
final class PlayerReady extends PlayerLifecycleState {
  const PlayerReady();
}
 
final class PlayerFailed extends PlayerLifecycleState {
  const PlayerFailed(this.failure);
  final MediaFailure failure;
}
 
final class PlayerDisposed extends PlayerLifecycleState {
  const PlayerDisposed();
}

4.2 正交状态组合

final class PlayerSnapshot {
  const PlayerSnapshot({
    required this.lifecycle,
    required this.playWhenReady,
    required this.isAdvancing,
    required this.isBuffering,
    required this.position,
    required this.duration,
    required this.buffered,
    required this.speed,
  });
 
  final PlayerLifecycleState lifecycle;
  final bool playWhenReady;
  final bool isAdvancing;
  final bool isBuffering;
  final Duration position;
  final Duration? duration;
  final List<DurationRange> buffered;
  final double speed;
}

playWhenReady=true 且 isAdvancing=false、isBuffering=true 表示用户希望播放但 Buffer 不足。将意图与实际推进分开后，UI 和恢复策略才清晰。

4.3 典型状态转换

实际播放器可能由底层状态和业务意图组合，而不是单一枚举。重要的是定义每个事件在当前状态是否合法，以及异步结果如何防止跨媒体源污染。

五、媒体源切换与异步竞态

信息流快速滑动时，播放器可能连续绑定视频 A、B、C。A 的初始化结果晚到，不能覆盖 C。

final class MediaController {
  MediaController(this._platformPlayer);
 
  final PlatformPlayer _platformPlayer;
  int _sourceGeneration = 0;
  bool _disposed = false;
 
  Future<void> setSource(MediaSource source) async {
    final generation = ++_sourceGeneration;
    emit(const PlayerSnapshot.initializing());
 
    try {
      final metadata = await _platformPlayer.prepare(source);
      if (_disposed || generation != _sourceGeneration) return;
      emit(PlayerSnapshot.ready(metadata));
    } catch (error, stackTrace) {
      if (_disposed || generation != _sourceGeneration) return;
      logger.error('media prepare failed', error, stackTrace);
      emit(PlayerSnapshot.failed(mapMediaFailure(error)));
    }
  }
 
  Future<void> dispose() async {
    if (_disposed) return;
    _disposed = true;
    _sourceGeneration++;
    await _platformPlayer.dispose();
  }
}

生产实现还要：

取消旧网络、DRM 和解码准备任务；
用媒体实例 ID 过滤迟到事件；
确保 Texture ID 与当前实例对应；
防止旧播放器释放新播放器资源；
对 dispose 和平台回调做幂等处理。

mounted 只能保护 Widget，不足以验证结果属于当前媒体源。

六、Texture 渲染：视频帧如何进入 Flutter

视频不适合把每一帧编码成 Uint8List 经 MethodChannel 传入 Dart。1080p RGBA 一帧粗略约 8 MB，30 fps 会带来巨大的复制、分配和 Channel 压力。

更常见的路径是平台播放器把帧输出到平台 Buffer/Surface，注册为 Flutter 可消费的 Texture，并把一个轻量 Texture ID 交给 Dart。

Dart 侧只需：

AspectRatio(
  aspectRatio: videoWidth / videoHeight,
  child: Texture(textureId: textureId),
)

6.1 Texture 的优势

视频帧避免逐帧穿过通用消息编解码；
Flutter 可以在 Scene 中布局、变换和覆盖控制层；
控制 UI 保持 Flutter 风格；
与 Platform View 相比，通常更适合纯画面输出。

6.2 Texture 不是零成本

仍可能涉及：

Decoder 输出格式转换；
Buffer 队列与同步；
GPU 纹理导入和合成；
旋转、色彩空间与 HDR 处理；
帧生产速度与屏幕 VSync 不匹配；
Texture 生命周期和内存。

Android Surface/SurfaceTexture、iOS Pixel Buffer/Metal 以及 Flutter Engine 的具体对接会随插件、渲染后端和 SDK 版本变化。性能必须真机验证。

6.3 控制事件不要每帧跨 Channel

播放位置 UI 通常不需要 60 Hz 原生回调。可以：

平台每 200~500 ms 推送校准位置；
Flutter 在播放期间用 Ticker/Timer 做视觉插值；
暂停、Seek、Buffering、速率变化时立即校准；
后台时降低或停止 UI 更新。

具体频率取决于字幕、歌词、直播和进度条精度，必须平衡准确性与消息成本。

七、首帧：先定义“第一帧”是什么

常见时间点：

用户点击播放。
调用 setSource。
清单/媒体元数据可用。
播放器 ready。
第一帧被解码。
第一帧提交给 Texture。
Flutter 合成并显示非占位画面。
音频首次输出。

不同团队说“首帧 300 ms”可能使用不同起终点，数据不可比较。

7.1 推荐指标

Time to Metadata：设置媒体源到元数据可用；
Time to Ready：设置媒体源到可播放；
Video First Frame：播放意图到用户可见视频帧；
Audio First Sample：播放意图到可听音频；
Join Time：直播进入到连续播放；
Poster Gap：封面消失到首帧显示之间的空白。

播放器报告 decoded first frame 不一定等于屏幕已显示。若业务要求严格，应结合 Texture 首帧回调、Flutter Frame Timing 或截图/像素检测验证呈现时刻。

7.2 优化首帧的方向

就近 CDN 与连接复用；
合理首分片大小；
首选码率不过高；
预取清单或首分片，但控制流量和缓存污染；
复用播放器需彻底重置旧状态；
提前准备解码器要权衡内存；
封面保持到真实首帧到达，避免黑屏；
将非关键鉴权、埋点从阻塞路径移开；
DRM License 预取必须符合安全与授权策略。

优化必须先拆分 DNS、连接、TTFB、清单、Buffer、DRM、Decoder 和呈现阶段，不能只测总时间猜根因。

八、缓冲：下载速度与消费速度的竞争

播放器持续消费媒体数据，网络持续补充 Buffer。当下载吞吐低于媒体码率，Buffer 会下降并最终耗尽。

buffer change ≈ downloaded media duration - consumed duration

实际系统还受分片、码率切换、解码队列和直播窗口影响。

8.1 三种不同 Loading

状态	用户体验	UI 建议
Initial buffering	还没有可播放内容	封面 + 启动进度
Rebuffering	播放中断，等待数据	保留最后画面 + 轻量 Loading
Background buffering	仍在播放，后台补数据	通常不遮挡画面

一个 isBuffering 不能决定所有 UI。还需知道是否曾显示首帧、是否实际推进、Buffer Range 和用户播放意图。

8.2 Buffer 策略取舍

起播 Buffer 小：首帧快，但弱网更易卡顿；
起播 Buffer 大：首帧慢，但启动后更稳定；
最大 Buffer 大：抗抖动更强，但占内存、流量和缓存；
直播 Buffer 小：延迟低，但更敏感；
点播预取多：Seek 更快，但可能下载用户不会看的内容。

没有统一最优值。短视频、长视频、音乐、直播和离线播放应有不同策略。

8.3 卡顿指标

Rebuffer Count；
Rebuffer Duration；
Rebuffer Ratio = 卡顿总时长 / 播放会话时长；
Time to First Rebuffer；
Buffer Level 分布；
卡顿前网络吞吐、所选码率和 Decoder 状态。

需要区分网络 Buffering 与 Decoder/Renderer 卡住，UI 上都可能表现为“不动”。

九、Seek：定位不是简单修改 position

压缩视频通常依赖关键帧（I-frame）。随机 Seek 到任意时间点时，播放器可能需要先定位到目标附近关键帧，再解码后续帧直到目标。

9.1 Seek 精度与速度

Fast/Closest Sync：定位关键帧附近，快但不精确；
Accurate/Exact：继续解码到目标，慢且消耗更多 CPU/网络；
Live Seek：受直播 DVR Window 限制；
音频 Seek：仍可能受索引、编码帧和流类型限制。

具体 API 能否保证精确 Seek 取决于播放器、容器索引、流协议和平台。

9.2 连续拖动进度条

不要为每个 Pointer Move 发起完整 Seek：

Flutter 本地更新预览位置。
对缩略图请求节流并取消旧请求。
用户松手后提交最终 Seek。
Seek 使用 generation，忽略先前完成事件。
Seek 完成后根据 playWhenReady 恢复播放或保持暂停。

Future<void> seekTo(Duration target) async {
  final generation = ++_seekGeneration;
  emit(state.copyWith(seekTarget: target, isSeeking: true));
 
  try {
    final actual = await player.seek(target);
    if (_disposed || generation != _seekGeneration) return;
    emit(state.copyWith(
      position: actual,
      seekTarget: null,
      isSeeking: false,
    ));
  } catch (error, stackTrace) {
    if (_disposed || generation != _seekGeneration) return;
    logger.warning('seek failed', error, stackTrace);
    emit(state.copyWith(seekTarget: null, isSeeking: false));
  }
}

十、后台播放不是应用不销毁就行

后台音频需要与系统媒体基础设施集成。

10.1 Android

典型能力包括：

合规的前台服务；
Media Session；
媒体样式通知；
音频焦点；
耳机、蓝牙与 Noisy Intent；
系统媒体按钮和锁屏控制；
Android 版本对应的权限与后台执行限制。

10.2 iOS

典型能力包括：

正确配置音频会话 Category/Mode/Options；
声明确有业务需要的 Background Audio Mode；
接收系统中断与 Route Change；
Now Playing Info；
Remote Command Center；
遵守 App Store 和平台后台政策。

后台能力、权限和商店规则会随系统版本变化。实现时必须查阅目标 Android/iOS 版本与所选插件的当前官方文档。

10.3 前后台策略矩阵

媒体类型	页面不可见	应用后台	常见策略
音乐/播客	可继续	经用户授权继续	系统媒体会话
短视频 Feed	暂停	暂停	回前台按可见项恢复
视频课程	产品决定	常转音频或暂停	保留位置，明确提示
视频通话	保持会话	按平台通话能力	音频路由和系统集成
相机预览	停止/释放	必须停止	返回后重建 Session

后台播放是产品能力，不应所有播放器默认开启。

十一、音频焦点与系统中断

音频焦点用于协调多个 App 的声音输出，但 Android 和 iOS 的 API 与事件模型不同。业务层应映射为稳定语义：

sealed class AudioInterruption {
  const AudioInterruption();
}
 
final class InterruptionBegan extends AudioInterruption {
  const InterruptionBegan({required this.mayDuck});
  final bool mayDuck;
}
 
final class InterruptionEnded extends AudioInterruption {
  const InterruptionEnded({required this.mayResume});
  final bool mayResume;
}
 
final class AudioRouteBecameNoisy extends AudioInterruption {
  const AudioRouteBecameNoisy();
}

11.1 暂停、Duck 还是继续

音乐遇到导航播报：可以 Duck；
播客遇到短暂中断：通常暂停更合适；
来电：暂停，并记录中断前是否由用户播放；
耳机拔出：立即暂停，避免扬声器外放；
用户主动暂停后发生中断恢复：不能自动播放。

bool _wasPlayingBeforeInterruption = false;
 
void onInterruptionBegan({required bool mayDuck}) {
  _wasPlayingBeforeInterruption = state.isAdvancing;
  if (mayDuck && policy.allowsDucking) {
    player.setVolume(policy.duckVolume);
  } else {
    player.pause();
  }
}
 
void onInterruptionEnded({required bool mayResume}) {
  player.setVolume(state.userVolume);
  if (mayResume && _wasPlayingBeforeInterruption && !state.pausedByUser) {
    player.play();
  }
  _wasPlayingBeforeInterruption = false;
}

恢复条件必须组合系统许可、此前意图和当前页面/会话状态。异步期间媒体源可能已经切换，因此还需验证实例 ID。

11.2 音频会话是进程级共享资源

多个播放器、录音器、视频通话和语音消息可能争用同一个音频会话。应建立集中 Audio Session Coordinator，根据当前最高优先级场景配置系统，而不是每个插件独自覆盖 Category/Focus。

十二、播放器生命周期

需要区分：

Widget 是否 mounted；
Route 是否当前可见；
Tab 是否选中；
应用是否 resumed；
原生容器是否可见；
Engine 是否仍连接；
播放器是否仍拥有解码器和 Texture。

bool get shouldRenderVideo =>
    appIsVisible && routeIsCurrent && tabIsSelected && !disposed;
 
bool get shouldPlay =>
    shouldRenderVideo &&
    userWantsPlayback &&
    !audioInterrupted &&
    sourceIsReady;

12.1 资源释放

播放器 dispose 应清理：

原生 Player；
Texture/Surface；
Channel/Event Handler；
音频焦点和媒体会话；
网络和 DRM 请求；
Timer、StreamSubscription 和位置回调；
缓存文件句柄；
屏幕常亮锁和横竖屏设置。

清理应幂等。页面退出后如果业务需要后台音频，播放器所有权应提升到 Session/Playback Service，而不是被页面 dispose；页面只解除 UI 订阅。

12.2 播放器池

短视频 Feed 可考虑少量播放器复用，但需要明确：

当前、前一个、后一个视频的预热数量；
Source 切换 generation；
旧 Texture 与事件清理；
DRM Session 是否可复用；
用户、Cookie、Header 隔离；
内存压力时淘汰；
不同编码能力导致的 Decoder 重建。

播放器池会增加状态复杂度，必须用首帧和内存数据证明收益。

Cache Key 包含 URL、Range、Header 中影响内容的字段；
TTL、ETag 或服务端失效策略；
LRU/容量上限；
用户和租户隔离；
Range Request 正确性；
部分分片完整性校验；
清单更新和直播窗口处理；
敏感 Header 不落日志。

13.3 离线下载

离线内容需要完整下载状态机、空间预算、断点续传、清单版本和许可证治理：

不要把普通播放器临时缓存包装成“离线下载”，两者在完整性、可发现性、过期和 DRM 上承诺不同。

13.4 缓存不是越大越好

需要衡量：

Cache Hit Ratio；
节省流量；
磁盘占用和写放大；
首帧与卡顿改善；
内容更新后的陈旧率；
用户主动清理与系统空间压力；
隐私和账号退出清理。

十四、多清晰度与自适应码率

多清晰度通常由 HLS、MPEG-DASH 或其他流媒体清单描述多个 Variant/Rendition。每个变体可能有不同：

分辨率；
视频码率；
编码格式和 Profile；
帧率；
HDR/色彩空间；
音频轨道和语言；
DRM 信息。

14.1 ABR 选择因素

Adaptive Bitrate（ABR，自适应码率）通常考虑：

最近分片下载吞吐；
当前 Buffer Level；
视口尺寸和设备像素比；
Decoder 能力；
用户选择和流量偏好；
直播延迟；
切换稳定性与滞回。

只根据瞬时网速切换会来回震荡。通常需要保守系数、滑动估计和上下切换不同阈值。

14.2 手动清晰度与自动模式

Auto：由 ABR 选择；
指定清晰度：约束到用户选择，但网络不足时是继续卡顿还是允许降级要明确；
切换时保留位置和播放意图；
音视频时间线、分片边界和 DRM 配置要兼容；
UI 显示的是分辨率标签还是实际当前轨道，应区分。

“选择 1080p”不代表每一帧都以固定码率传输，也不代表设备能硬件解码该 Codec/Profile。

14.3 服务端同样决定体验

客户端无法修复：

码率梯度断层；
GOP 过长导致 Seek/切换慢；
分片时间线不对齐；
音视频时间戳错误；
CDN Range/缓存配置错误；
清单声明与实际编码不一致。

媒体问题必须联合转码、打包、CDN 和客户端排查。

十五、DRM：不仅是一个 License URL

DRM 常涉及：

加密媒体内容；
Manifest 中的保护信息；
CDM/平台 DRM 模块；
License Challenge 与 License Server；
用户认证和内容授权；
Key、License 生命周期；
安全解码与输出保护；
离线许可证。

Android 常见 Widevine，Apple 平台常见 FairPlay Streaming；具体能力、等级、离线支持和输出限制取决于设备、系统、播放器和内容策略。

15.1 客户端安全边界

不在 Dart 代码硬编码长期 License Secret；
播放 Token 短期、最小权限并由服务端授权；
License 请求和响应不写日志；
不自行把明文 Key 存数据库；
遵守 HDCP、截图/录屏和安全 Surface 策略；
Root/Jailbreak 检测只能提高门槛，不能成为唯一授权依据；
账号退出、设备撤销和内容过期后清理离线 License。

15.2 DRM 错误分类

Provisioning 失败；
设备不支持指定方案或安全级别；
License 网络失败；
认证过期；
内容授权拒绝；
License 过期；
Key Rotation 失败；
输出保护不满足；
加密轨道与清单不兼容。

只有瞬时网络错误适合有限重试。授权拒绝和设备能力不足不会通过盲目重试恢复。

在用户理解用途的时机请求；
区分首次拒绝、永久拒绝和系统限制；
录制有声视频还需麦克风权限；
权限可能在系统设置中改变，恢复前台时重新校验；
不在权限未授予时打开采集设备；
隐私声明与平台配置必须一致。

16.3 方向、镜像与比例

需要区分：

Sensor Orientation；
Device Orientation；
Preview Rotation；
Capture Rotation Metadata；
前置摄像头预览镜像；
最终照片/视频是否镜像；
Preview cover 裁剪与实际取景范围。

只对 Flutter Widget 旋转画面不一定修复输出文件方向。元数据和像素旋转要根据下游兼容性处理。

sealed class RecordingState {
  const RecordingState();
}
 
final class RecordingIdle extends RecordingState {
  const RecordingIdle();
}
 
final class RecordingStarting extends RecordingState {
  const RecordingStarting();
}
 
final class RecordingActive extends RecordingState {
  const RecordingActive(this.startedAt);
  final DateTime startedAt;
}
 
final class RecordingStopping extends RecordingState {
  const RecordingStopping();
}
 
final class RecordingCompleted extends RecordingState {
  const RecordingCompleted(this.output);
  final CapturedMedia output;
}
 
final class RecordingFailed extends RecordingState {
  const RecordingFailed(this.failure, {required this.recoverable});
  final CaptureFailure failure;
  final bool recoverable;
}

快速双击、开始期间停止、录制中切摄像头等非法操作应被状态机拒绝或排队，不能同时调用底层 API。

17.3 异常路径

用户撤销权限；
来电或音频会话中断；
应用进入后台；
磁盘空间不足；
文件写入失败；
编码器初始化或运行失败；
摄像头被占用；
温度或系统资源限制；
进程终止；
最大时长/文件大小到达；
蓝牙麦克风或音频路由变化。

每条路径要定义：自动结束并保留、丢弃临时文件、允许重试还是提示用户。

17.4 临时文件与原子完成

建议：

在应用私有临时目录写入。
使用唯一 Capture ID，避免文件名冲突。
Stop 后关闭编码器和 Muxer。
校验文件存在、大小、时长和可解码性。
原子移动/登记为已完成媒体。
上传成功或用户放弃后按策略清理。
冷启动扫描并删除超龄临时文件。

不要先把未完成路径加入相册或上传队列。

17.5 录音特有边界

Sample Rate、Channel Count、Bit Depth 与编码格式；
音频会话 Category/Mode；
回声消除、降噪和自动增益是否适用；
蓝牙设备的 Profile 与带宽限制；
波形数据的采样节流；
音频焦点和其他播放器协调；
隐私指示器和后台录音政策。

语音消息、音乐录制和实时通话的音频处理目标不同，不能共享一套默认参数。

十八、错误模型与恢复策略

sealed class MediaFailure {
  const MediaFailure();
}
 
final class MediaNetworkFailure extends MediaFailure {
  const MediaNetworkFailure({required this.isTransient});
  final bool isTransient;
}
 
final class MediaSourceUnsupported extends MediaFailure {
  const MediaSourceUnsupported(this.codecOrContainer);
  final String codecOrContainer;
}
 
final class MediaDecoderFailure extends MediaFailure {
  const MediaDecoderFailure();
}
 
final class MediaDrmFailure extends MediaFailure {
  const MediaDrmFailure(this.reason);
  final DrmFailureReason reason;
}
 
final class CapturePermissionDenied extends MediaFailure {
  const CapturePermissionDenied({required this.permanently});
  final bool permanently;
}
 
final class CaptureStorageFull extends MediaFailure {
  const CaptureStorageFull();
}

恢复策略：

错误	常见处理
瞬时网络失败	幂等读取有限退避重试，保留播放位置
内容 404/下架	不重试，展示业务状态
Decoder 暂时异常	有限重建播放器，避免无限循环
Codec 不支持	降级轨道或明确提示
DRM 授权拒绝	不盲重试，走登录/购买/设备提示
相机权限拒绝	解释用途，永久拒绝时引导系统设置
磁盘满	停止并安全完成/丢弃，提示清理空间
用户取消	静默结束，不当作崩溃上报

底层原始错误和 StackTrace 应进入脱敏诊断；UI 消费稳定业务错误，不展示 License URL、Token、文件绝对路径或设备隐私信息。

十九、性能与内存

音视频资源大量位于 Dart Heap 之外：

Decoder Buffer；
音频 PCM Buffer；
视频帧和 GPU Texture；
Surface/Pixel Buffer；
Player/Codec 原生对象；
HTTP Cache 和文件映射；
Camera Capture Buffer；
Encoder/Muxer；
DRM Session。

Dart Heap 稳定不能证明没有媒体泄漏。

19.1 视频帧内存直觉

1920 x 1080 的 RGBA 帧约 7.9 MiB；YUV 格式通常更紧凑，但播放器可能同时持有多帧、转换 Buffer 和 GPU 资源。4K、多播放器预热和高帧率会快速提高峰值。

这只是粗略估算，实际像素格式、对齐、Buffer 数量和零拷贝路径由平台实现决定。

19.2 关键性能指标

Video First Frame / Audio First Sample；
Rebuffer Count、Duration、Ratio；
Dropped Video Frames；
A/V Sync Drift；
Decoder Init/Reuse Failure；
平均与 P95/P99 播放启动时间；
ABR 切换次数、上切/下切原因；
平均播放码率和清晰度；
Texture/Player 实例数；
Dart/Native/Graphics 内存；
相机打开时间、拍照耗时、录像完成耗时；
录制失败和临时文件残留率。

19.3 测量工具

Flutter DevTools：UI/Raster Frame、Dart CPU、Dart Memory；
Android：Perfetto、Android Studio Profiler、dumpsys meminfo、媒体/Codec 日志；
iOS：Instruments Time Profiler、Allocations、Leaks、Energy Log；
网络代理/CDN 日志：清单、分片、TTFB、Range、缓存命中；
播放器平台诊断：轨道、Decoder、Buffer、Dropped Frames；
外部摄像机或屏幕录制：首帧与音画同步验证。

所有结论应注明 Flutter/插件/系统版本、设备、构建模式、媒体样本、网络条件和屏幕刷新率。

二十、可观测性与 QoE

QoE（Quality of Experience，体验质量）事件应围绕一次播放 Session：

session_start
source_prepare_start
manifest_loaded
drm_license_start / end
player_ready
first_video_frame
playback_started
rebuffer_start / end
quality_changed
seek_start / end
interruption_begin / end
playback_ended / failed
session_end

20.1 Session 标识

至少区分：

Playback Session ID；
Media Content ID；
Player Instance ID；
Source Generation；
当前 CDN/清晰度/Codec；
App/Route 生命周期。

不要把包含签名 Token 的完整媒体 URL 当 Content ID 上报。

20.2 卡顿归因

不能把所有“卡住”都归类为网络 Buffering。

二十一、安全与隐私

相机和麦克风权限按需申请，并展示清晰用途；
采集指示器和系统隐私行为不能绕过；
临时录音录像放在应用私有目录；
上传使用 TLS、短期授权和服务端内容校验；
日志不记录媒体签名 URL、License、Token、文件内容和用户语音；
用户退出或删除内容时执行缓存和离线 License 清理策略；
截图/录屏限制只能提高保护程度，不能保证内容无法被外部设备录制；
客户端 DRM、混淆和 Root 检测都不能替代服务端授权；
第三方播放器、Codec 和媒体 SDK 纳入供应链与漏洞治理。

录制和上传还应考虑未成年人、地域法规、用户同意、数据保留期限和删除机制。

二十二、测试矩阵

22.1 播放功能

首次播放、暂停、继续、结束和重播；
快速切源和连续 Feed 滑动；
起播前 Seek、播放中 Seek、连续拖动；
倍速、静音、音轨和字幕切换；
清晰度 Auto/手动切换；
本地文件、点播、直播和离线内容；
受保护和非 DRM 内容；
横竖屏、全屏和画中画（若支持）。

22.2 网络与媒体样本

高延迟、低带宽、抖动、丢包和断网恢复；
Wi-Fi/蜂窝切换；
404、403、429、5xx 和分片损坏；
清单更新、直播窗口滑动和 CDN 切换；
不同 Codec、Profile、分辨率、帧率和音频格式；
VFR（可变帧率）、异常时间戳和超长 GOP；
音轨缺失、纯音频和无声视频。

22.3 生命周期与音频

Route 覆盖、Tab 切换、前后台和锁屏；
来电、闹钟、语音助手和导航播报；
耳机插拔、蓝牙切换和扬声器路由；
用户暂停后发生中断，确保不自动恢复；
后台控制、通知、锁屏信息与媒体按键；
低内存后播放器重建。

22.4 相机与录制

权限允许、拒绝、永久拒绝和设置中撤销；
前后摄像头切换；
各方向、镜像、裁剪与最终文件；
开始/停止快速点击；
录制中来电、后台、锁屏和音频路由变化；
磁盘不足、最大时长、编码失败；
冷启动临时文件清理；
文件可解码、时长和音画同步。

22.5 设备矩阵

Android/iOS 最低支持与主流系统；
低端、中端、高端设备；
不同 GPU、Decoder 能力和屏幕刷新率；
刘海、折叠屏、平板和多窗口；
真机而非只用模拟器。

二十三、自动化与故障注入

23.1 状态机单元测试

test('用户主动暂停后，中断结束不会自动恢复', () {
  final machine = PlayerStateMachine.playing();
 
  machine.onUserPause();
  machine.onInterruptionBegan(mayDuck: false);
  machine.onInterruptionEnded(mayResume: true);
 
  expect(machine.state.playWhenReady, isFalse);
  expect(machine.commands, isNot(contains(PlayerCommand.play)));
});