萬盛學電腦網

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

JavaScript 與 Flex (ActionScript) 雙向通訊完整實作指南

架構概覽

JS ↔ Flex 通訊透過 **ExternalInterface** API 實現雙向呼叫。核心流程:

  1. Flex 向 JS 公開方法:ExternalInterface.addCallback("js呼叫名", flex函式)
  2. JS 呼叫 Flex 方法:swfObject.公開方法名(參數...)
  3. Flex 呼叫 JS 方法:ExternalInterface.call("js函式名", 參數...)
  4. JS 回呼 Flex:Flex 註冊回呼函式,JS 執行後呼叫

一、Flex 端實作 (ActionScript 3)

1. 公開方法供 JS 呼叫

package com.example {
  import flash.display.Sprite;
  import flash.external.ExternalInterface;
  import flash.events.Event;
  
  public class Main extends Sprite {
    public function Main() {
      super();
      // 等待舞台就緒
      if (stage) init();
      else addEventListener(Event.ADDED_TO_STAGE, init);
    }
    
    private function init(e:Event = null):void {
      removeEventListener(Event.ADDED_TO_STAGE, init);
      
      // 1. 註冊供 JS 呼叫的方法
      if (ExternalInterface.available) {
        ExternalInterface.addCallback("showParams", showParams);
        ExternalInterface.addCallback("getData", getData);
        ExternalInterface.addCallback("setConfig", setConfig);
        
        // 2. 通知 JS:Flex 已準備就緒 (關鍵!避免 JS 過早呼叫)
        ExternalInterface.call("onFlexReady");
      }
    }
    
    // JS 可呼叫:顯示參數
    public function showParams(start:String, end:String):void {
      trace("JS 呼叫 showParams:", start, end);
      // UI 更新邏輯...
      // 可回呼 JS
      ExternalInterface.call("onFlexShowParamsResult", "處理完成: " + start + " ~ " + end);
    }
    
    // JS 可呼叫:取得資料
    public function getData():Object {
      return { status: "ok", timestamp: new Date().time };
    }
    
    // JS 可呼叫:設定配置
    public function setConfig(config:Object):void {
      trace("收到配置:", config);
    }
  }
}

2. Flex 主動呼叫 JS


// 簡單呼叫
ExternalInterface.call("jsFunctionName", "參數1", 123, true, {key: "value"});

// 帶回呼 (非同步模式)
ExternalInterface.call("jsAsyncFunction", "param", function(result) {
  trace("JS 回呼結果:", result);
});

二、HTML/JS 端實作

1. SWF 嵌入與取得參考

<!-- 建議使用 SWFObject 2.2+ 嵌入 -->
<div id="flashContent">
  <p>需要 Flash Player</p>
</div>

<script src="https://ajax.googleapis.com/ajax/libs/swfobject/2.2/swfobject.js"></script>
<script>
var flashVars = {};
var params = { 
  allowScriptAccess: "always",  // 關鍵:允許腳本存取
  wmode: "transparent" 
};
var attributes = { id: "flexApp", name: "flexApp" };

swfobject.embedSWF(
  "Main.swf",      // swf 檔案
  "flashContent",  // 容器 ID
  "100%", "100%",  // 寬高
  "11.1.0",        // 最低版本
  "expressInstall.swf",
  flashVars, params, attributes,
  function(e) {
    if (e.success) {
      window.flexApp = e.ref; // 取得 SWF 參考
    } else {
      console.error("SWF 載入失敗");
    }
  }
);
</script>

2. 等待 Flex 就緒後再操作

// 全域旗標
window.flexReady = false;
window.flexApp = null;

// Flex 端呼叫此函式通知就緒
window.onFlexReady = function() {
  window.flexReady = true;
  console.log("Flex 已就緒,可安全呼叫方法");
  
  // 執行等待隊列
  while (window.flexQueue && window.flexQueue.length) {
    var fn = window.flexQueue.shift();
    fn();
  }
};

// 安全呼叫包裝器
function callFlex(method, args, callback) {
  var execute = function() {
    try {
      if (!window.flexApp || !window.flexApp[method]) {
        throw new Error("Flex 方法不存在: " + method);
      }
      var result = window.flexApp[method].apply(window.flexApp, args);
      if (callback) callback(null, result);
    } catch (e) {
      if (callback) callback(e);
    }
  };
  
  if (window.flexReady) {
    execute();
  } else {
    // 加入等待隊列
    window.flexQueue = window.flexQueue || [];
    window.flexQueue.push(execute);
  }
}

// 使用範例
callFlex("showParams", ["2024-01-01", "2024-12-31"], function(err, result) {
  if (err) console.error(err);
  else console.log("Flex 回傳:", result);
});

3. 定義供 Flex 呼叫的 JS 函式

// 1. 簡單回呼
window.onFlexShowParamsResult = function(message) {
  console.log("Flex 回呼:", message);
  $("#status").text(message);
};

// 2. 非同步操作回呼
window.jsAsyncFunction = function(param, callback) {
  // 模擬非同步操作 (AJAX、IndexedDB 等)
  $.ajax({
    url: "/api/data",
    data: { input: param }
  }).done(function(data) {
    callback(data); // 呼叫 Flex 端的回呼函式
  }).fail(function() {
    callback({ error: "請求失敗" });
  });
};

// 3. 複雜資料交換
window.receiveFlexData = function(data) {
  // data 為 Flex 傳來的 Object (自動序列化)
  console.log("收到 Flex 資料:", data);
  renderChart(data);
};

三、iframe 跨框架通訊場景

若 SWF 在 iframe 中 (如原文 `test.jsp` include `test.html`),需跨框架存取:

父頁面 (test.jsp)

<iframe id="flexFrame" src="test.html" style="width:100%;height:500px;"></iframe>

<script>
function callFlexInIframe(method, args, callback) {
  var iframe = document.getElementById("flexFrame");
  var flexWin = iframe.contentWindow;
  
  // 等待 iframe 載入完成
  if (!flexWin.flexReady) {
    iframe.onload = function() {
      callFlexInIframe(method, args, callback);
    };
    return;
  }
  
  try {
    var flexApp = flexWin.flexApp || flexWin.document.flexApp;
    var result = flexApp[method].apply(flexApp, args);
    if (callback) callback(null, result);
  } catch (e) {
    if (callback) callback(e);
  }
}

// 使用
callFlexInIframe("showParams", ["start", "end"], function(err, res) {
  console.log("iframe Flex 回傳:", res);
});

iframe 內頁面 (test.html) - 橋接父頁面

<script>
// 供 Flex 呼叫,轉發給父頁面
function initSWF() {
  // 通知父頁面 Flex 已就緒
  if (window.parent && window.parent.onFlexReadyInIframe) {
    window.parent.onFlexReadyInIframe(window);
  }
}

// Flex 端呼叫此函式
function onFlexShowParamsResult(message) {
  if (window.parent && window.parent.onFlexShowParamsResult) {
    window.parent.onFlexShowParamsResult(message);
  }
}
</script>

四、資料類型對應表

ActionScriptJavaScript說明
StringString直接對應
Number/int/uintNumber直接對應
BooleanBoolean直接對應
ArrayArray索引陣列自動轉換
Object / DictionaryObject鍵值對轉換,非字串鍵會轉字串
DateDate自動轉換為 JS Date 物件
XML / XMLListXMLDocument / String建議在 Flex 端轉為 Object/JSON 字串
ByteArray不可直接傳遞需 Base64 編碼字串傳輸
自訂類別Object註冊 [RemoteClass(alias="...")] 保留類型資訊

五、常見問題與除錯

1. "ExternalInterface not available" 錯誤

// 原因:本地檔案 (file://) 或安全沙箱限制
// 解決:
// - 透過 HTTP/HTTPS 伺服器存取 (localhost 即可)
// - 確保 allowScriptAccess="always"
// - Flash Player 設定面板加入信任位置

2. JS 呼叫 Flex 方法失敗 "Object doesn't support this property"

// 原因:Flex 尚未初始化完成,或方法名拼寫錯誤
// 解決:務必使用 onFlexReady 回呼機制,確認 flexApp 參考存在
if (window.flexApp && typeof window.flexApp.showParams === "function") {
  window.flexApp.showParams("a", "b");
}

3. 中文參數亂碼

// 確保 HTML 頁面編碼為 UTF-8
<meta charset="utf-8">

// Flex 編譯器參數
// -compiler.source-encoding=UTF-8

// JS 傳遞中文前編碼 (通常不需要,但可確保)
ExternalInterface.call("jsFunc", encodeURIComponent("中文參數"));
// Flex 端解碼
var decoded = decodeURIComponent(encodedStr);

4. 安全沙箱違規 (SecurityError)

// 跨域載入 SWF 時需 crossdomain.xml
// 放在 SWF 所在域名根目錄


  
  


// 或在 Flex 程式碼中
Security.allowDomain("*");
Security.allowInsecureDomain("*");

六、現代替代方案 (Flash 已終止支援)

⚠️ 重要:Adobe Flash Player 於 2020年12月31日 終止支援,所有主流瀏覽器已移除 Flash 支援。此技術**僅適用於維護舊系統**,新專案請勿使用。

遷移路徑

原 Flex 功能現代 Web 替代方案
複雜圖表/視覺化ECharts, Chart.js, D3.js, Highcharts, ApexCharts
影音播放/串流HTML5 <video>/<audio>, Video.js, HLS.js, Dash.js
Rich Text EditorQuill, TipTap, Slate, CKEditor 5, TinyMCE
檔案上傳/處理WebUploader, Uppy, FilePond, 原生 File API
即時通訊WebSocket, Socket.io, Server-Sent Events, WebRTC
3D/遊戲Three.js, Babylon.js, PlayCanvas, Unity WebGL
複雜表單/資料網格AG Grid, TanStack Table, Handsontable

JS ↔ WASM (WebAssembly) 替代 ExternalInterface

// Rust 編譯為 WASM,透過 wasm-bindgen 暴露函式
// lib.rs
#[wasm_bindgen]
pub fn show_params(start: &str, end: &str) -> String {
    format!("處理完成: {} ~ {}", start, end)
}

// JS 呼叫
import init, { show_params } from './pkg';
await init();
const result = show_params("2024-01-01", "2024-12-31");
console.log(result);

總結

JS-Flex 雙向通訊核心是 ExternalInterface.addCallback (JS→Flex) 與 ExternalInterface.call (Flex→JS),關鍵在於**同步初始化順序**:Flex 載入完成後通知 JS,JS 才能安全呼叫。iframe 嵌套時需透過 contentWindow 跨框架存取。但 Flash 已終止支援,**所有新專案應遷移至現代 Web 技術棧**,僅在維護無法重寫的舊系統時參考此文件。

copyright © 萬盛學電腦網 all rights reserved