=====================================================

最簡單的基於libVLC的例子文章列表：

=====================================================

本文記錄使用libVLC開發的一個簡單的圖形介面的視訊播放器。由於是示例程式，只包含了最簡單的媒體播放方面的功能。其中有一些功能還不完善，有時間以後再做修改。

 

最簡單的基於libVLC的視訊播放器（圖形介面版）

這是使用libVLC基於MFC開發的一個示例播放器。實現了一個播放器的基本功能：播放，暫停/繼續，停止，播放時間軸的顯示，以及從任一點開始播放媒體。並且支援將媒體檔案拖拽至播放器進行播放。播放前將媒體檔案的路徑輸入到“URL”欄中，然後單擊“Start”即可開始播放。

播放時候的效果截圖如下所示。

原始碼比較長，不再詳細記錄。簡單記錄一下其中幾個主要功能的實現機制。

視訊的播放/暫停/繼續/停止

播放

視訊“播放”的原始碼如下所示。簡單來說，完成了以下視訊播放的初始化工作：
（1）輸入的URL轉換為UTF-8編碼（後文詳細記錄）
（2）將顯示視訊畫面的控制元件的控制代碼提供給libVLC
（3）初始化libVLC並開始播放
（4）開啟定時器，用於更新視訊播放的進度（後文詳細記錄）

void CplayerGUIDlg::OnBnClickedStart()
{
	CStringW cstr_url;

#ifdef _UNICODE
	m_url.GetWindowText(cstr_url);
#else
	USES_CONVERSION;
	CStringA cstr_urla;
	m_url.GetWindowText(cstr_urla);
	cstr_url.Format(L"%s",A2W(cstr_urla));
#endif

	std::string str_url;
	UNICODE_to_UTF8(cstr_url, str_url);
	const char *char_url=str_url.c_str();

	if(strcmp(char_url,"")==0){
		AfxMessageBox(_T("Input URL is NULL!"));
		return;
	}
	
	HWND screen_hwnd=NULL;
	screen_hwnd = this->GetDlgItem(IDC_SCREEN)->m_hWnd; 

	if(playerstate!=STATE_PREPARE){
		AfxMessageBox(_T("Media is playing now."));
		return;
	}


     /* Create a new item */
     //m = libvlc_media_new_location (libvlc_inst, "http://mycool.movie.com/test.mov");

     libvlc_m = libvlc_media_new_path (libvlc_inst, char_url);

     /* Create a media player playing environement */
     libvlc_mp = libvlc_media_player_new_from_media (libvlc_m);
     
     /* No need to keep the media now */
     libvlc_media_release (libvlc_m);
 
    //on windows
     libvlc_media_player_set_hwnd (libvlc_mp,screen_hwnd);
 
     /* play the media_player */
     int x=libvlc_media_player_play (libvlc_mp);
    
     //_sleep (30000); /* Let it play a bit */
    

	playerstate=STATE_PLAY;
	SetBtn(STATE_PLAY);
	SetTimer(1,1000,NULL);
}
 

暫停/繼續

視訊“暫停/繼續”的原始碼如下所示。其中呼叫了libvlc_media_player_set_pause()設定“暫停”或者是“繼續”。

void CplayerGUIDlg::OnBnClickedPause()
{
	if(playerstate==STATE_PLAY){
		libvlc_media_player_set_pause(libvlc_mp,1);
		playerstate=STATE_PAUSE;
		GetDlgItem(ID_PAUSE)->SetWindowText(_T("Resume"));
	}else if(playerstate==STATE_PAUSE){
		libvlc_media_player_set_pause(libvlc_mp,0);
		playerstate=STATE_PLAY;
		GetDlgItem(ID_PAUSE)->SetWindowText(_T("Pause"));
	}
}
 

停止

視訊“停止”的原始碼如下所示。其中呼叫了libvlc_media_player_stop()停止視訊播放，並且呼叫libvlc_media_player_release()釋放相應的libvlc_media_player_t結構體。

void CplayerGUIDlg::OnBnClickedStop()
{
	if(libvlc_mp!=NULL){
		libvlc_media_player_stop (libvlc_mp);
		libvlc_media_player_release (libvlc_mp);
		KillTimer(1);
	}
	
	SystemClear();
}

視訊播放進度雜時間軸的顯示

隨著視訊的播放，需要在視訊播放進度的時間軸上更新播放進度資訊。在程式中使用了一個定時器完成這個功能。
在視訊開始播放的時候，呼叫SetTimer()開啟定時器。時間間隔設定為1000ms。

SetTimer(1,1000,NULL);

在視訊停止播放的時候，呼叫KillTimer()結束定時器。

KillTimer(1);

在定時器的訊息響應函式中，呼叫libvlc_media_player_get_time()獲取當前視訊的播放進度，此外呼叫libvlc_media_player_get_length()獲取視訊的總時長。
經過計算之後，就可以把計算的結果設定到相應的編輯框（Edit Control）以及滑動控制條（Slider Control）上。

void CplayerGUIDlg::OnTimer(UINT_PTR nIDEvent)
{
	if (nIDEvent == 1){
		CString curtimestr,durationstr;
		int curtime;
		int duration;
		int tns, thh, tmm, tss;
		int progress;
		//ms
		curtime = libvlc_media_player_get_time(libvlc_mp);
		if(curtime!=0){
			//change to second
			tns = curtime/1000;
			thh  = tns / 3600;
			tmm  = (tns % 3600) / 60;
			tss  = (tns % 60);
			curtimestr.Format(_T("%02d:%02d:%02d"),thh,tmm,tss);
			m_curtime.SetWindowText(curtimestr);
		}
		duration  = libvlc_media_player_get_length(libvlc_mp);
		if(duration!=0){
			tns = duration/1000;
			thh  = tns / 3600;
			tmm  = (tns % 3600) / 60;
			tss  = (tns % 60);
			durationstr.Format(_T("%02d:%02d:%02d"),thh,tmm,tss);
			m_duration.SetWindowText(durationstr);

			progress=curtime*100/duration;
			m_progress.SetPos(progress);
		}
	}

	//Stop in the end
	if(libvlc_media_player_get_state(libvlc_mp)==libvlc_Ended)
		OnBnClickedStop();


	CDialogEx::OnTimer(nIDEvent);
}

視訊播放點的調整

當滑鼠拖動滑動控制條（Slider Control）控制元件上的滑塊的時候，需要根據拖動的位置設定視訊的播放進度。此時呼叫libvlc_media_player_set_position()設定視訊的播放進度。訊息響應函式中的程式碼如下所示。

void CplayerGUIDlg::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar)
{
	if (pScrollBar->GetSafeHwnd() == m_progress.GetSafeHwnd()){
		float posf=0.0;
		if(nSBCode==SB_THUMBPOSITION){
			posf=(float)nPos/100.0;
			libvlc_media_player_set_position(libvlc_mp,posf);
		}
	}
	CDialogEx::OnHScroll(nSBCode, nPos, pScrollBar);
}

libVLC中輸入中文檔案路徑問題

libVLC使用英文作為輸入路徑的時候是沒有問題的。但是當我們直接傳遞中文路徑的時候，會出現libVLC將中文解析為亂碼從而導致無法播放的問題。這個問題卡了我一陣子時間。造成這一問題的原因在於VLC的輸入檔案路徑是使用UTF-8編碼的。因此我們需要將輸入路徑轉碼為UTF-8編碼。轉碼之後這一問題即得到了解決。

Unicode轉碼為UTF-8的函式程式碼如下所示。

void CplayerGUIDlg::UNICODE_to_UTF8(CStringW& unicodeString, std::string& str)
{
	int stringLength = ::WideCharToMultiByte(CP_UTF8, NULL, unicodeString, wcslen(unicodeString), NULL, 0, NULL, NULL);

	char* buffer = new char[stringLength + 1];
	::WideCharToMultiByte(CP_UTF8, NULL, unicodeString, wcslen(unicodeString), buffer, stringLength, NULL, NULL);
	buffer[stringLength] = '\0';

	str = buffer;

	delete[] buffer;
}

下載

Simplest libVLC Example

專案主頁

本工程是包含了一些基於libVLC的示例程式。一共包含了如下幾個子程式。
playerGUI: 最簡單的基於libVLC的播放器-圖形介面版。
simplest_libvlc_example: 最簡單的基於libVLC的播放器。
simplest_libvlc_streamer: 最簡單的基於libVLC的推流器。