萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Dreamweaver 教學

網頁嵌入 Windows Media Player 完整指南:OBJECT 標籤、參數、JavaScript 控制與事件模型

前言

雖 HTML5 <video>/<audio> 已成主流,但企業內部系統、舊版串流平台、特定編碼格式(WMV、ASF、ASX)仍需依賴 Windows Media Player (WMP) ActiveX 控制項。本文完整整理 WMP 嵌入語法、參數配置、JS 控制介面、事件模型與跨瀏覽器相容寫法。

基礎嵌入:OBJECT 標籤

<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>
  • id:JS 存取控制項的唯一識別符(如 document.WMPlay)。
  • classid:WMP ActiveX 的 GUID,固定值。
  • codebase:瀏覽器未安裝控制項時自動下載安裝包的 URL(微軟官方分發點)。
  • type:MIME 類型,觸發瀏覽器載入 ActiveX。

PARAM 參數配置

在 <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" />      <-- 進度追蹤條 -->

JavaScript 控制介面(跨瀏覽器寫法)

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>

HTML 控制按鈕範例

<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>

WMP 事件模型完整表

使用 <script for="WMPlay" event="EventName(params)" language="JScript"> 綁定(IE 專用),或現代 player.attachEvent('EventName', handler) / addEventListener(需控制項支援)。主要事件:

事件參數觸發時機典型用途
OpenStateChangeoldState, newState開啟狀態變化顯示緩衝/連接中狀態、錯誤處理
PlayStateChangeoldState, newState播放狀態變化播放/暫停/停止/結束 觸發 UI 更新、自動播放下一首
BufferingbStart (Boolean)緩衝開始/結束顯示「緩衝中...」動畫
ScriptCommandsType, sParam收到 ASF 指令碼命令同步歌詞、顯示廣告、頁面跳轉
MarkerHitlMarkerNum遇到標記點章節跳轉、廣告插入點偵測
Error—發生錯誤錯誤日誌、使用者友善提示

OpenStateChange 狀態碼

0: 已關閉 (nsClosed)
1: 載入 ASX 中 (nsLoadingASX)
2: 載入 NSC 中 (nsLoadingNSC)
3: 尋找媒體伺服器 (nsLocating)
4: 連接媒體伺服器 (nsConnecting)
5: 開啟/偵聽串流 (nsOpening)
6: 串流已開啟 (nsOpen)

PlayStateChange 狀態碼

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()播放清單下一首/上一首

跨瀏覽器相容性與現代替代方案

  • IE/Edge (IE 模式):完整支援 ActiveX WMP。
  • Chrome/Firefox/Safari/Edge (Chromium):不支援 ActiveX。需安裝外掛(已淘汰)或改用 HTML5 <video>。
  • 企業內部系統:可設定群組原則啟用 IE 模式或使用 Electron/CEF 封裝載入 ActiveX。

優雅降級:HTML5 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 功能並平滑遷移。

copyright © 萬盛學電腦網 all rights reserved