1. 程式人生 > >C# Aplayer開發筆記(一)

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根目錄如下

SDK根目錄

其中bin目錄中存放的就是一些dll檔案和解碼庫,docs目錄下是官方幫助文件,include目錄下是什麼我也不知道,samples目錄下是官方的demo,不過貌似是C++的。我們需要用到的只有bin目錄和docs目錄下的東西。

接下來開啟bin目錄,將下載的解碼庫解壓到bin目錄下,覆蓋原有的空解碼庫資料夾(codecs資料夾),覆蓋完成後退回SDK根目錄,開啟cmd(怎麼開啟肯定不用說吧),跳轉到SDK根目錄,執行install.bat,等待完成後就可以關掉了。

install.bat

接下來開啟VS,新建一個Winform專案,完成後再工具箱空白處右鍵>新增選項卡 ,然後將新建的選項卡命名為APlayer,然後在新建的選項卡上右鍵>選擇項,然後在開啟的視窗上選擇COM

新增APlayer元件

然後裡面有個APlayer3 Control,把前面的複選框選中,然後點選確定就OK了,如果你的裡面沒有,那麼請重複第二步,並且以管理員許可權執行cmd。

APlayer

點選確定後APlayer選項卡中就有一個APlayer3 Control元件了,拖到窗體上就能用了。

到這一步還沒完,因為現在你寫的程式,發給別人後,別人還要安裝APlayer才行,想要直接發給別人就可以用的話,需要先開啟解決方案資源管理器,選中引用中的APlayer3Lib,然後開啟屬性面板,將裡面的獨立屬性和嵌入互操作性屬性改成True

APlayer 
APlayer

到此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 設定” 章節