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

什麼是播放器生命週期策略？

播放器生命週期策略 (Player Lifecycle Strategy) 是用於管理播放器執行個體生命週期的架構機制。它定義了播放器執行個體的擷取（acquire）、回收（recycle）、清理（clear）等核心操作，將播放器資源管理從業務代碼中解耦出來。

不同的業務情境對播放器執行個體的管理有不同的需求：

策略模式的優勢

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

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

• 靈活：運行時動態切換策略，無需修改業務代碼。

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

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

解決問題

1. 管理分散：播放器執行個體缺乏統一管控機制。

2. 效能損耗：頻繁建立/銷毀播放器導致資源浪費。

3. 複用障礙：跨情境無法複用播放器執行個體。

4. 記憶體失控：記憶體佔用缺乏有效管控。

核心價值

架構優勢：

• 策略解耦：播放器資源管理與商務邏輯分離，職責清晰。

• 運行時切換：無需重啟即可切換策略實現。

• 安全執行緒：所有策略實現都支援多安全執行緒訪問。

• 事件驅動：通過事件匯流排發布生命週期事件，便於監控。

核心能力

策略類型

AliPlayerKit 提供 4 種內建的播放器生命週期策略：

策略詳解

DefaultLifecycleStrategy（預設策略）

最簡單的策略，每次調用 acquire() 建立新執行個體，每次 recycle() 立即銷毀。

特點：

• 無狀態，每次都是全新執行個體。

• 無複用，適合簡單情境。

• 記憶體佔用最低（用完即釋放）。

ReusePoolLifecycleStrategy（複用池策略）

基於對象池模式，維護空閑池和活躍列表。使用 LIFO（後進先出）策略複用執行個體。

特點：

• 空閑池 LIFO 策略，最近使用的執行個體優先複用。

• 支援預先載入，提前建立執行個體。

• 池容量可配置，超出時銷毀。

• 適合短視頻列表、資訊流情境。

IdScopedPoolLifecycleStrategy（ID 範圍策略）

為每個 uniqueId 維護獨立的播放器執行個體。相同 uniqueId 始終返回同一執行個體。使用 LRU（最近最少使用）機制控制執行個體數量。

特點：

• ID 綁定，相同 ID 始終複用同一執行個體。

• LRU 淘汰機制，自動清理最近最少使用的執行個體。

• 支援預先載入，提前建立未綁定執行個體。

• 適合視頻預先載入、多視頻切換情境。

SingletonLifecycleStrategy（單例策略）

全域維護唯一一個播放器執行個體。無論 uniqueId 為何值，始終返回同一執行個體。

特點：

• 全域唯一，所有位置共用同一執行個體。

• 記憶體佔用最低。

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

生命週期事件

策略執行過程中會發布生命週期事件，可通過事件匯流排監聽：

使用預設策略

最簡單的使用方式，無需額外配置：

// 建立控制器（自動使用 DefaultLifecycleStrategy）
AliPlayerController controller = new AliPlayerController(context);

// 綁定播放
AliPlayerModel model = new AliPlayerModel.Builder()
        .videoSource(videoSource)
        .build();
controller.configure(model);
playerView.attach(controller);      

使用複用池策略

適合短視頻列表、資訊流情境：

// 擷取複用池策略單例
ReusePoolLifecycleStrategy strategy = ReusePoolLifecycleStrategy.getInstance();

// 設定池容量（可選，預設為 3）
strategy.setMaxPoolSize(3);

// 建立控制器時注入策略
AliPlayerController controller = new AliPlayerController(context, strategy);

// 使用完畢後清理資源
strategy.clear(); 

使用 ID 範圍策略

適合需要預先載入和多視頻切換的情境：

// 擷取 ID 範圍策略單例
IdScopedPoolLifecycleStrategy strategy = IdScopedPoolLifecycleStrategy.getInstance();

// 設定池容量
strategy.setMaxPoolSize(3);

// 預先載入播放器執行個體（可選）
strategy.preload(context, 2);

// 建立控制器時注入策略
AliPlayerController controller = new AliPlayerController(context, strategy);

// 使用完畢後清理資源
strategy.clear(); 

使用單例策略

適合記憶體敏感情境：

// 擷取單例策略執行個體
SingletonLifecycleStrategy strategy = SingletonLifecycleStrategy.getInstance();

// 預先載入（可選，只建立一個執行個體）
strategy.preload(context, 1);

// 建立控制器時注入策略
AliPlayerController controller = new AliPlayerController(context, strategy);

如何監聽生命週期事件？

通過事件匯流排監聽策略內部的生命週期事件，用於調試和監控：

PlayerEventBus eventBus = PlayerEventBus.getInstance();

// 監聽播放器建立
eventBus.subscribe(PlayerLifecycleEvents.PlayerCreated.class, event -> {
    Log.d("Player", "Created: " + event.playerId);
});

// 監聽播放器複用
eventBus.subscribe(PlayerLifecycleEvents.PlayerReused.class, event -> {
    Log.d("Player", "Reused: " + event.playerId);
});

// 監聽播放器淘汰
eventBus.subscribe(PlayerLifecycleEvents.PlayerEvicted.class, event -> {
    Log.d("Player", "Evicted: " + event.playerId);
});

// 監聽播放器銷毀
eventBus.subscribe(PlayerLifecycleEvents.PlayerDestroyed.class, event -> {
    Log.d("Player", "Destroyed: " + event.playerId);
});

// 不再需要時取消訂閱
eventBus.unsubscribe(PlayerLifecycleEvents.PlayerCreated.class, listener);

如何動態切換策略？

運行時可以根據業務需求動態切換策略：

private IPlayerLifecycleStrategy mCurrentStrategy;

private void switchToReusePool() {
    // 1. 清理舊資源
    if (mCurrentStrategy != null) {
        mCurrentStrategy.clear();
    }

    // 2. 切換到複用池策略（setMaxPoolSize 是 ReusePoolLifecycleStrategy 的具體方法，
    //    不在 IPlayerLifecycleStrategy 介面上，需用具體類型的變數調用）
    ReusePoolLifecycleStrategy reusePoolStrategy = ReusePoolLifecycleStrategy.getInstance();
    reusePoolStrategy.setMaxPoolSize(3);
    mCurrentStrategy = reusePoolStrategy;

    // 3. 預先載入
    mCurrentStrategy.preload(this, 2);
}

private void switchToSingleton() {
    // 1. 清理舊資源
    if (mCurrentStrategy != null) {
        mCurrentStrategy.clear();
    }

    // 2. 切換到單例策略
    mCurrentStrategy = SingletonLifecycleStrategy.getInstance();
}

如何預先載入播放器執行個體？

預先載入可以提前建立播放器執行個體，減少首幀耗時：

// 複用池策略：預先載入執行個體放入空閑池
ReusePoolLifecycleStrategy strategy = ReusePoolLifecycleStrategy.getInstance();
strategy.preload(context, 2);  // 預建立 2 個執行個體

// ID 範圍策略：預先載入未綁定執行個體
IdScopedPoolLifecycleStrategy strategy = IdScopedPoolLifecycleStrategy.getInstance();
strategy.preload(context, 2);  // 預建立 2 個未綁定執行個體

// 單例策略：預先載入全域執行個體
SingletonLifecycleStrategy strategy = SingletonLifecycleStrategy.getInstance();
strategy.preload(context, 1);  // 建立全域執行個體（count 參數被忽略）

如何?自訂策略？

通過繼承 BaseLifecycleStrategy 實現自訂策略：

public class MyCustomStrategy extends BaseLifecycleStrategy {

    private final Map<String, IMediaPlayer> playerMap = new HashMap<>();

    @NonNull@Overridepublic IMediaPlayer acquire(@NonNull Context context, @NonNull String uniqueId) {
        // 自訂擷取邏輯
        IMediaPlayer player = playerMap.get(uniqueId);
        if (player != null) {
            // 命中已有執行個體
            PlayerEventBus.getInstance().post(
                new PlayerLifecycleEvents.PlayerHit(player.getPlayerId()));
            return player;
        }

        // 建立新執行個體
        player = createPlayer(context);
        playerMap.put(uniqueId, player);
        return player;
    }

    @Overridepublic void recycle(@Nullable IMediaPlayer player, @NonNull String uniqueId, boolean force) {
        if (player == null) return;

        if (force) {
            // 強制銷毀
            playerMap.remove(uniqueId);
            destroyPlayer(player);
        } else {
            // 僅停止，保留執行個體
            player.stop();
        }
    }

    @Overridepublic void clear() {
        // 清理所有執行個體for (IMediaPlayer player : playerMap.values()) {
            destroyPlayer(player);
        }
        playerMap.clear();
    }
}

策略選擇指南

記憶體最佳化建議

每個播放器執行個體約佔用 35~40MB 記憶體（基於阿里雲微短劇多執行個體播放器池的記憶體 Profiling 結果），建議根據裝置效能調整池容量：

// 根據裝置記憶體動態調整
ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
boolean isLowMemory = am.isLowRamDevice();

if (isLowMemory) {
    // 低記憶體裝置使用單例策略
    strategy = SingletonLifecycleStrategy.getInstance();
} else {
    // 普通裝置使用複用池策略
    strategy = ReusePoolLifecycleStrategy.getInstance();
    strategy.setMaxPoolSize(isHighEndDevice ? 3 : 2);
}

注意事項

樣本功能

運行樣本

在 Demo App 中選擇 Lifecycle Strategy 樣本查看效果。

核心介面

IPlayerLifecycleStrategy方法

BaseLifecycleStrategy方法

安全執行緒機制

池化策略對比

架構底層邏輯解析：

• ReusePool 為什麼要用 LIFO（後進先出）？

  在 Feed 流上下滑動頻繁的情境下，剛進入空閑池的播放器執行個體，其底層解碼器上下文與硬體資源通常是最“熱”的（緩衝尚未被系統換頁剝奪）。優先被喚醒，能夠明顯減少系統底層的上下文重設耗時，提升起播速度（基於空間局部性原理）。

• IdScopedPool 為什麼要用 LRU（最近最少使用淘汰）？

  多執行個體池化存在“時間局部性”法則：隨著使用者瀏覽流推進，越久之前的視頻立刻遭遇回放的機率越低。LRU 淘汰順應了使用者歷史瀏覽軌跡的衰減規律，做到在完全綁定 ID 的前提下，仍能有效控制應用的記憶體峰值。

如何選擇合適的策略？

根據業務情境選擇：

• 簡單播放情境：使用 Default 策略，無額外複雜度。

• 短視頻/資訊流：使用 ReusePool 策略，快速切換。

• 視頻預先載入：使用 IdScopedPool 策略，ID 綁定。

• 記憶體敏感：使用 Singleton 策略，最小佔用。

池容量設定多少合適？

建議根據裝置效能和業務需求調整：

• 每個播放器執行個體約佔用 35~40MB記憶體。

• 預設池容量為 3，約佔用 100~120MB。

• 低端裝置建議設為 2 或使用 Singleton。

預先載入何時使用？

預先載入適用於需要減少首幀耗時的情境：

• 短視頻列表：預先載入 1~2 個執行個體。

• 視頻詳情頁：預先載入下一個推薦視頻。

• 避免過多預先載入：會增加記憶體佔用。

高頻崩潰錯例

以下是客戶回函中最常導致問題的情況，請務必避免：

@Overrideprotected void onDestroy() {
    super.onDestroy();
    // 只解除綁定了 View，忘記清理策略持有的執行個體
    mPlayerView.detach();
}

@Overrideprotected void onDestroy() {
    super.onDestroy();
    // 解除綁定 View
    mPlayerView.detach();
    // 清理策略資源
    if (mStrategy != null) {
        mStrategy.clear();
    }
}

@Overrideprotected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 訂閱了事件但從未取消
    PlayerEventBus.getInstance().subscribe(
        PlayerLifecycleEvents.PlayerCreated.class,
        event -> updateUI()
    );
}

private PlayerEventBus.EventListener<PlayerLifecycleEvents.PlayerCreated> mListener;

@Overrideprotected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    mListener = event -> updateUI();
    PlayerEventBus.getInstance().subscribe(
        PlayerLifecycleEvents.PlayerCreated.class, mListener);
}

@Overrideprotected void onDestroy() {
    super.onDestroy();
    // 取消訂閱if (mListener != null) {
        PlayerEventBus.getInstance().unsubscribe(
            PlayerLifecycleEvents.PlayerCreated.class, mListener);
    }
}

// 回收播放器
strategy.recycle(player, "video_1", false);

// 回收後繼續使用
player.start();  // 可能導致異常

// 回收播放器
strategy.recycle(player, "video_1", false);
player = null;  // 清Null 參考，避免誤用// 需要再次使用時，重新擷取
player = strategy.acquire(context, "video_1");

如何調試？

1. 查看日誌：使用 tag:AliPlayerKit 過濾 Logcat。

2. 監聽生命週期事件：通過事件匯流排觀察建立、複用、淘汰等動作。

3. 檢查池狀態：通過日誌查看當前池大小和活躍執行個體數。

4. 記憶體分析：使用 Android Profiler 檢查播放器執行個體數量和記憶體佔用。