播放器生命周期策略

概念介绍

核心价值

通过策略模式管理播放器生命周期，带来以下核心优势：

• 解耦：业务代码无需关心播放器实例的创建和销毁细节。

• 灵活：运行时选择不同策略，无需修改业务代码。

• 可扩展：可实现自定义策略，满足特定业务需求。

• 可观测：统一的生命周期管理，便于监控和调试。

设计背景

播放器生命周期策略源于阿里云微短剧解决方案中的多实例播放器池，旨在应对信息流快速滑动场景下对首帧速度、切换流畅度及内存控制的严苛要求。AliPlayerKit 将该实践抽象为策略模式，构建了更通用、灵活的播放器生命周期管理架构。

功能特性

核心能力

内置策略

AliPlayerKit 提供 4 种内置的播放器生命周期策略：

架构层次

┌──────────────────────────────────────────────────────────────┐
│                  AliPlayerController                          │
│       initWithLifecycleStrategy: 注入策略                      │
│       configure: 内部调用 recycle(旧) + acquire(新)             │
│       destroy: 内部调用 recycle(player, force:YES)              │
├──────────────────────────────────────────────────────────────┤
│              PlayerLifecycleStrategy 协议                      │
│   setupWithFactory: / acquirePlayer / recyclePlayer:force:     │
│   clear / preloadWithCount: / acquirePlayerWithUniqueId:       │
├──────────────────────────────────────────────────────────────┤
│                 BaseLifecycleStrategy 基类                     │
│            factory / createPlayer / destroyPlayer:             │
├──────────┬──────────┬─────────────────┬──────────────────────┤
│ Default  │ReusePool │  IdScopedPool   │     Singleton        │
│ 每次新建  │ 池复用    │  ID 绑定 + LRU  │     全局唯一          │
└──────────┴──────────┴─────────────────┴──────────────────────┘
│                                                                │
│              PlayerFactory 协议 / DefaultPlayerFactory          │
│            createPlayer / destroyPlayer:                        │
└──────────────────────────────────────────────────────────────┘

使用方式

基本用法 — 默认策略

最简单的使用方式，无需额外配置。AliPlayerController 默认使用 DefaultLifecycleStrategy：

// 创建控制器（自动使用默认策略）
AliPlayerController *controller = [[AliPlayerController alloc] init];

// 创建播放数据
VideoSource *source = [VideoSource urlSourceWithUrl:@"https://example.com/video.mp4"];
AliPlayerModel *model = [[AliPlayerModel alloc] initWithVideoSource:source];

// 配置并绑定到播放器视图
[controller configure:model];
[self.playerView attach:controller];

默认策略行为：每次 acquirePlayer 创建新实例，每次 recyclePlayer:force: 立即销毁，不维护任何池。

复用池策略（短视频场景）

适合短视频列表、信息流等频繁切换视频的场景：

// 1. 创建复用池策略（最大容量 3）
ReusePoolLifecycleStrategy *strategy =
    [[ReusePoolLifecycleStrategy alloc] initWithMaxPoolSize:3];

// 2. 创建控制器时注入策略
AliPlayerController *controller =
    [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];

// 3. 正常配置和使用
VideoSource *source = [VideoSource urlSourceWithUrl:@"https://example.com/video.mp4"];
AliPlayerModel *model = [[AliPlayerModel alloc] initWithVideoSource:source];
[controller configure:model];
[self.playerView attach:controller];

ID 绑定策略（预加载场景）

适合需要预加载和多视频切换的场景，相同 uniqueId 始终返回同一实例：

// 1. 创建 ID 绑定策略（最大容量 3）
IdScopedPoolLifecycleStrategy *strategy =
    [[IdScopedPoolLifecycleStrategy alloc] initWithMaxPoolSize:3];

// 2. 创建控制器时注入策略
AliPlayerController *controller =
    [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];

// 3. 使用 — configure 内部通过 VideoSource.uniqueId 进行 ID 绑定
VideoSource *source = [VideoSource vidAuthSourceWithVid:@"your_video_id"
                                              playAuth:@"your_play_auth"];
AliPlayerModel *model = [[AliPlayerModel alloc] initWithVideoSource:source];
[controller configure:model];
[self.playerView attach:controller];

单例策略（列表播放场景）

全局唯一实例，所有控制器共享同一播放器：

// 获取单例策略（dispatch_once 保证全局唯一）
SingletonLifecycleStrategy *strategy =
    [SingletonLifecycleStrategy sharedInstance];

// 创建控制器
AliPlayerController *controller =
    [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];

// 所有使用此策略的控制器共享同一播放器实例
VideoSource *source = [VideoSource urlSourceWithUrl:@"https://example.com/video.mp4"];
AliPlayerModel *model = [[AliPlayerModel alloc] initWithVideoSource:source];
[controller configure:model];
[self.playerView attach:controller];

场景参考：列表播放

ScenePlaylistViewController 展示了 SingletonLifecycleStrategy 实现自动连播的完整用法：

// 初始化播放器生命周期策略
self.lifecycleStrategy = [SingletonLifecycleStrategy sharedInstance];

// 创建控制器并注入策略
self.currentController = [[AliPlayerController alloc]
    initWithLifecycleStrategy:self.lifecycleStrategy];

// 注册播放完成通知（用于触发自动播放下一个）
[self.currentController addNotificationDelegate:self];

// 配置数据并绑定（挂载后自动开始播放）
AliPlayerModel *model = [[AliPlayerModel alloc] initWithVideoSource:videoSource];
[self.currentController configure:model];
[self.playerView attach:self.currentController];

// PlayerNotificationDelegate 回调 — 播放完成后自动播放下一个
- (void)playerDidCompletion {
    [self playNextVideo];
}

策略详解

DefaultLifecycleStrategy

最简单的策略，等价于未引入生命周期策略前的原始行为。

@interface DefaultLifecycleStrategy : BaseLifecycleStrategy <PlayerLifecycleStrategy>
@end

特点：

• 无状态，每次 acquirePlayer 通过工厂创建新实例。

• 每次 recyclePlayer:force: 直接销毁实例，无论 force 值。

• 内存占用最低（用完即释放）。

• 适合大多数标准播放场景。

核心流程：

ReusePoolLifecycleStrategy

基于对象池模式，维护空闲池和活跃列表。

@interface ReusePoolLifecycleStrategy : BaseLifecycleStrategy <PlayerLifecycleStrategy>

/// 池的最大容量，默认为 3。超出此容量时 recycle 将直接销毁。
@property (nonatomic, assign) NSInteger maxPoolSize;

/// 当前池中空闲播放器数量
@property (nonatomic, assign, readonly) NSInteger idleCount;

/// 当前已 acquire 但未 recycle 的活跃播放器数量
@property (nonatomic, assign, readonly) NSInteger activeCount;

- (instancetype)initWithMaxPoolSize:(NSInteger)maxPoolSize NS_DESIGNATED_INITIALIZER;

@end

特点：

• 空闲池优先复用，减少播放器初始化开销。

• 支持 preloadWithCount: 预填充池。

• 池容量通过 maxPoolSize 控制。

• 所有方法线程安全。

• 适合短视频列表、信息流场景。

核心流程：

IdScopedPoolLifecycleStrategy

为每个 uniqueId 维护独立的播放器实例。相同 uniqueId 始终返回同一实例。使用 LRU（最近最少使用） 机制控制实例数量。

@interface IdScopedPoolLifecycleStrategy : BaseLifecycleStrategy <PlayerLifecycleStrategy>

/// 池的最大容量，默认为 3。超过时 LRU 自动淘汰最近最少使用的实例。
/// 修改此值时，如果新值小于当前实例数量，会立即按 LRU 顺序淘汰多余实例。
@property (nonatomic, assign) NSInteger maxPoolSize;

/// 当前映射表中的播放器实例数量（含活跃和空闲）
@property (nonatomic, assign, readonly) NSInteger poolCount;

- (instancetype)initWithMaxPoolSize:(NSInteger)maxPoolSize NS_DESIGNATED_INITIALIZER;

@end

特点：

• ID 绑定，相同 uniqueId 始终复用同一实例。

• LRU 淘汰机制，自动清理最近最少使用的实例。

• 支持 preloadWithCount: 预创建未绑定实例。

• 所有方法线程安全。

• 设计参考阿里云微短剧解决方案中的多实例播放器池 LRU 管理机制。

• 适合视频预加载、多视频切换场景。

核心流程：

SingletonLifecycleStrategy

全局维护唯一一个播放器实例。通过 dispatch_once 真单例模式实现。

@interface SingletonLifecycleStrategy : BaseLifecycleStrategy <PlayerLifecycleStrategy>

/// 获取全局共享的单例策略实例
+ (instancetype)sharedInstance;

- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new NS_UNAVAILABLE;

@end

特点：

• 全局唯一，所有使用此策略的控制器共享同一播放器实例。

• 内存占用最低。

• clear 为空操作（不销毁单例实例），需通过 recyclePlayer:force:YES 显式销毁。

• 不适合多视频同时播放场景。

• 多个 AliPlayerController 不可同时持有播放器，否则会导致状态冲突。

核心流程：

策略对比表

自定义开发

策略协议 (PlayerLifecycleStrategy)

所有生命周期策略都遵循 PlayerLifecycleStrategy 协议：

@protocol PlayerLifecycleStrategy <NSObject>

@required

/// 注入播放器工厂（由 AliPlayerController 自动调用）
- (void)setupWithFactory:(id<PlayerFactory>)factory;

/// 获取播放器实例（由策略决定创建或复用）
- (id<MediaPlayer>)acquirePlayer;

/// 回收播放器实例（force:YES 强制销毁，force:NO 由策略决定）
- (void)recyclePlayer:(nullable id<MediaPlayer>)player force:(BOOL)force;

/// 释放策略持有的所有播放器实例，恢复初始状态
- (void)clear;

@optional

/// 预加载指定数量的播放器实例到池中
- (void)preloadWithCount:(NSInteger)count;

/// 根据业务唯一标识获取播放器实例（仅 IdScopedPoolLifecycleStrategy 实现）
- (id<MediaPlayer>)acquirePlayerWithUniqueId:(NSString *)uniqueId;

/// 根据业务唯一标识回收播放器实例（仅 IdScopedPoolLifecycleStrategy 实现）
- (void)recyclePlayer:(nullable id<MediaPlayer>)player
             uniqueId:(NSString *)uniqueId
                force:(BOOL)force;

@end

策略基类（BaseLifecycleStrategy）

BaseLifecycleStrategy 是所有内置策略的共享基类，提供工厂管理和模板方法：

@interface BaseLifecycleStrategy : NSObject

/// 当前注入的播放器工厂（只读）
@property (nonatomic, strong, readonly) id<PlayerFactory> factory;

/// 注入播放器工厂（幂等，仅首次调用生效，重复调用打印警告并忽略）
- (void)setupWithFactory:(id<PlayerFactory>)factory;

/// 通过工厂创建新的播放器实例（子类应调用此方法而非直接调用 factory）
- (id<MediaPlayer>)createPlayer;

/// 通过工厂销毁播放器实例（子类应调用此方法而非直接调用 factory）
- (void)destroyPlayer:(nullable id<MediaPlayer>)player;

@end

播放器工厂（PlayerFactory）

PlayerFactory 协议定义了播放器实例的创建与销毁接口：

@protocol PlayerFactory <NSObject>

/// 创建播放器实例（每次调用创建新实例，处于 PlayerStateIdle 状态）
- (id<MediaPlayer>)createPlayer;

/// 销毁播放器实例（释放所有资源，nil 时仅记录警告日志）
- (void)destroyPlayer:(nullable id<MediaPlayer>)player;

@end

框架内置 DefaultPlayerFactory，使用阿里云播放器 SDK（AliPlayer）创建标准实例。可通过 [AliPlayerKit setPlayerFactory:] 替换为自定义工厂。

自定义策略示例

以下示例展示了一个基于 ID 映射的简单缓存策略：

@interface MyCacheLifecycleStrategy : BaseLifecycleStrategy <PlayerLifecycleStrategy>
@end

@implementation MyCacheLifecycleStrategy {
    NSMutableDictionary<NSString *, id<MediaPlayer>> *_playerMap;
}

- (instancetype)init {
    self = [super init];
    if (self) {
        _playerMap = [NSMutableDictionary dictionary];
    }
    return self;
}

#pragma mark - PlayerLifecycleStrategy

- (id<MediaPlayer>)acquirePlayer {
    return [self createPlayer];
}

- (id<MediaPlayer>)acquirePlayerWithUniqueId:(NSString *)uniqueId {
    id<MediaPlayer> player = _playerMap[uniqueId];
    if (!player) {
        player = [self createPlayer];
        _playerMap[uniqueId] = player;
    }
    return player;
}

- (void)recyclePlayer:(id<MediaPlayer>)player
             uniqueId:(NSString *)uniqueId
                force:(BOOL)force {
    if (!player) return;
    if (force) {
        [_playerMap removeObjectForKey:uniqueId];
        [self destroyPlayer:player];
    } else {
        [player stop];
    }
}

- (void)recyclePlayer:(id<MediaPlayer>)player force:(BOOL)force {
    if (!player) return;
    [self destroyPlayer:player];
}

- (void)clear {
    for (id<MediaPlayer> player in _playerMap.allValues) {
        [self destroyPlayer:player];
    }
    [_playerMap removeAllObjects];
}

@end

注册并使用：

MyCacheLifecycleStrategy *strategy = [[MyCacheLifecycleStrategy alloc] init];

AliPlayerController *controller =
    [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];
// controller 自动调用 [strategy setupWithFactory:...] 注入工厂

生命周期流程

控制器与策略的交互流程

AliPlayerController 初始化
    ↓
initWithLifecycleStrategy: → 保存策略引用
    ↓                       → 自动调用 [strategy setupWithFactory:[AliPlayerKit playerFactory]]
    ↓
[controller configure:model]
    ↓
    ├── 已有播放器? → [strategy recyclePlayer:旧实例 force:NO]
    ↓
    ├── strategy 实现了 acquirePlayerWithUniqueId:?
    │   ├── YES → [strategy acquirePlayerWithUniqueId:source.uniqueId]
    │   └── NO  → [strategy acquirePlayer]
    ↓
    ├── [player setDataSource:model]
    ├── [player prepare]
    └── autoPlay ? → [player start]
    ↓
切换视频源 → [controller configure:newModel]
    ↓         → recycle(旧) + acquire(新) + setDataSource + prepare
    ↓
[controller destroy]
    ↓
    ├── [strategy recyclePlayer:player force:YES]
    └── 控制器释放

策略资源清理时机

最佳实践

策略选择指南

内存管理建议

// 监听内存警告，释放池资源
[[NSNotificationCenter defaultCenter]
    addObserver:self
       selector:@selector(handleMemoryWarning:)
           name:UIApplicationDidReceiveMemoryWarningNotification
         object:nil];

- (void)handleMemoryWarning:(NSNotification *)notification {
    [self.lifecycleStrategy clear];
}

页面生命周期管理

@interface MyViewController ()
@property (nonatomic, strong) AliPlayerView *playerView;
@property (nonatomic, strong) AliPlayerController *controller;
@property (nonatomic, strong) id<PlayerLifecycleStrategy> lifecycleStrategy;
@end

@implementation MyViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    self.lifecycleStrategy = [[ReusePoolLifecycleStrategy alloc] initWithMaxPoolSize:3];
    self.controller = [[AliPlayerController alloc]
        initWithLifecycleStrategy:self.lifecycleStrategy];
    // ... configure + attach
}

- (void)dealloc {
    // 必须：销毁控制器
    if (_controller) {
        [_controller destroy];
    }
    // 可选：如果此页面是策略的最后使用者，释放池资源
    if (_lifecycleStrategy) {
        [_lifecycleStrategy clear];
    }
}

@end

注意事项

常见错误

// ✗ 错误：忘记在 dealloc 中销毁控制器
- (void)dealloc {
    [self.playerView detach];
    // 未调用 [_controller destroy]，导致内存泄漏
}

// ✓ 正确：销毁控制器并按需清理策略
- (void)dealloc {
    if (_controller) {
        [_controller destroy];
    }
    if (_lifecycleStrategy) {
        [_lifecycleStrategy clear];
    }
}

// ✗ 错误：单例策略下同时持有多个 Controller
SingletonLifecycleStrategy *strategy = [SingletonLifecycleStrategy sharedInstance];
AliPlayerController *controller1 = [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];
AliPlayerController *controller2 = [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];
// controller1 和 controller2 共享同一播放器实例，导致状态冲突

// ✓ 正确：确保同一时间只有一个 Controller 使用单例策略
[controller1 destroy];
AliPlayerController *controller2 = [[AliPlayerController alloc] initWithLifecycleStrategy:strategy];

// ✗ 错误：尝试 alloc init SingletonLifecycleStrategy
SingletonLifecycleStrategy *strategy = [[SingletonLifecycleStrategy alloc] init]; // 编译错误

// ✓ 正确：通过 sharedInstance 获取
SingletonLifecycleStrategy *strategy = [SingletonLifecycleStrategy sharedInstance];

API 速查

核心类与协议

内置策略

PlayerLifecycleStrategy方法

BaseLifecycleStrategy方法

force参数说明

uniqueId说明

uniqueId 是 VideoSource 上的业务唯一标识属性，用于区分不同视频源。不同策略对其使用方式不同：

示例参考

PlayerKitUsages/UsageLifecycleStrategy 模块提供了完整的播放器生命周期策略使用示例，演示了四种内置策略（Default、ReusePool、Singleton、IdScopedPool）的切换对比、多视频源播放下的实例复用行为（NEW/REUSED/HIT），以及策略与控制器的资源清理流程。