DIV CSS 佈局教程網

AS3 與 JS 雙向通訊:從 Flashvars 到 ExternalInterface
編輯:JavaScript綜合知識     

SWF 嵌在 HTML 裡,兩邊要交換數據,方案隨 Flash 版本演進過幾輪。下面把可用的路子理一遍。

一、最省事的方式:Flash 參數

嵌 SWF 時直接帶參數:

files/home.swf?id="21"

AS3 裡這樣接:

var id:String = stage.loaderInfo.parameters["id"];

AS2 時代也是類似做法,AS3 只是把取值方式換成了 parameters 屬性(它替代了 AS1/AS2 把 SWF 參數作為主時間軸變量的技術)。

局限很明顯:只能單向、一次性傳值,而且只能傳字符串。要與 JS 相互通信就不夠用了。

二、ExternalInterface:公認的正解

這個接口從 AS2 時代演進而來,是目前最可靠的通信方式,支持雙向、支持多數據類型。

JS 調用 AS3 的函數

前提是在 AS3 側先註冊好要開放的方法——只有 AS3 主動「答應」的函數,JS 才能調用。

ExternalInterface.addCallback("getASVars", getASFun);

private function getASFun(value:String):void {
    // 拿到 JS 傳來的值
}

addCallback(functionName:String, closure:Function) 的兩個參數:functionName 是容器(JS)可用於調用函數的名稱;closure 是要被調用的函數,可以是獨立函數,也可以是某個對象實例的方法。

JS 側調用前,要先拿到 SWF 在頁面中的引用。由於各浏覽器取嵌入對象的方式不同,通常封裝一個兼容函數:

function thisMovie(movieName) {
    if (navigator.appName.indexOf("Microsoft") != -1) {
        return window[movieName];
    } else {
        return document[movieName];
    }
}

// 假設 SWF 的 id / name 是 "mov"
thisMovie("mov").getASVars(value);

AS3 調用 JS 的函數

AS3 側用 call:

ExternalInterface.call("setToJS", "paramTest");

call(functionName:String, ... arguments):第一個參數是容器中要調用的函數名;後續參數會原樣傳過去,可以指定零個或多個,之間用逗號分隔,類型可以是任何 ActionScript 數據類型。調用 JS 函數時 AS 類型會自動封裝成 JS 類型;調用其他 ActiveX 容器時,參數會在請求消息中被編碼。

JS 側實現對應函數即可:

function setToJS(value) {
    alert(value);        // 輸出 paramTest
}

三、兼容性與安全沙箱

ExternalInterface 並非在所有環境都可用,它依賴浏覽器與 Flash Player 之間的腳本橋接。當年支持的組合大致是:

Internet Explorer 5.0+(Windows)、Netscape 8.0+(Windows / Macintosh)、Mozilla 1.7.5+(Windows / Macintosh)、Firefox 1.0+(Windows / Macintosh)、Safari 1.3+(Macintosh)。

另外還有安全沙箱的限制。跨域通信時若出現安全沙箱警報,有兩種常規處理:

一、在 HTML 的 object / embed 標籤中放開訪問:設置 allowScriptAccess 和 allowNetworking 相關參數,並通過 Flash Player 的全局安全設置把目標域加入信任列表。

二、在 SWF 內部顯式聲明信任域:

Flash.system.Security.allowDomain(sourceDomain);

(新寫法為 Security.allowDomain(sourceDomain)。)注意這等於允許該域下的內容腳本化你的 SWF,只應對可信來源開放,不要寫成 *。

四、實戰中值得注意的事

調用時機。這是 AS3 與 JS 通信最常見的問題:SWF 尚未加載完成時,JS 調用會靜默失敗。可靠做法是由 AS3 在 ExternalInterface.available 為真且初始化完成後,主動調用一個 JS 函數通知「我好了」,JS 收到通知再開始雙向通信。或者由 JS 輪詢 SWF 的加載進度(如 PercentLoaded)直到 100。

先判斷可用性。調用前檢查 ExternalInterface.available(AS3 側)或 typeof swfObj.method == "function"(JS 側),避免在 unsupported 環境拋錯。

傳值要做轉義。字符串中若含引號、換行或 HTML 字符,直接拼接會破壞調用。JS 側應使用 encodeURIComponent 編碼,AS3 側對應用 decodeURIComponent 解碼;不要依賴手工轉義。

性能。ExternalInterface 每次調用都要跨浏覽器/插件邊界,開銷遠高於同側函數調用。高頻場景(比如逐幀同步位置)不要用它,應改為在 JS 側用定時器拉取,或在 AS3 側攢批後一次發送。

技術已終結。Flash Player 於 2020 年底停止支持,主流浏覽器已全面移除。這套知識今天只剩維護遗留系統的價值。新項目裡,「在網頁中嵌入一段複雜交互邏輯」的正解是編譯到 WebAssembly,配合常規的 JS 接口通信;「播放音視頻」用 HTML5 的 <audio>/<video>;「矢量動畫」用 SVG + CSS/JS 動畫或 Canvas。ExternalInterface 的設計思路——顯式註冊、雙向調用、可用性檢測——在任何跨語言/跨運行時通信中依然適用,這倒是它值得記住的部分。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved