Flash Player 提供了 PercentLoaded() 方法,可以回傳影片目前的載入百分比。透過 allowScriptAccess 參數允許跨腳本存取後,就能在HTML頁面中用JavaScript直接呼叫它,即時掌握載入狀態。
以下是一個可直接運行的完整範例:
<!DOCTYPE HTML>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<title>flash download</title>
</head>
<body>
<object id="movie" classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
codebase="https://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,0,0"
width="750" height="563" align="middle">
<param name="allowScriptAccess" value="sameDomain" />
<param name="movie" value="https://www.crown-golf.com.cn/games/Golf4.swf" />
<param name="menu" value="false" />
<param name="quality" value="high" />
<param name="bgcolor" value="#ffcc33" />
<embed src="https://www.crown-golf.com.cn/games/Golf4.swf" menu="false" quality="high"
bgcolor="#ffcc33" width="750" height="563" name="movie" align="middle"
allowScriptAccess="sameDomain" type="application/x-shockwave-flash"
pluginspage="https://www.macromedia.com/go/getflashplayer" />
</object>
<button onClick="alert(movie.PercentLoaded()==100 ? '下載完成' : '已經下載百分比: ' + movie.PercentLoaded())">PercentLoaded</button>
</body>
</html>
首先,object 標籤必須設定 id="movie",JavaScript才能透過這個名稱抓到物件;embed 標籤也要有對應的 name,這是為了兼顧不同瀏覽器的外掛偵測機制。
其次,allowScriptAccess="sameDomain" 是溝通的前提。若Flash與頁面不同源,瀏覽器的安全性限制會讓腳本呼叫失敗。
最後,PercentLoaded() 回傳 100 代表下載完畢。實務上通常不會只點一次按鈕看結果,而是用 setInterval 定時輪詢,直到進度達標再清除計時器並顯示真正的內容。
對照今日的技術棧,Flash已在2020年底正式停止支援,主流瀏覽器也全面移除了執行環境。這段程式碼現在主要作為歷史參考;若要在現代專案中實作同樣的「載入進度提示」,建議改用 fetch 搭配 ReadableStream 讀取串流,或用 XMLHttpRequest 的 progress 事件來取得位元組級別的進度資訊。