C# DirectShow 播放多媒體

#1樓 [樓主] 2008-09-17 17:49 freeliver54      

[轉]利用Visual C#開發一個媒體播放器
---------------------------------
摘要：瞭解如何在 Microsoft Visual C# .NET 中使用 DirectShow 控制元件，如何開發一個媒體播放器。按照本文介紹的操作步驟，您可以建立一個簡單 Visual C# 應用程式，用來播放數字音訊和視訊。 　　

簡介

　　Microsoft Visual C# 是世界上最流行的程式語言，利用 Visual C# 的最新版本 Visual C# .NET，您能夠快速、有效地開發基於 Windows 窗體的應用程式，還可以為嵌入了 Microsoft Windows Media? Player 9 Series ActiveX 控制元件的應用程式新增新鮮、有趣而又非常實用的功能。

　　DirectShow 控制元件是一個標準的 ActiveX 控制元件，提供了大量的功能。DirectShow控制元件提供的功能包括：

　　· 數字媒體檔案和流媒體的高階播放功能。 　　　　

　　· 使用播放列表的功能。
　　· 播放 DVD 和 CD 的功能。
　　· 訪問 Windows Media Player 中的 Media Library（媒體庫）。
　　· 處理後設資料的功能。
　　· 支援字幕。
　　· 支援多種語言的音訊。
　　· 控制網路連通性和訪問相關統計資訊的功能。

　　下面我們來看看構造這個媒體播放器要達到什麼樣的目標，確定了目標也就確定了程式碼量和程式的複雜程度。本文的媒體播放器要達到如下目標：

　　· 是一個選單驅動的簡單AWT應用。
　　· 包含一個“檔案”選單，檔案選單包含三個選單項：
　　· “開啟”，用來開啟媒體檔案。
　　· “迴圈”，是播放一次（預設），還是重複播放。
　　· “退出”，退出程式。
　　· 可以在多種平臺上執行。
　　· 核心功能通過JMF（Java Media Framework）API實現。

　　按照本文介紹的步驟，您將建立一個基於 Windows 窗體的基本應用程式，並在其中嵌入 Player 控制元件。您建立的示例應用程式具有如下特點：

　　· 建立 DirectShow 控制元件的一個例項。
　　· 利用 Windows Media Player 主互操作程式集提供元件物件模型 (COM) 互操作性。
　　· 允許使用者開啟並播放 Windows Media 檔案，尤其是副檔名為 .wma 或 .wmv 的檔案。
　　· 建立供使用者播放、暫停和停止數字媒體內容的傳輸控制按鈕。
　　· 顯示當前數字媒體檔案的標題。
　　· 演示如何使用 Player 物件模型，包括使用屬性、方法和事件的示例。

　　我的這個程式僅僅只是告訴大家如何用DirectShow 在C#中做一個播放機,

　　在這個程式中我們經要解決的一些小問題:

　　1.如何從你的磁碟上開啟媒體檔案

　　2.如何讓工具條上的按鈕起用和禁用

　　3.如何設定狀態列的顯示文字

　　4.如何控制時間　

　　5.如何使用時間控制元件的事件
　
　　6.如何用DirectShow來播放媒體檔案

　　7.如何確定播放狀態等等...

　　下圖顯示了您將要建立的應用程式，其中正在播放名為“Melow”的數字音訊檔案，同時呈現了視覺化效果。


圖 1

　　· 本文假設您已經具備一定的 Visual C# 和 Visual Studio.NET 整合開發環境知識。
準備工作

　　在開始建立應用程式之前，您需要安裝必要的軟體並註冊主互操作程式集 (QuartzTypeLib)。

　　這裡簡單介紹DirectShow 介面：

　　播放視屏和聲音檔案我們要用到DiectX為我們提供的DirectShow元件.使用這個介面可以讓你方便的播放那些共用的影像和聲音檔案.你要做的僅僅只是安裝DirectShow介面和使用它的功能函式和配置正確的介面引數而已.

　　不幸的是.NET並不正式支援DirectX.是的也許你聽說DirectX9支援是嗎?是的,不過在最終版敲定的那一天還沒來,我們都得不到最好的效果.但無論如何我們還是要用的不是嗎?要不這篇文章得作廢了.是的,也許你用過VB,對了,就是它,我們正是要用到那個.

　　開始專案

　　在安裝必要軟體並註冊 QuartzTypeLib之後，您就可以啟動 Visual C#，開始為示例應用程式建立專案。下面我將給大家介紹這一過程的操作步驟。

　　建立專案

　　按以下步驟建立一個空的專案：

　　1. 啟動 Visual Studio .NET，然後單擊 New Project（新建專案）。

　　2. 在 Visual C# Projects（Visual C# 專案）資料夾中單擊 Windows Application（Windows 應用程式），鍵入新專案的名稱（最好為 DirectShow），然後單擊 OK（確定）。

　　Visual C# 使用預設的 Windows 窗體“Form1”建立一個新的專案。

　　3. 這個名稱並沒有特別的意義或用處，所以請在 Properties（屬性）視窗中將窗體名稱更改為 frmPlayMedia，將窗體文字更改為“媒體播放器”。

　　在專案中新增對 DirectShow的引用

　　按照以下步驟在專案中新增一個對 DirectShow的引用：

　　1. 開啟 Visual Studio 工具箱，然後單擊 Components（元件）顯示該皮膚。

　　2. 右擊皮膚，然後單擊 Customize Toolbox（自定義工具箱），顯示對話方塊。

　　3. 在 COM Components（COM 元件）選項卡上，選中 Interop.QuartzTypeLib.dll。（如果 Interop.QuartzTypeLib.dll 由於某種原因未列出，則單擊 Browse [瀏覽] 並查詢名為 QuartzTypeLib.dll的檔案。）

　　4. 單擊 OK（確定）關閉對話方塊。


圖 2

　　要在程式碼中使用 DirectShow，您需要新增一行程式碼，以引用 DirectShow名稱空間。在窗體程式碼視窗的頂部，將以下程式碼新增到所有宣告語句之前：

using QuartzTypeLib;

　　using語句必須在所有 Options 語句（本專案中並未使用）之後，並且在所有其他程式碼之前。新增該語句後。
開發應用程式

　　建立通過 PIA 與 Framework 連線的 Player 控制元件例項之後，您可以向窗體中新增所需的其他元素，並編寫完成實際操作的程式碼。
新增 Windows 窗體控制元件

　　1. 在 View（檢視）選單中，單擊 Designer（設計器），或者單擊 Solution Explorer（解決方案資源管理器）中的 View Designer（檢視設計器）按鈕，切換到窗體設計器。

　　2. 在窗體上增加檔案、播放、資訊等選單。

　　3. 在工具箱的 Windows Forms（Windows 窗體）皮膚中，為您的窗體新增一個工具欄、一個狀態列和圖片imageList。

　　4. 在 Properties（屬性）視窗中，將工具欄的名稱更改為 toolBar1，將在Buttons上增加4個按鈕。狀態列的名稱更改為 statusBar1,並分別增加三個Panel。

　　5. 在工具箱的皮膚中，為您的窗體新增一個面版panel1。

　　6. 增加一個定時器timer1。

　　7. 調整控制元件在窗體中的排列方式，使之符合您的需要而且方便使用者使用。下圖為 Visual Studio Designer（設計器）中完成後的窗體佈局。


圖 3

　　編寫程式碼

　　如何開啟你想要媒體檔案?

　　第一步是編寫在 frmPlayMedia中開啟 Windows Media 檔案的程式碼。要自動切換到 Code（程式碼）檢視並編輯開啟選單的 Click 事件處理程式 (menuItem2_Click) 的程式碼，請雙擊窗體上的“工具欄”按鈕。將以下程式碼新增到事件處理程式中：

　　還記得嗎"檔案 -> 開啟..." 是的幾乎每個使用windows的人都會這樣操作.如何實現?

　　很簡單看看下面的程式碼:

OpenFileDialog penFileDialog = new OpenFileDialog();
openFileDialog.Filter = "Media Files|*.mpg;*.avi;*.wma;*.mov;*.wav;*.mp2;*.mp3|All Files|*.*";
if (DialogResult.OK == openFileDialog.ShowDialog())
{
….
}

　　看吧很簡單是嗎？記得寫一個函式把它放進去。當你點選OK按鈕的時候，DirectShow介面就會得到你想要播放的檔案。下圖解釋了它是如何工作的。

　　DirectShow為多媒體流回放提供最基本的服務，這些多媒體流可以是本地檔案，還可以是伺服器傳輸過來的。特別的，DirectShow可以支援視訊回放，支援以不同的檔案和流格式壓縮視訊內容，包括Windows Media、MPEG、AVI和WAV。

　　在DirectShow的核心處，服務是元件的模組化集合，稱為過濾器，可以根據媒體型別排列成過濾器圖。過濾器可以運算元據流，如讀入、分析、解碼、格式化或渲染。

　　過濾器以樹型進行排列，這棵樹稱為過濾器樹，通過過濾器樹管理器（Filter Graph Manager，簡稱FGM)進行管理。使用FGM應用程式可以通過使用Microsoft Windows Media Player控制元件間接控制過濾器樹，還可以通過呼叫COM介面方法直接控制。DirectShow過濾器樹（參閱圖1)由從源到目標渲染器的有向過濾器序列組成，所有這些通過輸入和輸出過濾器引腳連線。過濾器引腳協商它們將支援哪些媒體型別。FGM控制樹過濾器之間的多媒體資料流。因為DirectShow有一個靈活的、可重配置的過濾器樹體系結構，因此DirectShow可以使用同樣的軟體成分支援多種媒體型別的回放和分流。開發人員還可以通過編寫自己的過濾器擴充套件DirectShow多媒體支援。

　　過濾器

　　過濾器是註冊的DirectShow類，它執行許多媒體資訊處理任務。這些任務包括：

　　　獲得源資訊(例如，獲得媒體流)
　　　分析(例如，在流上執行包讀入、分離和格式化)
　　　轉換(例如，解碼WMA和MPEG-4音訊和視訊流)
　　　渲染(例如，在適當的時候產生音訊PCM或者視訊RGB/YUV輸出，將資料傳給DirectSound和DirectDraw)

　　過濾器使用幾種型別的介面，例如引腳、計數器、傳送器和時鐘介面，來執行它們的任務。過濾器實現和開放了許多介面。FGM可以使用這些介面建立、連線和控制樹。過濾器經常實現包含下列方法的IBaseFilter介面：

　　　執行、停止和暫停過濾器狀態。
　　　恢復過濾器和廠商資訊。
　　　得到和設定參考時鐘。
　　　恢復過濾器狀態資訊。
　　　列舉過濾器引線。
　　　重建過濾器樹時定位引腳

　　使用者單擊“開啟”時，這段程式碼將顯示一個對話方塊，供使用者在計算機上瀏覽並選擇要播放的 .wma 或 .wmv 檔案。使用者選擇檔案（並單擊“確定”）時，程式碼將 Player 的 URL 屬性設定為使用者選擇的檔案。由於 Player 的 autoStart 屬性在預設情況下設定為 True，所以 Player 立即開啟並播放使用者選擇的數字媒體檔案。

　　接下來，新增播放/暫停按鈕的程式碼。在程式碼視窗中，在停止、暫停選單中單擊，然後，在方法名稱列表中單擊 Click。將以下程式碼新增到 Visual C# 為您建立的Click 事件處理程式中：

　　看看下面的程式碼是如何實現的：

CleanUp();
m_objFilterGraph = new FilgraphManager();
m_objFilterGraph.RenderFile(openFileDialog.FileName);
m_objBasicAudio = m_objFilterGraph as IBasicAudio;
try
{
　m_objVideoWindow = m_objFilterGraph as IVideoWindow;
　m_objVideoWindow.Owner = (int) panel1.Handle;
　m_objVideoWindow.WindowStyle. = WS_CHILD | WS_CLIPCHILDREN;
　m_objVideoWindow.SetWindowPosition(panel1.ClientRectangle.Left,
　panel1.ClientRectangle.Top,
　panel1.ClientRectangle.Width,
　panel1.ClientRectangle.Height);
}
catch (Exception ex)
{
　m_objVideoWindow = null;
}
m_objMediaEvent = m_objFilterGraph as IMediaEvent;
m_objMediaEventEx = m_objFilterGraph as IMediaEventEx;
m_objMediaEventEx.SetNotifyWindow((int) this.Handle, WM_GRAPHNOTIFY, 0);
m_objMediaPosition = m_objFilterGraph as IMediaPosition;
m_objMediaControl = m_objFilterGraph as IMediaControl;

//

如何來播放,暫停,停止?
簡單這些函式看字面也知道.
//

m_objMediaControl.Run();//播放
m_objMediaControl.Pause();//暫停
m_objMediaControl.Stop();//停止

// 這段程式碼非常簡單。當使用者單擊播放/暫停按鈕時，程式碼將檢查 Player 的 playState 屬性。如果 Player 正在播放數字媒體檔案，程式碼就會暫停檔案的播放; 如果 Player 已經暫停或停止，程式碼就再次啟動 Player 播放檔案。
OK,在來看我們是如何控制時間進度的?
//

private void timer1_Tick(object sender, System.EventArgs e)
{
　if (m_CurrentStatus == MediaStatus.Running)
　{
　　UpdateStatusBar();
　}
}

　　看見上面那個 UpdateStatusBar();這裡是讓它沒100ms更新一次狀態列.

　　程式碼如下:

private void UpdateStatusBar()
{
　switch (m_CurrentStatus)
　{
　　case MediaStatus.None : statusBarPanel1.Text = "Stopped"; break;
　　case MediaStatus.Paused : statusBarPanel1.Text = "Paused "; break;
　　case MediaStatus.Running: statusBarPanel1.Text = "Running"; break;
　　case MediaStatus.Stopped: statusBarPanel1.Text = "Stopped"; break;
　}
　if (m_objMediaPosition != null)
　{
　　int s = (int) m_objMediaPosition.Duration;
　　int h = s / 3600;
　　int m = (s - (h * 3600)) / 60;
　　s = s - (h * 3600 + m * 60);
　　statusBarPanel2.Text = String.Format("{0:D2}:{1:D2}:{2:D2}", h, m, s);
　　s = (int) m_objMediaPosition.CurrentPosition;
　　h = s / 3600;
　　m = (s - (h * 3600)) / 60;
　　s = s - (h * 3600 + m * 60);
　　statusBarPanel3.Text = String.Format("{0:D2}:{1:D2}:{2:D2}", h, m, s);
　}
　else
　{
　　statusBarPanel2.Text = "00:00:00";
　　statusBarPanel3.Text = "00:00:00";
　}
}

　　還有一個問題程式怎麼能夠知道它播放完了?

　　這會有點麻煩了，想想看有什麼辦法呢？對了，windows是訊息驅動的。那找找看有什麼訊息。有的就EC_COMPLETE。還記得"WndProc" 它嗎？是的，我的老朋友，這次我們必須要改寫它來捕獲EC_COMPLETE訊息。這個訊息是DirectShow通知父窗體，播放結束了。

protected override void WndProc(ref Message m)
{
　if (m.Msg == WM_GRAPHNOTIFY)
　{
　　int lEventCode;
　　int lParam1, lParam2;
　　while (true)
　　{
　　　try
　　　{
　　　　m_objMediaEventEx.GetEvent(out lEventCode,out lParam1,out lParam2,0);
　　　　m_objMediaEventEx.FreeEventParams(lEventCode, lParam1, lParam2);
　　　　if (lEventCode == EC_COMPLETE)
　　　　{
　　　　　m_objMediaControl.Stop();
　　　　　m_objMediaPosition.CurrentPosition = 0;
　　　　　m_CurrentStatus = MediaStatus.Stopped;
　　　　　UpdateStatusBar();
　　　　　UpdateToolBar();
　　　　}
　　　}
　　　catch (Exception)
　　　{
　　　　break;
　　　}
　　}
　}
　base.WndProc(ref m);
}

　　只要播放狀態改變，上述程式碼就會執行。如果 Player 正在播放（使用者開啟檔案時就處於播放狀態，因為 autoStart 設定為 True），程式碼將啟用播放/暫停按鈕和停止按鈕，以便使用者執行操作。之後，程式碼將播放/暫停按鈕的文字更改為“暫停”，這樣使用者就可以使用該按鈕暫停播放過程。最後，程式碼檢索當前數字媒體檔案的標題，並更新標題標籤的文字以顯示標題。

　　如果 Player 被暫停（使用者單擊了播放/暫停按鈕），程式碼會將播放/暫停按鈕的文字更改為“播放”，以提示使用者使用該按鈕可以恢復播放。

　　如果 Player 被停止（使用者單擊了停止按鈕），程式碼將禁用停止按鈕（因 Player 已經停止工作）並將播放/暫停按鈕的文字恢復為預設值“播放”。

　　一切都結束了,現在要做的事就是做些來找一部影片來享受一下自己的成果了.

　　編寫完示例專案的程式碼之後，您可以生成並執行解決方案。

　　生成解決方案

　　在 Build（生成）選單中單擊 Build Solution（生成解決方案）。Visual Studio 開始編譯並生成專案。如果鍵入內容全部正確，生成過程將順利完成，不會出現任何錯誤。如果生成報告錯誤，則請檢查您的程式碼並糾正錯誤。

　　使用示例應用程式

　　要在偵錯程式中執行專案，請按鍵盤上的 F5 鍵。如果出現“檢視生成的程式碼”主題中介紹的未處理的異常，則應該停止除錯會話，刪除或註釋掉生成程式碼中的相應行，然後再按 F5 鍵。

　　您可以單擊“開啟”查詢 .wma 或 .wmv 檔案（究竟選擇何種檔案，取決於您在“開啟”對話方塊中選擇的檔案型別）。選擇某個檔案並單擊“確定”之後，“開啟”對話方塊關閉，開始播放數字媒體檔案，傳輸控制按鈕的狀態也隨之改變。這時您就可以利用傳輸控制按鈕來暫停、重新開始或完全停止播放。