ApsaraVideo VOD：播放器生命週期策略

概念介紹

核心價值

通過策略模式管理播放器生命週期，帶來以下核心優勢：

• 解耦：業務代碼無需關心播放器執行個體的建立和銷毀細節。

• 靈活：運行時選擇不同策略，無需修改業務代碼。

• 可擴充：可實現自訂策略，滿足特定業務需求。

• 可觀測：統一的生命週期管理，便於監控和調試。

設計背景

播放器生命週期策略源於阿里雲微短劇解決方案中的多執行個體播放器池，旨在應對資訊流快速滑動情境下對首幀速度、切換流暢度及記憶體控制的嚴苛要求。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 會銷毀當前單例播放器執行個體共置空，之後再次 acquirePlayer 會重新建立

• 不適合多視頻同時播放情境。

• 多個 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），以及策略與控制器的資源清理流程。