Flash 與 HTML 頁面的溝通(也就是 SWF 與 JS 的互動)一直沒認真研究過,最近因為專案需求不得不投入,順便把心得整理成一篇。
最快速的方式是在嵌入 SWF 時把參數寫在網址後面:
files/home.swf?id="21"
AS3 端這樣接收:
var id:String = stage.loaderInfo.parameters["id"];
這個做法其實從 AS2 時代就有,AS3 只是改用 parameters 屬性來取代 AS1/2 的 SWF 參數傳遞機制。
它的限制很明顯:只能單向、一次性傳值,而且只支援字串。需要雙向溝通時完全無效。
這才是目前公認最可靠的雙向溝通方案,同樣是從 AS2 時代演進而來。
在 AS3 中必須先用 addCallback 把函式「註冊」出去,只有註冊過的方法 JS 才呼叫得到:
ExternalInterface.addCallback(functionName:String, closure:Function):void
兩個參數的意義:
functionName:容器(JS)可用的函式名稱。closure:實際要執行的函式,可以是獨立函式或物件方法的參照。ExternalInterface.addCallback("getASVars", getASFun);
private function getASFun(value:String):void {
// 拿到 JS 傳來的值
}
JS 端要呼叫前,得先取得嵌入的 SWF 物件。無論用哪種嵌入方式都可以設定 id,這裡以 id 為 mov 為例:
function thisMovie(movieName) {
if (navigator.appName.indexOf("Microsoft") != -1) {
return window[movieName];
} else {
return document[movieName];
}
}
thisMovie("mov").getASVars(value);
這個方向更簡單,用 call 即可:
ExternalInterface.call(functionName:String, ... arguments):*
functionName:要在容器中呼叫的函式名稱。arguments:傳給該函式的參數,可為零個或多個,以逗號分隔,支援任何 ActionScript 資料型別。呼叫 JS 時型別會自動轉換。ExternalInterface.call("setToJS", "paramTest");
// JS 端
function senToJS(value) {
alert(value); // 輸出:paramTest
}
它看起來完美,但其實會「挑食」。支援的瀏覽器與平台組合為:
另外還有安全沙箱的問題。若出現安全沙箱警告,可以用兩種方式修正:一是在 HTML 的 object 標籤中設定 allowScriptAccess 參數;二是在 SWF 中加上:
Flash.system.Security.allowDomain(sourceDomain)
實務上還有一點要注意:allowScriptAccess 若設為 sameDomain,跨域的 JS 呼叫會被阻擋;只有在明確需要時才該放寬為 always,否則等於替惡意頁面開了一扇門。