JS ↔ Flex 通訊透過 **ExternalInterface** API 實現雙向呼叫。核心流程:
ExternalInterface.addCallback("js呼叫名", flex函式)swfObject.公開方法名(參數...)ExternalInterface.call("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);
}
}
}
// 簡單呼叫
ExternalInterface.call("jsFunctionName", "參數1", 123, true, {key: "value"});
// 帶回呼 (非同步模式)
ExternalInterface.call("jsAsyncFunction", "param", function(result) {
trace("JS 回呼結果:", result);
});
<!-- 建議使用 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>
// 全域旗標
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);
});
// 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);
};
若 SWF 在 iframe 中 (如原文 `test.jsp` include `test.html`),需跨框架存取:
<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);
});
<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>
| ActionScript | JavaScript | 說明 |
|---|---|---|
| String | String | 直接對應 |
| Number/int/uint | Number | 直接對應 |
| Boolean | Boolean | 直接對應 |
| Array | Array | 索引陣列自動轉換 |
| Object / Dictionary | Object | 鍵值對轉換,非字串鍵會轉字串 |
| Date | Date | 自動轉換為 JS Date 物件 |
| XML / XMLList | XMLDocument / String | 建議在 Flex 端轉為 Object/JSON 字串 |
| ByteArray | 不可直接傳遞 | 需 Base64 編碼字串傳輸 |
| 自訂類別 | Object | 註冊 [RemoteClass(alias="...")] 保留類型資訊 |
// 原因:本地檔案 (file://) 或安全沙箱限制
// 解決:
// - 透過 HTTP/HTTPS 伺服器存取 (localhost 即可)
// - 確保 allowScriptAccess="always"
// - Flash Player 設定面板加入信任位置
// 原因:Flex 尚未初始化完成,或方法名拼寫錯誤
// 解決:務必使用 onFlexReady 回呼機制,確認 flexApp 參考存在
if (window.flexApp && typeof window.flexApp.showParams === "function") {
window.flexApp.showParams("a", "b");
}
// 確保 HTML 頁面編碼為 UTF-8
<meta charset="utf-8">
// Flex 編譯器參數
// -compiler.source-encoding=UTF-8
// JS 傳遞中文前編碼 (通常不需要,但可確保)
ExternalInterface.call("jsFunc", encodeURIComponent("中文參數"));
// Flex 端解碼
var decoded = decodeURIComponent(encodedStr);
// 跨域載入 SWF 時需 crossdomain.xml
// 放在 SWF 所在域名根目錄
// 或在 Flex 程式碼中
Security.allowDomain("*");
Security.allowInsecureDomain("*");
| 原 Flex 功能 | 現代 Web 替代方案 |
|---|---|
| 複雜圖表/視覺化 | ECharts, Chart.js, D3.js, Highcharts, ApexCharts |
| 影音播放/串流 | HTML5 <video>/<audio>, Video.js, HLS.js, Dash.js |
| Rich Text Editor | Quill, 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 |
// 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 技術棧**,僅在維護無法重寫的舊系統時參考此文件。