核心能力

设计目标

AliPlayerKit 是一套面向业务的 低代码播放器 UI 组件 与 场景化解决方案。通过对播放器能力和 UI 交互的高度封装，帮助客户以极低的接入成本快速完成 App 播放能力建设，无需直接调用底层播放器 API，也无需自行实现复杂的播放器 UI：

架构层级

在架构层级上，AliPlayerKit位于播放器内核之上，通过统一的UI组件体系与播放场景抽象，承载不同播放业务的共性能力：

组件职责

核心接口

每个播放器实例需要调用的核心接口：

调用时序

核心接口的完整调用流程，涵盖从创建、绑定、播放到释放的全生命周期。

插槽系统

插槽系统 将播放器 UI 拆分为独立的插槽组件，每个插槽负责界面的一部分功能，如顶部控制栏、底部进度条、封面图等。开发者可以像搭积木一样自由组合：使用默认界面快速接入，或按需替换特定组件，甚至完全自定义整个界面。

UI 组件与播放器核心彻底解耦，定制不再意味着修改源码，升级也无需担心代码冲突。不同播放场景可以复用相同的插槽组件，减少重复开发。

内置插槽类型：

插槽系统支持三个层级的可见性控制：插槽级（整体隐藏/显示）、场景级（按 SceneType 控制）、元素级（位掩码控制插槽内部子元素，如隐藏返回按钮或禁用特定手势）。还支持通过 CustomSlotType 注册自定义插槽。详情请参见插槽系统。

策略系统

策略系统 将播放器的业务逻辑封装为独立的策略组件，每个策略承载一个明确的功能。策略通过 StrategyProtocol 协议定义生命周期（strategyDidStart: / strategyDidStop / strategyDidReset:），通过 StrategyManager 统一管理，每个策略的执行通过 @try/@catch 隔离，单个策略异常不影响其他策略。

内置策略：

通过 StrategyRegistry 可注册全局默认策略工厂，每个新创建的 AliPlayerController 自动装载。业务方也可以在实例级通过 strategyManager 按需注册或注销自定义策略，无需侵入框架核心。详情请参见策略系统。

通知系统

通知系统 采用 Notification Dispatcher + Delegate 模式实现组件间的完全解耦。

iOS 端通过三组独立的通知协议实现分类通知分发：

UI 组件通过 Delegate 协议订阅关心的通知，无需持有控制器引用；控制器通过 Dispatcher 多播分发状态变化，无需关心谁在监听。基于实例粒度的通知隔离，每个 Controller 持有独立的 Dispatcher 实例，不同播放器实例的通知互不干扰。详情请参见通知系统。

播放器生命周期策略

播放器生命周期策略通过PlayerLifecycleStrategy 协议对播放器实例的创建、复用、回收与销毁进行统一管理。

内置四种策略：

开发者无需关心底层实现细节，只需选择合适的策略，即可在性能与资源之间取得最佳平衡。例如，短视频列表场景下使用 ReusePool 策略复用实例，可显著提升滑动流畅度和首帧速度。详情请参见播放器生命周期策略。

日志系统

日志系统 提供统一的日志中心 LogHub，支持六个级别（Verbose / Debug / Info / Warn / Error / None）的过滤输出。播放器运行时的每一个关键节点都有迹可循，为问题定位和性能分析提供支持。

通过 LogObserver 协议扩展日志去向——可将日志写入文件或上报服务器，便于线上问题排查。开发阶段开启 Verbose 辅助调试，生产环境设为 Error 精简输出。

// 设置日志级别
[AliPlayerKit setLogLevel:LogLevelVerbose];
// 启用/禁用控制台日志
[AliPlayerKit enableConsoleLog:YES];

详情请参见日志系统。

多视频源支持

AliPlayerKit支持多种视频源类型，推荐使用VidAuth方式，详情请参见多视频源支持。

自定义配置

自定义配置提供双层级配置机制，允许开发者在关键时机注入自定义 SDK 配置，无需修改框架源码即可完成全局或实例级的精细调参。详情请参见自定义配置。

// 全局配置
[AliPlayerKit setOnGlobalInitBlock:^{
    // 在 setup 后执行一次
}];

// 实例配置
model.onPlayerConfigBlock = ^(id<MediaPlayer> player) {
    // 在 prepare 前执行，可访问底层播放器实例

本地化系统

本地化系统支持 SDK 内部所有 UI 文本的多语言切换，内置简体中文（zh-Hans）和英语（en）。

通过 LocaleProvider 协议，宿主 App 可覆盖任意文案——Provider 返回 nil 时自动降级到 SDK 内置翻译。详情请参见多语言。

全屏与防录屏

全屏过渡系统：通过FullscreenTransition协议抽象全屏进入与退出行为，默认实现 DefaultFullscreenTransition采用独立Window旋转方案。可通过playerView.fullscreenTransition注入自定义实现，以适配特殊业务场景。

防录屏能力：通过AliPlayerModel.disableScreenshot = YES启用。启用后视频渲染视图将嵌入安全容器，截屏或录屏时视频画面自动变黑，UI 控件不受影响。

预加载系统

预加载系统 通过 PlayerPreloader 协议封装播放器 SDK 的全局预加载能力，支持添加、取消、暂停和恢复预加载任务。内置 DefaultPlayerPreloader 实现，也可通过 [AliPlayerKit setPreloader:] 注入自定义实现。

场景类型

SceneType 枚举定义播放场景，影响插槽可见性配置和 UI 行为差异。详情请参见场景类型。