雖 Flash 已退役,但維護舊系統時仍需處理 JS↔SWF 通訊。本文系統整理 ExternalInterface 雙向調用、跨瀏覽器(IE/FF/Chrome)物件獲取差異、allowScriptAccess 設定、常見坑點與現代替代方案。
┌─────────────┐ ExternalInterface.call ┌─────────────┐
│ JavaScript │ ──────────────────────────────→ │ Flash (SWF) │
│ (Container)│ │ (ActionScript)│
└─────────────┘ ←────────────────────────────── ┌─────────────┘
↑ ExternalInterface.addCallback
│ (註冊 JS 可呼叫的 AS 函數)
│
JS 呼叫 SWF 註冊函數
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);
}
}
關鍵點: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>
/**
* 跨瀏覽器獲取 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 } }));
};
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 清理資源 |
若必須維護舊 Flash 整合,遵循上述跨瀏覽器嵌入標準、重試機制與安全設定,能最大程度降低兼容性事故。