ExternalInterface.call(jsFunctionName, ...args):Flex 呼叫 JS 函式,可傳參、可取得回傳值。ExternalInterface.addCallback(flexFunctionName, flexFunction):註冊 Flex 函式供 JS 呼叫。ExternalInterface.available:檢查瀏覽器是否支援(含 Flash Player 版本)。import flash.external.ExternalInterface;
public function init():void {
if (ExternalInterface.available) {
// 1. 註冊供 JS 呼叫的 Flex 方法
ExternalInterface.addCallback('checkExit', checkExitHandler);
// 2. 呼叫 JS 函式(注入 onbeforeunload 處理)
var jsCode:String =
"document.insertScript = function() {" +
" window.onbeforeunload = function() {" +
" var flexObj = MarineDataEdit.checkExit();" +
" if (flexObj != '') return flexObj;" +
" }" +
"}";
ExternalInterface.call(jsCode);
}
}
private function checkExitHandler():String {
return "你如果現在離開,則您的所有信息將失效!";
}
<script>
// 1. 定義 Flex 物件參考(需在 object/embed 標籤 id="MarineDataEdit")
var flexApp = document.getElementById('MarineDataEdit') ||
window['MarineDataEdit'] ||
document['MarineDataEdit'];
// 2. 呼叫 Flex 註冊的方法
function checkExit() {
if (flexApp && flexApp.checkExit) {
return flexApp.checkExit();
}
return '';
}
// 3. 頁面卸載前確認
window.onbeforeunload = function() {
var msg = checkExit();
if (msg) return msg;
};
</script>
// Flex -> JS:傳遞 Object/Array(自動序列化為 JSON)
ExternalInterface.call('jsReceiveData', { id: 1, tags: ['a','b'] });
// JS -> Flex:接收 JSON 字串,Flex 端用 JSON.parse
ExternalInterface.addCallback('flexReceive', function(jsonStr:String):void {
var data:Object = JSON.parse(jsonStr);
});
| 問題 | 原因 | 解決 |
|---|---|---|
| ExternalInterface.call 無回應 | Flash 尚未初始化完成 | 在 creationComplete 或 applicationComplete 後呼叫 |
| JS 找不到 Flex 方法 | object/embed 缺少 id 或 name 屬性 | 確保 <object id="app" ...> 且 <embed name="app" ...> |
| IE 安全性錯誤 | 本地檔案跨域限制 | 部署至 HTTP 伺服器,或設定 Flash Player 信任目錄 |
| 中文亂碼 | 編碼不一致 | 頁面 <meta charset="utf-8">,Flex 專案編碼 UTF-8 |
navigateToURL// 簡單開啟新視窗/跳轉,無法取得回傳值
navigateToURL(new URLRequest('javascript:alert("hello")'), '_self');
僅適用單向通知,雙向通訊請用 ExternalInterface。