目錄
- 環(huán)境準(zhǔn)備
- 簡單播放示例
- 視頻加字幕
- VLC的選項(xiàng)參數(shù)設(shè)置
- 在Tkinter中嵌入視頻
- 跨平臺
- 音頻播放器項(xiàng)目
網(wǎng)上關(guān)于Python的音視頻播放示例都集中在簡單的多媒體庫或者PyGame這樣的游戲庫,有些庫使用簡單,但功能單一,有些庫功能豐富,支持的格式多,但使用繁瑣。那有沒有一種功能豐富全面又使用簡單,而且還能支持流媒體播放的庫呢?答案是有的。
VLC
就是我們今天的主角。官網(wǎng)地址: 點(diǎn)擊我
根據(jù)官網(wǎng)的介紹,它是一款自由、開源的跨平臺多媒體播放器及框架,它全面支持絕大部分的多媒體格式,以及各類流媒體協(xié)議。也就是說,使用它既能播放本地音視頻文件,也能在線播放各類流媒體資源。
這是目前全網(wǎng)最全面的一篇關(guān)于VLC
的Python語言綁定的使用教程,本人瀏覽了其API文檔,從文檔中直接提煉出了Python語言綁定的使用方法,本篇以Windows平臺為主,如果讀者朋友覺得有用,請點(diǎn)贊支持!
環(huán)境準(zhǔn)備
VLC 安裝
VLC
實(shí)際上是比較知名的開源多媒體播放器,要使用這個(gè)庫,首先需要在電腦上安裝VLC
,我們可以直接在上述的官網(wǎng)中下載并安裝它,有一點(diǎn)需要特別注意,如果本地安裝的Python是32位,則你必須下載32位的VLC
,64位則下64位的VLC
,必須與Python的版本對應(yīng),否則無法使用。
事實(shí)上,我并不推薦這樣直接安裝。試想一下,如果我們使用Python開發(fā)一個(gè)基于VLC
的播放器發(fā)布出去,卻要求用戶在使用之前,先安裝一個(gè)VLC
播放器,豈不是很荒謬?那么如何將VLC
集成到Python程序中來,才是問題的關(guān)鍵。
關(guān)于這個(gè)問題,沒有找到相關(guān)資料,只能通過查看python-vlc綁定的源碼來尋找方法。
安裝python-vlc 綁定
VLC
是純C語言開發(fā)的框架,Python想要更簡單的調(diào)用,需要安裝一個(gè)python-vlc 綁定,實(shí)際上就是一個(gè)vlc.py
模塊,它封裝了VLC
動(dòng)態(tài)庫的接口,讓我們使用更簡單。
python -m pip install python-vlc
完成安裝后,我們在site-packages
中找到vlc.py
源碼,查看其對VLC
動(dòng)態(tài)庫的加載代碼,可以發(fā)現(xiàn),在Windows系統(tǒng)上,vlc.py
是通過查詢Windows注冊表的方式來搜索路徑并加載VLC
的dll
動(dòng)態(tài)庫的。但它其中也提供了一個(gè)配置環(huán)境變量PYTHON_VLC_MODULE_PATH
的加載方式,這樣我們就能在盡可能不修改vlc.py
源碼的前提下完成VLC
動(dòng)態(tài)庫的集成。
好了,到這里,我們只需要去下載一個(gè)VLC
的綠色免安裝版本即可。由于我的Python環(huán)境是64位,這里給出一個(gè)Windows 64位下載地址:點(diǎn)我 選擇vlc-3.0.6-win64.7z
即可
下載完成后,解壓目錄,進(jìn)入其中,刪除無關(guān)內(nèi)容,保留如下文件
其中plugins
中的內(nèi)容非常多,達(dá)到122M,我們可以根據(jù)實(shí)際情況進(jìn)行剪裁,例如我們只需要做一個(gè)音頻播放器,則可將其中的video相關(guān)的文件夾刪除,還包括gui文件夾,因?yàn)槲覀円约鹤鼋缑?,不需要gui里面的qt相關(guān)的dll。
簡單播放示例
創(chuàng)建一個(gè)Python工程,將已經(jīng)剪裁好的vlc-3.0.6
文件夾拷貝到工程根目錄。然后創(chuàng)建一個(gè)python腳本,我們對vlc.py
再次封裝
import os, time
# 設(shè)置VLC庫路徑,需在import vlc之前
os.environ['PYTHON_VLC_MODULE_PATH'] = "./vlc-3.0.6"
import vlc
class Player:
'''
args:設(shè)置 options
'''
def __init__(self, *args):
if args:
instance = vlc.Instance(*args)
self.media = instance.media_player_new()
else:
self.media = vlc.MediaPlayer()
# 設(shè)置待播放的url地址或本地文件路徑,每次調(diào)用都會重新加載資源
def set_uri(self, uri):
self.media.set_mrl(uri)
# 播放 成功返回0,失敗返回-1
def play(self, path=None):
if path:
self.set_uri(path)
return self.media.play()
else:
return self.media.play()
# 暫停
def pause(self):
self.media.pause()
# 恢復(fù)
def resume(self):
self.media.set_pause(0)
# 停止
def stop(self):
self.media.stop()
# 釋放資源
def release(self):
return self.media.release()
# 是否正在播放
def is_playing(self):
return self.media.is_playing()
# 已播放時(shí)間,返回毫秒值
def get_time(self):
return self.media.get_time()
# 拖動(dòng)指定的毫秒值處播放。成功返回0,失敗返回-1 (需要注意,只有當(dāng)前多媒體格式或流媒體協(xié)議支持才會生效)
def set_time(self, ms):
return self.media.get_time()
# 音視頻總長度,返回毫秒值
def get_length(self):
return self.media.get_length()
# 獲取當(dāng)前音量(0~100)
def get_volume(self):
return self.media.audio_get_volume()
# 設(shè)置音量(0~100)
def set_volume(self, volume):
return self.media.audio_set_volume(volume)
# 返回當(dāng)前狀態(tài):正在播放;暫停中;其他
def get_state(self):
state = self.media.get_state()
if state == vlc.State.Playing:
return 1
elif state == vlc.State.Paused:
return 0
else:
return -1
# 當(dāng)前播放進(jìn)度情況。返回0.0~1.0之間的浮點(diǎn)數(shù)
def get_position(self):
return self.media.get_position()
# 拖動(dòng)當(dāng)前進(jìn)度,傳入0.0~1.0之間的浮點(diǎn)數(shù)(需要注意,只有當(dāng)前多媒體格式或流媒體協(xié)議支持才會生效)
def set_position(self, float_val):
return self.media.set_position(float_val)
# 獲取當(dāng)前文件播放速率
def get_rate(self):
return self.media.get_rate()
# 設(shè)置播放速率(如:1.2,表示加速1.2倍播放)
def set_rate(self, rate):
return self.media.set_rate(rate)
# 設(shè)置寬高比率(如"16:9","4:3")
def set_ratio(self, ratio):
self.media.video_set_scale(0) # 必須設(shè)置為0,否則無法修改屏幕寬高
self.media.video_set_aspect_ratio(ratio)
# 注冊監(jiān)聽器
def add_callback(self, event_type, callback):
self.media.event_manager().event_attach(event_type, callback)
# 移除監(jiān)聽器
def remove_callback(self, event_type, callback):
self.media.event_manager().event_detach(event_type, callback)
調(diào)用代碼
def my_call_back(event):
print("call:", player.get_time())
if "__main__" == __name__:
player = Player()
player.add_callback(vlc.EventType.MediaPlayerTimeChanged, my_call_back)
# 在線播放流媒體視頻
player.play("http://hd.yinyuetai.com/uploads/videos/common/"
"22970150925A6BB75E20D95798D129EE.flv?sc\u003d17d6a907580e9892"
"\u0026br\u003d1103\u0026vid\u003d2400382\u0026aid\u003d32"
"\u0026area\u003dML\u0026vst\u003d0")
# 播放本地mp3
# player.play("D:/abc.mp3")
# 防止當(dāng)前進(jìn)程退出
while True:
pass
VLC 監(jiān)聽器
上面代碼中,我們注冊了MediaPlayerTimeChanged
類型的監(jiān)聽器,表示已播放時(shí)間變化時(shí)回調(diào),可以看到my_call_back
會不斷回調(diào),因?yàn)槊坎シ乓稽c(diǎn)都會回調(diào)。
除了上述的監(jiān)聽器,VLC
的監(jiān)聽器實(shí)際上非常多,常見的我們列舉如下:
- MediaPlayerNothingSpecial:vlc處于空閑狀態(tài),只是等待發(fā)出命令
- MediaPlayerOpening:vlc正在打開媒體資源定位器(MRL)
- MediaPlayerBuffering(int cache):vlc正在緩沖
- MediaPlayerPlaying:vlc正在播放媒體
- MediaPlayerPaused:vlc處于暫停狀態(tài)
- MediaPlayerStopped:vlc處于停止?fàn)顟B(tài)
- MediaPlayerForward:vlc通過媒體快進(jìn)(這永遠(yuǎn)不會被調(diào)用)
- MediaPlayerBackward:vlc正在快退(這永遠(yuǎn)不會被調(diào)用)
- MediaPlayerEncounteredError:vlc遇到錯(cuò)誤,無法繼續(xù)
- MediaPlayerEndReached:vlc已到達(dá)當(dāng)前播放列表的末尾
- MediaPlayerTimeChanged:時(shí)間發(fā)生改變
- MediaPlayerPositionChanged:進(jìn)度發(fā)生改變
- MediaPlayerSeekableChanged:流媒體是否可搜索的狀態(tài)發(fā)生改變(true表示可搜索,false表示不可搜索)
- MediaPlayerPausableChanged:媒體是否可暫停狀態(tài)發(fā)生改變(true表示可暫停,false表示不可暫停)
- MediaPlayerMediaChanged : 媒體發(fā)生改變
- MediaPlayerTitleChanged: 標(biāo)題發(fā)生改變(DVD/Blu-ray)
- MediaPlayerChapterChanged :章節(jié)發(fā)生改變(DVD/Blu-ray)
- MediaPlayerLengthChanged :(在vlc版本2.2.0僅適用于Mozilla)長度已更改
- MediaPlayerVout :視頻輸出的數(shù)量發(fā)生改變
- MediaPlayerMuted :靜音
- MediaPlayerUnmuted :取消靜音
- MediaPlayerAudioVolume :音量發(fā)生改變
要查看全部支持的監(jiān)聽器,請?jiān)L問 官方文檔 并搜索EventType
類型查看
視頻加字幕
在我們上述封裝的Player
類中添加如下方法
def set_marquee(self):
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Enable, 1)
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Size, 28)
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Color, 0xff0000)
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Position, vlc.Position.Bottom)
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Timeout, 0)
self.media.video_set_marquee_int(vlc.VideoMarqueeOption.Refresh, 10000)
def update_text(self, content):
self.media.video_set_marquee_string(vlc.VideoMarqueeOption.Text, content)
創(chuàng)建調(diào)用代碼
video_set_marquee_string
函數(shù)不僅支持直接傳入字符串,還支持"%Y-%m-%d %H:%M:%S"
這種時(shí)間格式,運(yùn)行上述代碼后,會在屏幕下方顯示當(dāng)前時(shí)間,且每一秒刷新一次。
關(guān)于文本的一些屬性設(shè)置
- VideoMarqueeOption.Color :文本顏色,值為16進(jìn)制數(shù)
- VideoMarqueeOption.Enable:是否開啟文本顯示,1表示開啟
- VideoMarqueeOption.Opacity:文本透明度,0 透明,255 完全不透明
- VideoMarqueeOption.Position:文本顯示的位置
- VideoMarqueeOption.Refresh:字符串刷新的間隔(毫秒)對時(shí)間格式字串刷新有用
- VideoMarqueeOption.Size:文字大小,單位像素
- VideoMarqueeOption.Text:要顯示的文本內(nèi)容
- VideoMarqueeOption.Timeout:文本停留時(shí)間。0表示永遠(yuǎn)停留(毫秒值)
- VideoMarqueeOption.marquee_X:設(shè)置顯示文本的x坐標(biāo)值
- VideoMarqueeOption.marquee_Y:設(shè)置顯示文本的y坐標(biāo)值
上面的示例僅僅顯示了一個(gè)固定的時(shí)間字符串,下面我們看一下如何顯示連續(xù)的字幕
if "__main__" == __name__:
player = Player("--sub-source=marq")
player.play("http://hd.yinyuetai.com/uploads/videos/common/"
"22970150925A6BB75E20D95798D129EE.flv?sc\u003d17d6a907580e9892"
"\u0026br\u003d1103\u0026vid\u003d2400382\u0026aid\u003d32"
"\u0026area\u003dML\u0026vst\u003d0")
player.set_marquee()
i = 0
while True:
# 字幕每2秒刷新一條
time.sleep(2)
player.update_text("我是字幕君 "+str(i))
i += 1
VLC的選項(xiàng)參數(shù)設(shè)置
'''
args:設(shè)置 options
'''
def __init__(self, *args):
if args:
instance = vlc.Instance(*args)
self.media = instance.media_player_new()
else:
self.media = vlc.MediaPlayer()
我們在封裝時(shí),特意預(yù)留了選項(xiàng)參數(shù)的設(shè)置,上面添加字幕時(shí),用到了"--sub-source=marq"
參數(shù),實(shí)際上VLC
有非常多的參數(shù),關(guān)于各種參數(shù)的詳細(xì)介紹,可以查看 官方資料
如果看英文太累,這里還有一份 中文版參數(shù)詳解
音頻可視化
在VLC
眾多參數(shù)中,有一個(gè)非常有用的功能,那就是顯示音頻的可視化。這里我們以頻譜為例
if "__main__" == __name__:
player = Player("--audio-visual=visual", "--effect-list=spectrum", "--effect-fft-window=flattop")
player.play("https://api.mlwei.com/music/api/wy/?key=523077333cache=1type=urlid=566442496")
while True:
pass
--effect-list=
字符串>
當(dāng)前可用的效果包括: dummy、scope、spectrum(頻譜)、spectrometer(頻譜儀)與vuMeter
--effect-fft-window=
可選的值{none,hann,flattop,blackmanharris,kaiser}
在Tkinter中嵌入視頻
上面的測試代碼都是在命令行執(zhí)行的,雖然運(yùn)行后啟動(dòng)了一個(gè)窗口渲染視頻,但是我們無法進(jìn)行暫停、快進(jìn)、退出、設(shè)置音量等操作,這是因?yàn)槲覀儧]有寫GUI程序,而tkinter
作為Python犀利的圖形程序庫,可以幫助我們快速構(gòu)建一個(gè)界面程序。
完整示例代碼如下
import os, platform
# 設(shè)置VLC庫路徑,需在import vlc之前
os.environ['PYTHON_VLC_MODULE_PATH'] = "./vlc-3.0.6"
import vlc
class Player:
'''
args:設(shè)置 options
'''
def __init__(self, *args):
if args:
instance = vlc.Instance(*args)
self.media = instance.media_player_new()
else:
self.media = vlc.MediaPlayer()
# 設(shè)置待播放的url地址或本地文件路徑,每次調(diào)用都會重新加載資源
def set_uri(self, uri):
self.media.set_mrl(uri)
# 播放 成功返回0,失敗返回-1
def play(self, path=None):
if path:
self.set_uri(path)
return self.media.play()
else:
return self.media.play()
# 暫停
def pause(self):
self.media.pause()
# 恢復(fù)
def resume(self):
self.media.set_pause(0)
# 停止
def stop(self):
self.media.stop()
# 釋放資源
def release(self):
return self.media.release()
# 是否正在播放
def is_playing(self):
return self.media.is_playing()
# 已播放時(shí)間,返回毫秒值
def get_time(self):
return self.media.get_time()
# 拖動(dòng)指定的毫秒值處播放。成功返回0,失敗返回-1 (需要注意,只有當(dāng)前多媒體格式或流媒體協(xié)議支持才會生效)
def set_time(self, ms):
return self.media.get_time()
# 音視頻總長度,返回毫秒值
def get_length(self):
return self.media.get_length()
# 獲取當(dāng)前音量(0~100)
def get_volume(self):
return self.media.audio_get_volume()
# 設(shè)置音量(0~100)
def set_volume(self, volume):
return self.media.audio_set_volume(volume)
# 返回當(dāng)前狀態(tài):正在播放;暫停中;其他
def get_state(self):
state = self.media.get_state()
if state == vlc.State.Playing:
return 1
elif state == vlc.State.Paused:
return 0
else:
return -1
# 當(dāng)前播放進(jìn)度情況。返回0.0~1.0之間的浮點(diǎn)數(shù)
def get_position(self):
return self.media.get_position()
# 拖動(dòng)當(dāng)前進(jìn)度,傳入0.0~1.0之間的浮點(diǎn)數(shù)(需要注意,只有當(dāng)前多媒體格式或流媒體協(xié)議支持才會生效)
def set_position(self, float_val):
return self.media.set_position(float_val)
# 獲取當(dāng)前文件播放速率
def get_rate(self):
return self.media.get_rate()
# 設(shè)置播放速率(如:1.2,表示加速1.2倍播放)
def set_rate(self, rate):
return self.media.set_rate(rate)
# 設(shè)置寬高比率(如"16:9","4:3")
def set_ratio(self, ratio):
self.media.video_set_scale(0) # 必須設(shè)置為0,否則無法修改屏幕寬高
self.media.video_set_aspect_ratio(ratio)
# 設(shè)置窗口句柄
def set_window(self, wm_id):
if platform.system() == 'Windows':
self.media.set_hwnd(wm_id)
else:
self.media.set_xwindow(wm_id)
# 注冊監(jiān)聽器
def add_callback(self, event_type, callback):
self.media.event_manager().event_attach(event_type, callback)
# 移除監(jiān)聽器
def remove_callback(self, event_type, callback):
self.media.event_manager().event_detach(event_type, callback)
import tkinter as tk
class App(tk.Tk):
def __init__(self):
super().__init__()
self.player = Player()
self.title("流媒體播放器")
self.create_video_view()
self.create_control_view()
def create_video_view(self):
self._canvas = tk.Canvas(self, bg="black")
self._canvas.pack()
self.player.set_window(self._canvas.winfo_id())
def create_control_view(self):
frame = tk.Frame(self)
tk.Button(frame, text="播放", command=lambda: self.click(0)).pack(side=tk.LEFT, padx=5)
tk.Button(frame, text="暫停", command=lambda: self.click(1)).pack(side=tk.LEFT)
tk.Button(frame, text="停止", command=lambda: self.click(2)).pack(side=tk.LEFT, padx=5)
frame.pack()
def click(self, action):
if action == 0:
if self.player.get_state() == 0:
self.player.resume()
elif self.player.get_state() == 1:
pass # 播放新資源
else:
self.player.play("http://hd.yinyuetai.com/uploads/videos/common/"
"22970150925A6BB75E20D95798D129EE.flv?sc\u003d17d6a907580e9892"
"\u0026br\u003d1103\u0026vid\u003d2400382\u0026aid\u003d32"
"\u0026area\u003dML\u0026vst\u003d0")
elif action == 1:
if self.player.get_state() == 1:
self.player.pause()
else:
self.player.stop()
if "__main__" == __name__:
app = App()
app.mainloop()
最后說一點(diǎn),如果我們在創(chuàng)建Player
時(shí),指定音頻可視化參數(shù),如下,則當(dāng)播放音頻時(shí),self._canvas
中將顯示音頻可視化頻譜。
player = Player("--audio-visual=visual",
"--effect-list=spectrum", "--effect-fft-window=flattop")
跨平臺
如果我們想用Python開發(fā)跨平臺的播放器,在Linux系統(tǒng)中,不推薦集成VLC
二進(jìn)制文件,我們可以有兩種思路,Ubuntu中,我們可以通過調(diào)用命令在線安裝vlc
另一種思路則是集成VLC
源碼,調(diào)用系統(tǒng)的編譯命令進(jìn)行編譯。通常Linux平臺都會帶有gcc
編譯器和make
構(gòu)建工具。該方案同樣適用于Mac os平臺。
音頻播放器項(xiàng)目
博主基于VLC編寫的簡單音頻播放器,可支持本地音頻文件以及在線流媒體播放,在線接口使用網(wǎng)易云音樂。傳送門
對tkinter的界面程序開發(fā)感興趣的朋友,可觀看博主的tkinter從入門到實(shí)戰(zhàn)視頻
通過該播放器項(xiàng)目對tkinter界面編程進(jìn)行詳細(xì)講解,突出tkinter使用中的各種坑與細(xì)節(jié)。
到此這篇關(guān)于Python 流媒體播放器的實(shí)現(xiàn)(基于VLC)的文章就介紹到這了,更多相關(guān)Python 流媒體播放器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- 使用Python的Flask框架實(shí)現(xiàn)視頻的流媒體傳輸