這個問題曾經困擾我很久。以前只熟悉 img.onload 那類 DOM 元素的載入事件,而 Flash 是一個外掛物件,並不遵循這套模型——沒有現成的 onload 可用。
思路是:Flash 一旦載入完成,它的方法就能被外部 JavaScript 正常呼叫。因此反過來說,只要某個 Flash 方法呼叫起來會丟錯,就代表還沒好;能正常回傳,就代表載入完成。用 setInterval 反覆試,直到成功為止。
(function () {
var flash = 網頁上某個 flash 物件;
var callBack = function () {
alert('loaded');
};
var interval = setInterval(function () {
try {
if (flash.IsPlaying()) {
// 輪詢 flash 的某個方法即可
callBack && callBack.call(flash, args); // 回調函數
clearInterval(interval);
}
} catch (ex) {
// 尚未載入完成,呼叫會拋錯,繼續等
}
}, 1000);
})();
實務上會發現一個問題:當 flash 被放進 setInterval 或 setTimeout 的閉包中時,受限於 JavaScript 單執行緒的關係,IsPlaying() 這類 Flash Player 函數可能呼叫不成功,或回傳結果不準確。
臨時解法是改讀 TotalFrames 屬性——只要能讀到這個值,就可以認定 Flash 已完全載入到頁面中了。
經測試確實可行,代價是可能有 1–2 秒的延遲。若有任何不對之處,歡迎指正。
Play() ------------------------------------------------ 播放動畫
StopPlay() -------------------------------------------- 停止動畫
IsPlaying() ------------------------------------------- 動畫是否正在播放
GotoFrame(frame_number) ------------------------------ 跳轉到某幀
TotalFrames() ---------------------------------------- 獲取動畫總幀數
CurrentFrame() --------------------------------------- 回傳當前動畫所在幀數 - 1
Rewind() --------------------------------------------- 使動畫返回第一幀
SetZoomRect(left,top,right,buttom) ----------------- 放大指定區域
Zoom(percent) ---------------------------------------- 改變動畫大小
Pan(x_position,y_position,unit) ---------------------- 使動畫在 x, y 方向上平移
PercentLoaded() -------------------------------------- 返回動畫被載入的百分比
LoadMovie(level_number,path) ------------------------- 加載動畫
TGotoFrame(movie_clip,frame_number) ------------------ movie_clip 跳轉到指定幀數
TGotoLabel(movie_clip,label_name) -------------------- movie_clip 跳轉到指定標籤
TCurrentFrame(movie_clip) ---------------------------- 回傳 movie_clip 當前幀 - 1
TCurrentLabel(movie_clip) ---------------------------- 回傳 movie_clip 當前標籤
TPlay(movie_clip) ------------------------------------ 播放 movie_clip
TStopPlay(movie_clip) -------------------------------- 停止 movie_clip 的播放
GetVariable(variable_name) --------------------------- 獲取變量
SetVariable(variable_name,value) --------------------- 變量賦值
TCallFrame(movie_clip,frame_number) ------------------ call 指定幀上的 action
TCallLabel(movie_clip,label) ------------------------- call 指定標籤上的 action
TGetProperty(movie_clip,property) -------------------- 獲取 movie_clip 的指定屬性
TSetProperty(movie_clip,property,number) ------------- 設置 movie_clip 的指定屬性
從表上其實不難發現,PercentLoaded() 才是這個問題的正確答案——它直接回傳載入百分比,不必靠 try/catch 猜測。當年沒注意到這個方法,繞了一條遠路。
另外值得補充的是,Flash Player 已於 2020 年底正式停止支援,主流瀏覽器全面移除。上述內容今日僅具歷史參考價值;若正面臨 Legacy 系統遷移,方向應是改用 HTML5 的 video / canvas / WebGL 重新實作。
最後,輪詢本身也是個需要節制的技巧:記得在成功後 clearInterval,並為輪詢次數設上限,否則目標永遠載入不了時會形成無限迴圈。