DIV CSS 佈局教程網

解決 JS 與 Flash 之間傳值不穩定的問題
編輯:關於JavaScript     

在 Flash 仍常見的年代,網頁常需要 JavaScript 與 Flash 互相傳值——例如 JS 告訴 Flash 要播哪一首背景音樂。這個範例記錄了一個很典型的非同步時序 bug 及其解法。

問題現象

JS 呼叫 Flash 中透過 ExternalInterface.addCallback() 開放的函式時,能否成功帶值帶有隨機性:有時候可以,有時候不行。

根本原因

問題不在 JS 也不在 ActionScript,而在時序。<object></object> 標籤出現在頁面上,並不代表 Flash 內容已經載入完成。當 JS 在 Flash 還沒就緒時就呼叫它開放的 callback,值自然傳不過去——Flash 內部還沒建立好接收的通道,卻已經開始播放音樂,結果什麼都沒聽到。

這是典型的「非同步資源就緒性」問題:載入是非同步的,而呼叫是同步發出的,兩者沒有協調機制。

解法:輪詢 Flash 的載入進度

Flash 開放了一個 PercentLoaded 屬性給 JS 使用,回報自身載入百分比。只要輪詢這個值等到 100,就代表 Flash 已完成初始化,可以安全傳值:

var checkFlashLoaded = setInterval(function() {
    if (flash.PercentLoaded == 100) {
        flash.setBGMusic("bkmusic.mp3");
        clearInterval(checkFlashLoaded);   // 完成後停止輪詢
    }
}, 10);

邏輯很簡單:每 10 毫秒檢查一次載入百分比,未滿 100 就繼續等,滿了才傳值並清除計時器。這樣就能保證傳值時機正確。

原範例的兩個 bug

等號寫錯。原範例寫成 if(flash.PercentLoaded = 100)——這是赋值而非比較。它會把 100 塞進 PercentLoaded,運算式回傳 100(truthy),於是 if 永遠成立,輪詢等於沒作用,問題照樣存在。正確寫法是 == 或 ===。

輪詢間隔太短。10ms 的間隔對「等 Flash 載入」這種秒級的操作顯得過於頻繁,白白消耗 CPU。改成 100ms 或 200ms 綽綽有餘,使用者根本感知不到差別。

更穩定的替代:Flash 主動通知

輪詢是「拉」(pull)模式,比較粗糙。更好的做法是讓 Flash 在初始化完成時主動呼叫 JS,也就是「推」(push):

// ActionScript 端,初始化完成後執行
ExternalInterface.call("onFlashReady");

// JavaScript 端
function onFlashReady(){
    flash.setBGMusic("bkmusic.mp3");
}

這個方式沒有延遲、沒有空轉、也不依賴任何進度屬性,是 Flash 與 JS 互動的建議做法。若同時要防「Flash 載入失敗」,可以再加上逾時機制:

var timeout = setTimeout(function(){
    console.warn('Flash 載入逾時');
}, 10000);

function onFlashReady(){
    clearTimeout(timeout);
    flash.setBGMusic("bkmusic.mp3");
}

這個問題的現代啟示

Flash 已於 2020 年底停止支援,這段程式碼今天只剩歷史價值。但它揭示的問題模式完全不過時:任何非同步資源的初始化完成時機,都需要明確的通知機制。今天同樣的情境包括:

  • 圖片:用 img.onload 或 decode(),別以為設了 src 就能立刻 drawImage。
  • 字型:用 document.fonts.ready,否則 canvas 畫字會用到不對的字型。
  • 動態載入的腳本:<script> 的 onload,或改用 <script type="module"> 並動態 import()。
  • iframe:iframe.onload,跨源時則用 postMessage 協商就緒。

核心原則是:不要假設「設定了就等於完成了」,一定要有明確的就緒通知或狀態檢查。另外,永遠注意比較運算中的 = 與 == 之別,這是 JavaScript 最經典的靜默 bug 之一。

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