本文提供一個經典的 ASP.NET 線上音樂播放器範例,利用 Windows Media Player (WMP) ActiveX 控制項 (CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6) 在瀏覽器中實現播放清單管理、媒體新增、播放控制等功能。雖然現代開發傾向使用 HTML5 <audio> 與 JavaScript 框架,但此範例對於維護舊系統或理解 ActiveX 整合仍具參考價值。
<script language="JavaScript">
var MediaPlayer = document.getElementById("MediaPlayer");
// 新增媒體到播放清單
function addmedia(url) {
MediaPlayer.settings.requestMediaAccessRights("full");
var playlist = MediaPlayer.currentPlaylist;
var currMedia = MediaPlayer.newMedia(url);
playlist.appendItem(currMedia);
}
// 清空播放清單
function clearlist() {
while (MediaPlayer.currentPlaylist.count > 0) {
var item = MediaPlayer.currentPlaylist.item(MediaPlayer.currentPlaylist.count - 1);
MediaPlayer.currentPlaylist.removeItem(item);
}
}
// 將勾選的歌曲加入清單並播放
function addSeletedSongToPlayList() {
clearlist();
var selectItem = document.getElementsByName("song");
for (var i = 0; i < selectItem.length; i++) {
if (selectItem[i].checked) {
addmedia(selectItem[i].value);
}
}
MediaPlayer.controls.play();
}
// 手動輸入 URL 新增
function addUrlToList() {
addmedia(document.getElementById("songURL").value);
}
</script>
<object classid="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6"
name="MediaPlayer" width="320" height="240" id="MediaPlayer" style="filter:gray()">
<param name="AutoStart" value="1" />
<param name="Balance" value="0" />
<param name="enabled" value="1" />
<param name="EnableContextMenu" value="-1" />
<param name="url" value="" />
<param name="PlayCount" value="1" />
<param name="rate" value="1" />
<param name="currentPosition" value="0" />
<param name="currentMarker" value="0" />
<param name="defaultFrame" value="0" />
<param name="invokeURLs" value="0" />
<param name="baseURL" value="" />
<param name="stretchToFit" value="0" />
<param name="volume" value="50" />
<param name="mute" value="0" />
<param name="uiMode" value="Full" />
<param name="windowlessVideo" value="0" />
<param name="fullScreen" value="0" />
<param name="enableErrorDialogs" value="0" />
<param name="SAMIStyle" value="" />
<param name="SAMILang" value="" />
<param name="SAMIFilename" value="" />
<embed id="MediaPlayer" autostart="1" clicktoplay="0" width="320" height="240" showaudiocontrols="1" />
</object>
<input type="checkbox" name="song" value="https://example.com/song1.mp3" /> 歌曲一<br/>
<input type="checkbox" name="song" value="https://example.com/song2.mp3" /> 歌曲二<br/>
<input type="button" value="播放勾選歌曲" onclick="addSeletedSongToPlayList()" /><br/>
<input type="text" id="songURL" placeholder="輸入媒體 URL" />
<input type="button" value="新增 URL" onclick="addUrlToList()" />
<audio> + JavaScript (如 Howler.js, MediaElement.js) 實現跨瀏覽器、無外掛播放。requestMediaAccessRights("full"):在某些 Windows 版本中需呼叫此方法才能操作播放清單。此範例展示了早期 ASP.NET 整合 Windows Media Player 的典型做法。雖然技術已逐漸淘汰,但理解其控制項物件模型、播放清單操作與參數設定,有助於維護既有系統或轉換至現代播放架構時的邏輯對照。