C# Aplayer開發筆記(一)
最近上班很無聊,剛好在找軟體的時候發現現在好多直播,視訊軟體都是基於APlayer引擎開發的,因此產生了自己開發一個視訊播放器的想法,功能上APlayer可以滿足本地播放,網路播放,直播等功能。
APlayer介紹
引擎介紹:
APlayer 媒體播放引擎是迅雷公司從 2009 年開始開發的通用音視訊媒體檔案播放核心。
迅雷看看播放器和迅雷影音就是使用 APlayer 作為播放核心,目前迅雷看看播放器在PC播放器市場佔有率排第一。本質上APlayer播放引擎是一個ActiveX控制元件,可以被本地其他外部程式嵌入呼叫,也可以直接被網頁嵌入,類似於(Adobe Flash Player)。APlayer不包含介面,但另一個依賴於APlayer的ActiveX控制元件APlayerUI可以提供豐富的介面元素(播放控制條,Flash廣告等),APlayerUI 也被包含在 APlayerSDK 中。
APlayer特點:
- 封閉式 DirectShow 架構,不受系統解碼環境干擾
- 全媒體檔案格式支援
- 豐富的媒體檔案傳輸協議(http/ftp/mms/rtsp/rtmp/hls等)
- 強大的附加功能(字幕、音軌、轉碼/轉格式、畫質增強、截GIF……)
- 支援將多個 ts/flv/mp4 分段切片檔案組成 m3u8 無縫播放
- 支援最新的 H.265(HEVC) 解碼 (Powered by北京視駿科技有限公司)
- 支援全景視訊和虛擬現實(VR)眼鏡 Oculus DK2 的播放。
APlayer下載
建議直接到APlayer官網下載最新版本
APlayer安裝
先下載SDK和解碼庫,下載後先解壓SDK,解壓後SDK根目錄如下
其中bin目錄中存放的就是一些dll檔案和解碼庫,docs目錄下是官方幫助文件,include目錄下是什麼我也不知道,samples目錄下是官方的demo,不過貌似是C++的。我們需要用到的只有bin目錄和docs目錄下的東西。
接下來開啟bin目錄,將下載的解碼庫解壓到bin目錄下,覆蓋原有的空解碼庫資料夾(codecs資料夾),覆蓋完成後退回SDK根目錄,開啟cmd(怎麼開啟肯定不用說吧),跳轉到SDK根目錄,執行install.bat,等待完成後就可以關掉了。
接下來開啟VS,新建一個Winform專案,完成後再工具箱空白處右鍵>新增選項卡 ,然後將新建的選項卡命名為APlayer,然後在新建的選項卡上右鍵>選擇項,然後在開啟的視窗上選擇COM
然後裡面有個APlayer3 Control,把前面的複選框選中,然後點選確定就OK了,如果你的裡面沒有,那麼請重複第二步,並且以管理員許可權執行cmd。
點選確定後APlayer選項卡中就有一個APlayer3 Control元件了,拖到窗體上就能用了。
到這一步還沒完,因為現在你寫的程式,發給別人後,別人還要安裝APlayer才行,想要直接發給別人就可以用的話,需要先開啟解決方案資源管理器,選中引用中的APlayer3Lib,然後開啟屬性面板,將裡面的獨立屬性和嵌入互操作性屬性改成True
到此APlayer就安裝完成了(貌似後面的部分已經不屬於APlayer的安裝範圍了 =.=)
APlayer使用
接下來是APlayer的使用,先開啟APlayerSDK根目錄下的docs資料夾裡面的官方手冊(APlayer.chm)
手冊目錄裡面的什麼IDL定義啊什麼的都不用看,和C#沒什麼關係,主要是看APlayer方法、事件和設定。
APlayer方法
APlayer方法沒什麼好說的,也就是APlayer.方法名(引數),每個方法是幹嘛的也有解釋,寫播放器的話我認為這些基礎的東西應該都會了吧。
APlayer事件
APlayer雖然在VS屬性面板中有事件,但是貌似並沒有什麼用,事件還是要自己寫,所以就講一下APlayer事件的用法吧,下面用OnMessage事件為慄來講解。
先寫個名為OnMessage(方法名可以自己定義,建議直接用事件名)的方法:
/// <summary>
/// OnMessage 事件發生在使用者在 APlayer 視訊區域引發滑鼠操作或者當 APlayer 視訊區域擁有焦點時引發鍵盤操作時。
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
public void OnMessage(object sender,AxAPlayer3Lib._IPlayerEvents_OnMessageEvent e)
{
// 方法體
}
該方法有兩個引數,第一個是object型別,第二個是APlayer內的一個型別,每個方法對應不同的型別,舉個栗子:
OnMessag事件就是AxAPlayer3Lib._IPlayerEvents_OnMessageEvent
OnStateChanged事件就是AxAPlayer3Lib._IPlayerEvents_OnStateChangedEvent
OnDownloadCodec事件就是AxAPlayer3Lib._IPlayerEvents_OnDownloadCodecEvent
然後在視窗的Load事件裡面,將定義的OnMessage方法繫結(委託?拜託?指定?指引?綁架?反正就是這個意思而已 [智障.jpg])
APlayer.OnMessage += new AxAPlayer3Lib._IPlayerEvents_OnMessageEventHandler(OnMessage);
- 1
繫結的方法就是:
APlayer.事件名 += new APlayer中事件對應的類(要繫結的方法名)
再舉個栗子:
OnMessage 事件就是:
APlayer.OnMessage += new AxAPlayer3Lib._IPlayerEvents_OnMessageEventHandler(OnMessage);
OnStateChanged事件就是:
APlayer.OnStateChanged += new AxAPlayer3Lib._IPlayerEvents_OnStateChangedEventHandler(OnStateChanged);
OnDownloadCodec事件就是:
APlayer.OnDownloadCodec += new AxAPlayer3Lib._IPlayerEvents_OnDownloadCodecEventHandler(OnDownloadCodec);
這樣就可以繫結事件了,然後在自己寫的方法中寫事件觸發時要執行的程式碼。
APlayer設定
APlayer設定的話主要是通過GetConfig和SetConfig方法來完成,GetConfig用於獲取設定的值,SetConfig用於設定對應設定的值。
- 返回值:string GetConfig(int 設定編號)
- 返回值:int GetConfig(int 設定編號,string 設定值)
設定編號可以檢視官方手冊中的 “APlayer 設定” 章節