PHP 獲取 SWF 動畫截圖：COM 元件實作範例

前言

在早期 Web 開發中，若需從 SWF (Flash) 動畫擷取靜態畫面作為縮圖或預覽，常見做法是在 Windows 伺服器上安裝 Flash Player 並搭配 COM 元件 SunCN.Flash2Jpeg 執行轉換。本文記錄該技術的實作步驟與代碼範例，供維護舊系統的開發者參考。

環境準備

1. 作業系統：Windows Server（需支援 COM 元件）
2. 安裝 Flash Player ActiveX 版本
3. 註冊 Flash2Jpeg.dll（通常隨附於相關工具包，需以管理員權限執行 regsvr32 Flash2Jpeg.dll）
4. PHP 啟用 com_dotnet 擴充（php.ini 中 extension=com_dotnet）

核心代碼

<?php
$oldswf = "/uploads/swf/test.swf";   // 來源 SWF 路徑
$oldjpg = "/uploads/litpic/test.jpg"; // 輸出 JPG 路徑

$flash2jpeg = new COM("SunCN.Flash2Jpeg");

if ($flash2jpeg) {
    // 參數：來源檔、寬、高、輸出檔
    $a = $flash2jpeg->Flash2Jpeg($oldswf, 150, 200, $oldjpg);

    if ($a) {
        // 轉換成功，使用預設圖片或進一步處理
        $litpic = '/images/defaultpic.gif';
    } else {
        // 轉換失敗，回傳原輸出路徑（可能為空檔）
        $litpic = $oldjpg;
    }
} else {
    // COM 元件建立失敗
    $litpic = '/images/defaultpic.gif';
}

// $litpic 可供後續邏輯使用（如寫入資料庫、輸出前端）
?>

參數說明

• Flash2Jpeg(source, width, height, dest)
  • source：SWF 檔案完整路徑（伺服器端絕對路徑）
  • width：輸出圖片寬度（像素）
  • height：輸出圖片高度（像素）
  • dest：輸出 JPEG 檔案完整路徑
• 回傳值：成功通常回傳非零/true，失敗回傳 0/false

常見問題與替代方案

1. 權限問題

執行身分（IIS_IUSRS 或 Apache 執行使用者）必須對 SWF 來源目錄與輸出目錄具備讀寫權限。

2. 相依性風險

此方案強依賴 Windows、Flash Player 及第三方 COM 元件，已不符合現代跨平台部署需求。Adobe 於 2020 年底停止支援 Flash Player，生產環境建議改用以下替代方案：

• Ruffle + Canvas 擷取：Ruffle 是 Rust 寫成的 Flash 模擬器，可在瀏覽器端播放 SWF，再透過 canvas.toDataURL() 取得截圖。
• Node.js + Puppeteer：在無頭瀏覽器載入 SWF（需 Ruffle polyfill）並截圖。
• ffmpeg：若 SWF 實為影片容器，可嘗試 ffmpeg -i input.swf -vframes 1 output.jpg。

3. 錯誤處理建議

<?php
try {
    $flash2jpeg = new COM("SunCN.Flash2Jpeg");
    if (!$flash2jpeg) throw new Exception("COM 元件初始化失敗");

    $result = $flash2jpeg->Flash2Jpeg($oldswf, 150, 200, $oldjpg);
    if (!$result) throw new Exception("轉換過程發生錯誤");

    // 成功邏輯
} catch (com_exception $e) {
    error_log("Flash2Jpeg COM 錯誤: " . $e->getMessage());
    // 降級處理
} catch (Exception $e) {
    error_log("Flash2Jpeg 一般錯誤: " . $e->getMessage());
}
?>

總結

雖然 SunCN.Flash2Jpeg 在 Flash 全盛期提供了便利的伺服器端截圖功能，但隨著技術棧演進，該方案已逐漸淘汰。新專案請優先考慮現代化、跨平台的替代方案；僅在必須維護舊系統時，才使用本文所述方法，並做好錯誤處理與日誌記錄。