以 RealPlayer ActiveX 控件打造多媒體播放器：從專案建立到播放控制完整實作

RealPlayer 作為早期網路串流媒體的代表性播放器，其 ActiveX 控件（RealPlayer G2 Control）提供豐富的播放控制介面，適合快速開發支援 RM、MP3、AVI、MPEG 等多種格式的播放器應用。本文以對話框基礎專案為例，逐步示範控件插入、介面佈局、事件映射與核心播放邏輯實作。

專案建立與控件引入

1. 建立 MFC 對話框應用程式，專案名稱如 SunApplePlayer。
2. 在對話框編輯器右鍵選單選擇 「插入 ActiveX 控件」，於清單中尋找 RealPlayer G2 Control（或 RealPlayer ActiveX Control）並加入。
3. Visual Studio 會自動產生對應的包裝類別（如 CRealPlayerCtrl），並在對話框標頭檔宣告成員變數 m_player。

介面元素佈局

核心程式碼實作

開啟檔案並播放

void CSunApplePlayerDlg::OnOpen()
{
    static TCHAR szFilter[] = _T(
        "RealMedia (*.rm)|*.rm|"
        "MP3 (*.mp3)|*.mp3|"
        "MPEG (*.mpg;*.mpeg)|*.mpg;*.mpeg|"
        "ASF (*.asf)|*.asf|"
        "AVI (*.avi)|*.avi|"
        "WAV (*.wav)|*.wav|"
        "所有檔案 (*.*)|*.*||");

    CFileDialog dlg(TRUE, NULL, NULL, OFN_HIDEREADONLY | OFN_FILEMUSTEXIST, szFilter);
    if (dlg.DoModal() == IDOK) {
        CString path = dlg.GetPathName();
        path.MakeUpper(); // RealPlayer 部分版本需大寫路徑
        m_player.SetSource(path); // 設定媒體來源
        m_player.DoPlay();        // 開始播放
        SetDlgItemText(IDC_STATUS, path);
    }
}

播放控制基本操作

void CSunApplePlayerDlg::OnPlay()  { m_player.DoPlay(); }
void CSunApplePlayerDlg::OnPause() { m_player.DoPause(); }
void CSunApplePlayerDlg::OnStop()  { m_player.DoStop(); }

音量與進度同步（需定時器輪詢）

void CSunApplePlayerDlg::OnTimer(UINT_PTR nIDEvent)
{
    if (nIDEvent == TIMER_PLAYBACK) {
        long pos = m_player.GetPosition();      // 目前播放位置 (毫秒)
        long dur = m_player.GetDuration();      // 總長度
        if (dur > 0) {
            m_sliderProgress.SetRange(0, (int)dur);
            m_sliderProgress.SetPos((int)pos);
        }
        // 音量同步
        long vol = m_player.GetVolume(); // 0~100
        m_sliderVolume.SetPos((int)vol);
    }
    CDialog::OnTimer(nIDEvent);
}

常見問題與解決方案

• 控件未顯示：確認 RealPlayer 已正確安裝並註冊（regsvr32 rpctrl.dll）。
• SetSource 失敗：檢查檔案路徑是否包含中文/特殊字元，嘗試 GetShortPathName() 轉換。
• 授權問題：部分 RealPlayer 版本需授權金鑰才能在自製程式中使用完整功能。
• 格式相容：RealPlayer G2 控件對新編碼（H.264、HEVC）支援有限，建議搭配 FFmpeg 或 Media Foundation 開發現代播放器。

執行畫面

圖：完成的播放器介面，支援多格式播放與基本控制

結語

雖然 RealPlayer 已非主流，但其 ActiveX 控件開發模式具有代表性，適用於 Windows Media Player、Flash Player 等同類控件。掌握「控件引入 → 介面綁定 → 方法調用 → 事件處理」四步驟，即可快速整合各類多媒體 ActiveX 元件。