萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 實作線上音樂播放器:基於 Windows Media Player ActiveX 控制項

概述

本文提供一個經典的 ASP.NET 線上音樂播放器範例,利用 Windows Media Player (WMP) ActiveX 控制項 (CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6) 在瀏覽器中實現播放清單管理、媒體新增、播放控制等功能。雖然現代開發傾向使用 HTML5 <audio> 與 JavaScript 框架,但此範例對於維護舊系統或理解 ActiveX 整合仍具參考價值。

核心功能

  • 動態新增媒體至播放清單
  • 清空播放清單
  • 從核取方塊選取多首歌曲並加入播放
  • 手動輸入 URL 新增媒體
  • 完整的 WMP 參數配置(自動播放、音量、UI 模式等)

前端 JavaScript 邏輯

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

ActiveX 物件與參數配置

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

HTML 介面範例

<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()" />

重要注意事項

  • 瀏覽器相容性:ActiveX 僅在 Internet Explorer 中原生支援,Edge/Chrome/Firefox 需外掛或不支援。
  • 安全性限制:現代瀏覽器預設封鎖 ActiveX,需調整安全性設定或使用 Enterprise Mode。
  • 跨平台替代方案:新專案建議採用 HTML5 <audio> + JavaScript (如 Howler.js, MediaElement.js) 實現跨瀏覽器、無外掛播放。
  • requestMediaAccessRights("full"):在某些 Windows 版本中需呼叫此方法才能操作播放清單。

總結

此範例展示了早期 ASP.NET 整合 Windows Media Player 的典型做法。雖然技術已逐漸淘汰,但理解其控制項物件模型、播放清單操作與參數設定,有助於維護既有系統或轉換至現代播放架構時的邏輯對照。

copyright © 萬盛學電腦網 all rights reserved