萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 與 Flash (SWF) 雙向通訊完整指南:跨瀏覽器相容、ExternalInterface 最佳實踐

雖 Flash 已退役,但維護舊系統時仍需處理 JS↔SWF 通訊。本文系統整理 ExternalInterface 雙向調用、跨瀏覽器(IE/FF/Chrome)物件獲取差異、allowScriptAccess 設定、常見坑點與現代替代方案。

核心架構

┌─────────────┐     ExternalInterface.call      ┌─────────────┐
│  JavaScript │ ──────────────────────────────→ │  Flash (SWF) │
│  (Container)│                                   │  (ActionScript)│
└─────────────┘ ←────────────────────────────── ┌─────────────┘
         ↑                              ExternalInterface.addCallback
         │                              (註冊 JS 可呼叫的 AS 函數)
         │
    JS 呼叫 SWF 註冊函數

ActionScript 3 端實現

import flash.external.ExternalInterface;
import flash.events.SecurityErrorEvent;

// 1. 允許 JS 存取(必須最早呼叫)
if (ExternalInterface.available) {
  try {
    // 註冊供 JS 呼叫的函數
    ExternalInterface.addCallback('setImagePath', receiveImagePath);
    ExternalInterface.addCallback('getFlashData', getFlashData);
  } catch (e) {
    trace('ExternalInterface 註冊失敗:', e);
  }
}

// 2. 接收 JS 傳來的圖片路徑
function receiveImagePath(path:String):void {
  trace('JS 傳入路徑:', path);
  // 更新 UI、載入圖片等
  imageLoader.source = path;
}

// 3. 提供資料給 JS
function getFlashData():Object {
  return { version: '1.0', status: 'ready', items: ['a','b','c'] };
}

// 4. 主動呼叫 JS 函數
function notifyJS(eventName:String, data:Object):void {
  if (ExternalInterface.available) {
    ExternalInterface.call('onFlashEvent', eventName, data);
  }
}

HTML 嵌入 SWF:跨瀏覽器相容寫法

關鍵點:IE 使用 <object classid="clsid:...">,非 IE 使用 <object type="application/x-shockwave-flash">,**兩者都必須包含 <embed> 並設定相同 id/name**,否則 FF/Chrome 無法透過 document.getElementById 獲取可呼叫介面。

<div id="flashContainer">
  <object 
    classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
    width="515" height="320" 
    id="myFlash" name="myFlash" > <!-- id/name 必須一致 -->
    <param name="movie" value="app.swf" />
    <param name="quality" value="high" />
    <param name="wmode" value="transparent" />
    <param name="allowScriptAccess" value="always" /> <!-- 關鍵:允許腳本存取 -->
    <!--[if !IE]><!-->
    <object 
      type="application/x-shockwave-flash" 
      data="app.swf" 
      width="515" height="320">
      <param name="movie" value="app.swf" />
      <param name="quality" value="high" />
      <param name="wmode" value="transparent" />
      <param name="allowScriptAccess" value="always" />
      <embed 
        src="app.swf" 
        name="myFlash" 
        width="515" height="320"
        allowScriptAccess="always"
        swLiveConnect="true"
        type="application/x-shockwave-flash" />
    <!--<![endif]-->
  </object>
</div>

JavaScript 端:安全獲取 SWF 物件與呼叫

/**
 * 跨瀏覽器獲取 SWF 物件參考
 * @param {string} id - object/embed 的 id/name
 * @returns {HTMLElement|null}
 */
function getFlashMovie(id) {
  // 現代瀏覽器:object 元素即可
  var obj = document.getElementById(id);
  if (obj && typeof obj.SetVariable === 'function') return obj; // 已可用

  // 舊版 FF/Chrome:需 embed 元素
  var embed = document.getElementsByName(id)[0];
  if (embed && typeof embed.SetVariable === 'function') return embed;

  // IE: object 已可用
  return obj;
}

/**
 * 安全呼叫 SWF 方法(含重試機制)
 */
function callFlashMethod(methodName, args, retries = 10, interval = 100) {
  return new Promise((resolve, reject) => {
    function attempt(remaining) {
      var flash = getFlashMovie('myFlash');
      if (flash && typeof flash[methodName] === 'function') {
        try {
          var result = flash[methodName].apply(flash, args);
          resolve(result);
        } catch (e) {
          reject(e);
        }
        return;
      }
      if (remaining <= 0) {
        reject(new Error('Flash 介面未就緒: ' + methodName));
        return;
      }
      setTimeout(() => attempt(remaining - 1), interval);
    }
    attempt(retries);
  });
}

// 使用範例
$('#callFlashBtn').click(async () => {
  try {
    var result = await callFlashMethod('getFlashData', []);
    console.log('Flash 回傳:', result);
  } catch (e) {
    alert('Flash 通訊失敗: ' + e.message);
  }
});

// 接收 Flash 主動呼叫
window.onFlashEvent = function(eventName, data) {
  console.log('Flash 事件:', eventName, data);
  // 觸發自定義事件供應用層監聽
  document.dispatchEvent(new CustomEvent('flashEvent', { detail: { eventName, data } }));
};

常見坑點與解決

| 現象 | 原因 | 解決 | |------|------|------| | FF/Chrome flash.method is not a function | 只用 getElementById 獲取 <object>,非 IE 需 <embed> | 同時設定 object.id、embed.name、embed.id 相同,用 getElementsByName 兜底 | | SecurityError: ExternalInterface call | allowScriptAccess 非 always、或跨域無 crossdomain.xml | 設 allowScriptAccess="always"、部署 crossdomain.xml 允許來源域 | | SWF 載入慢導致呼叫失敗 | JS 執行時 SWF 尚未初始化完成 | 採用上方 callFlashMethod 重試機制,或監聽 FlashReady 事件 | | 頁面卸載報錯 | SWF 內部定時器未清理 | AS3 端 Event.REMOVED_FROM_STAGE 清理資源 |

現代替代方案

  • WebAssembly:高效能運算、圖像處理,取代 Flash 計算密集型任務。
  • Canvas/WebGL + JS:動畫、遊戲、圖表渲染,原生效能超越 Flash。
  • WebRTC / MediaRecorder:音視頻錄製、串流,替代 Flash 媒體功能。
  • Ruffle:Rust 寫的 Flash Player 模擬器,可直接在瀏覽器運行舊 SWF,無需外掛。

若必須維護舊 Flash 整合,遵循上述跨瀏覽器嵌入標準、重試機制與安全設定,能最大程度降低兼容性事故。

copyright © 萬盛學電腦網 all rights reserved