雖 HTML5 <video>/<audio> 已成主流,但企業內部系統、舊版串流平台、特定編碼格式(WMV、ASF、ASX)仍需依賴 Windows Media Player (WMP) ActiveX 控制項。本文完整整理 WMP 嵌入語法、參數配置、JS 控制介面、事件模型與跨瀏覽器相容寫法。
<object
id="WMPlay"
width="320"
height="240"
classid="CLSID:22D6F312-B0F6-11D0-94AB-0080C74C7E95"
codebase="https://activex.microsoft.com/activex/controls/mplayer/en/nsmp2inf.cab#Version=6,4,5,715"
standby="Loading Microsoft Windows Media Player components..."
type="application/x-oleobject">
</object>
document.WMPlay)。在 <object> 內部加入 <param> 設定播放行為:
<param name="FileName" value="https://example.com/video.wmv" />
<param name="ShowControls" value="true" /> <!-- 顯示播放控制列 -->
<param name="AutoStart" value="false" /> <-- 不自動播放 -->
<param name="AutoRewind" value="true" /> <-- 播放結束自動倒帶 -->
<param name="PlayCount" value="1" /> <-- 播放次數 -->
<param name="Volume" value="50" /> <-- 音量 0-100 -->
<param name="Mute" value="false" /> <-- 靜音 -->
<param name="Balance" value="0" /> <-- 聲道平衡 -100~100 -->
<param name="EnableContextMenu" value="true" /> <-- 右鍵選單 -->
<param name="ShowStatusBar" value="true" /> <-- 狀態列 -->
<param name="ShowDisplay" value="true" /> <-- 顯示資訊(標題、作者等) -->
<param name="ShowTracker" value="true" /> <-- 進度追蹤條 -->
IE 使用屬性存取(obj.Play()),舊版 Netscape/Firefox 需用方法存取(obj.Play() 同名但底層不同)。統一封裝函式:
<script>
var player = document.getElementById('WMPlay'); // 通用取得方式
function play() { player.Play(); }
function pause() { player.Pause(); }
function stop() {
player.Stop();
player.CurrentPosition = 0; // 重置播放位置
}
function setVolume(vol) { player.Volume = vol; } // 0-100
function setMute(mute) { player.Mute = mute; }
function seek(seconds) { player.CurrentPosition = seconds; }
function getDuration() { return player.Duration; } // 總長度(秒)
function getPosition() { return player.CurrentPosition; } // 目前位置(秒)
</script>
<form name="wmpControls">
<input type="button" value="播放" onclick="play()" />
<input type="button" value="暫停" onclick="pause()" />
<input type="button" value="停止" onclick="stop()" />
<input type="button" value="音量 +" onclick="setVolume(Math.min(100, player.Volume+10))" />
<input type="button" value="音量 -" onclick="setVolume(Math.max(0, player.Volume-10))" />
<input type="button" value="靜音切換" onclick="setMute(!player.Mute)" />
<br/>
進度:<input type="range" id="seekBar" min="0" max="100" value="0" step="1" onchange="seek(this.value * player.Duration / 100)" />
<span id="timeDisplay">00:00 / 00:00</span>
</form>
<script>
// 定期更新進度條
setInterval(function() {
if (player.PlayState == 3) { // 3 = Playing
var pct = (player.CurrentPosition / player.Duration) * 100;
document.getElementById('seekBar').value = pct;
document.getElementById('timeDisplay').textContent =
formatTime(player.CurrentPosition) + ' / ' + formatTime(player.Duration);
}
}, 500);
function formatTime(sec) {
var m = Math.floor(sec/60), s = Math.floor(sec%60);
return (m<10?'0':'')+m + ':' + (s<10?'0':'')+s;
}
</script>
使用 <script for="WMPlay" event="EventName(params)" language="JScript"> 綁定(IE 專用),或現代 player.attachEvent('EventName', handler) / addEventListener(需控制項支援)。主要事件:
| 事件 | 參數 | 觸發時機 | 典型用途 |
|---|---|---|---|
| OpenStateChange | oldState, newState | 開啟狀態變化 | 顯示緩衝/連接中狀態、錯誤處理 |
| PlayStateChange | oldState, newState | 播放狀態變化 | 播放/暫停/停止/結束 觸發 UI 更新、自動播放下一首 |
| Buffering | bStart (Boolean) | 緩衝開始/結束 | 顯示「緩衝中...」動畫 |
| ScriptCommand | sType, sParam | 收到 ASF 指令碼命令 | 同步歌詞、顯示廣告、頁面跳轉 |
| MarkerHit | lMarkerNum | 遇到標記點 | 章節跳轉、廣告插入點偵測 |
| Error | — | 發生錯誤 | 錯誤日誌、使用者友善提示 |
0: 已關閉 (nsClosed)
1: 載入 ASX 中 (nsLoadingASX)
2: 載入 NSC 中 (nsLoadingNSC)
3: 尋找媒體伺服器 (nsLocating)
4: 連接媒體伺服器 (nsConnecting)
5: 開啟/偵聽串流 (nsOpening)
6: 串流已開啟 (nsOpen)
0: 停止 (mpStopped)
1: 暫停 (mpPaused)
2: 播放中 (mpPlaying)
3: 等待串流開始 (mpWaiting)
4: 快轉 (mpScanForward)
5: 快倒 (mpScanReverse)
6: 跳轉前進 (mpSkipForward)
7: 跳轉後退 (mpSkipReverse)
8: 關閉 (mpClosed)
<script for="WMPlay" event="PlayStateChange(oldState, newState)" language="JScript">
if (newState == 8) { // mpClosed / 播放結束
// 切換到下一首邏輯
player.URL = nextMediaUrl;
player.Play();
}
</script>
| 分類 | 名稱 | 說明 |
|---|---|---|
| 屬性 (Property) | URL / FileName | 媒體來源位址(可動態變更) |
| PlayState | 目前播放狀態(唯讀,對應上表碼) | |
| CurrentPosition | 目前播放位置(秒,可讀寫) | |
| Duration | 媒體總長度(秒,唯讀) | |
| Volume | 音量 0-100 | |
| Mute | 靜音 布林值 | |
| ShowControls | 是否顯示控制列 | |
| Settings / Network / CurrentPlaylist | 進階設定物件 | |
| 方法 | Play() | 開始/繼續播放 |
| Pause() | 暫停 | |
| Stop() | 停止 | |
| FastForward() / FastReverse() | 快轉/快倒 | |
| Next() / Previous() | 播放清單下一首/上一首 |
<video>。<object id="WMPlay" ...>
<param name="FileName" value="video.wmv" />
<!-- 現代瀏覽器忽略 object,渲染 video -->
<video width="320" height="240" controls>
<source src="video.mp4" type="video/mp4" />
<source src="video.webm" type="video/webm" />
您的瀏覽器不支援影片播放。
</video>
</object>
Windows Media Player ActiveX 提供豐富的串流控制、指令碼命令、標記點事件,適合企業級串流、教學平台、安防監控等專業場景。但受限於 ActiveX 淘汰,新專案務必採用 HTML5 Media Source Extensions (MSE) + DASH/HLS 串流方案。維護舊系統時,掌握完整參數、JS 控制與事件模型,能最大化發揮 WMP 功能並平滑遷移。