Python 流媒體播放器的實(shí)現(xiàn)(基于VLC)

更新時(shí)間：2021年04月28日 14:26:57 作者：血色v殘陽(yáng)

這篇文章主要介紹了Python 流媒體播放器的實(shí)現(xiàn)(基于VLC),文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

網(wǎng)上關(guān)于Python的音視頻播放示例都集中在簡(jiǎn)單的多媒體庫(kù)或者PyGame這樣的游戲庫(kù)，有些庫(kù)使用簡(jiǎn)單，但功能單一，有些庫(kù)功能豐富，支持的格式多，但使用繁瑣。那有沒(méi)有一種功能豐富全面又使用簡(jiǎn)單，而且還能支持流媒體播放的庫(kù)呢？答案是有的。

VLC就是我們今天的主角。官網(wǎng)地址：點(diǎn)擊我

根據(jù)官網(wǎng)的介紹，它是一款自由、開(kāi)源的跨平臺(tái)多媒體播放器及框架，它全面支持絕大部分的多媒體格式，以及各類流媒體協(xié)議。也就是說(shuō)，使用它既能播放本地音視頻文件，也能在線播放各類流媒體資源。

這是目前全網(wǎng)最全面的一篇關(guān)于VLC的Python語(yǔ)言綁定的使用教程，本人瀏覽了其API文檔，從文檔中直接提煉出了Python語(yǔ)言綁定的使用方法，本篇以Windows平臺(tái)為主，如果讀者朋友覺(jué)得有用，請(qǐng)點(diǎn)贊支持！

環(huán)境準(zhǔn)備

VLC 安裝

VLC實(shí)際上是比較知名的開(kāi)源多媒體播放器，要使用這個(gè)庫(kù)，首先需要在電腦上安裝VLC，我們可以直接在上述的官網(wǎng)中下載并安裝它，有一點(diǎn)需要特別注意，如果本地安裝的Python是32位，則你必須下載32位的VLC，64位則下64位的VLC，必須與Python的版本對(duì)應(yīng)，否則無(wú)法使用。

事實(shí)上，我并不推薦這樣直接安裝。試想一下，如果我們使用Python開(kāi)發(fā)一個(gè)基于VLC的播放器發(fā)布出去，卻要求用戶在使用之前，先安裝一個(gè)VLC播放器，豈不是很荒謬？那么如何將VLC集成到Python程序中來(lái)，才是問(wèn)題的關(guān)鍵。

關(guān)于這個(gè)問(wèn)題，沒(méi)有找到相關(guān)資料，只能通過(guò)查看python-vlc綁定的源碼來(lái)尋找方法。

安裝python-vlc 綁定

VLC是純C語(yǔ)言開(kāi)發(fā)的框架，Python想要更簡(jiǎn)單的調(diào)用，需要安裝一個(gè)python-vlc 綁定，實(shí)際上就是一個(gè)vlc.py模塊，它封裝了VLC動(dòng)態(tài)庫(kù)的接口，讓我們使用更簡(jiǎn)單。

python -m pip install python-vlc

完成安裝后，我們?cè)?code>site-packages中找到vlc.py源碼，查看其對(duì)VLC動(dòng)態(tài)庫(kù)的加載代碼，可以發(fā)現(xiàn)，在Windows系統(tǒng)上，vlc.py是通過(guò)查詢Windows注冊(cè)表的方式來(lái)搜索路徑并加載VLC的dll動(dòng)態(tài)庫(kù)的。但它其中也提供了一個(gè)配置環(huán)境變量PYTHON_VLC_MODULE_PATH的加載方式，這樣我們就能在盡可能不修改vlc.py源碼的前提下完成VLC動(dòng)態(tài)庫(kù)的集成。

好了，到這里，我們只需要去下載一個(gè)VLC的綠色免安裝版本即可。由于我的Python環(huán)境是64位，這里給出一個(gè)Windows 64位下載地址：點(diǎn)我選擇vlc-3.0.6-win64.7z即可

下載完成后，解壓目錄，進(jìn)入其中，刪除無(wú)關(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。

簡(jiǎn)單播放示例

創(chuàng)建一個(gè)Python工程，將已經(jīng)剪裁好的vlc-3.0.6文件夾拷貝到工程根目錄。然后創(chuàng)建一個(gè)python腳本，我們對(duì)vlc.py再次封裝

import os, time

# 設(shè)置VLC庫(kù)路徑，需在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)用都會(huì)重新加載資源
    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é)議支持才會(huì)生效)
    def set_time(self, ms):
        return self.media.get_time()

    # 音視頻總長(zhǎng)度，返回毫秒值
    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é)議支持才會(huì)生效)
    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，否則無(wú)法修改屏幕寬高
        self.media.video_set_aspect_ratio(ratio)

    # 注冊(cè)監(jiān)聽(tīng)器
    def add_callback(self, event_type, callback):
        self.media.event_manager().event_attach(event_type, callback)

    # 移除監(jiān)聽(tīng)器
    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)聽(tīng)器

上面代碼中，我們注冊(cè)了MediaPlayerTimeChanged類型的監(jiān)聽(tīng)器，表示已播放時(shí)間變化時(shí)回調(diào)，可以看到my_call_back會(huì)不斷回調(diào)，因?yàn)槊坎シ乓稽c(diǎn)都會(huì)回調(diào)。

除了上述的監(jiān)聽(tīng)器，VLC的監(jiān)聽(tīng)器實(shí)際上非常多，常見(jiàn)的我們列舉如下：

MediaPlayerNothingSpecial：vlc處于空閑狀態(tài)，只是等待發(fā)出命令
MediaPlayerOpening：vlc正在打開(kāi)媒體資源定位器（MRL）
MediaPlayerBuffering（int cache）：vlc正在緩沖
MediaPlayerPlaying：vlc正在播放媒體
MediaPlayerPaused：vlc處于暫停狀態(tài)
MediaPlayerStopped：vlc處于停止?fàn)顟B(tài)
MediaPlayerForward：vlc通過(guò)媒體快進(jìn)（這永遠(yuǎn)不會(huì)被調(diào)用）
MediaPlayerBackward：vlc正在快退（這永遠(yuǎn)不會(huì)被調(diào)用）
MediaPlayerEncounteredError：vlc遇到錯(cuò)誤，無(wú)法繼續(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）長(zhǎng)度已更改
MediaPlayerVout :視頻輸出的數(shù)量發(fā)生改變
MediaPlayerMuted :靜音
MediaPlayerUnmuted :取消靜音
MediaPlayerAudioVolume :音量發(fā)生改變

要查看全部支持的監(jiān)聽(tīng)器，請(qǐng)?jiān)L問(wèn) 官方文檔并搜索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)行上述代碼后，會(huì)在屏幕下方顯示當(dāng)前時(shí)間，且每一秒刷新一次。

關(guān)于文本的一些屬性設(shè)置

VideoMarqueeOption.Color ：文本顏色，值為16進(jìn)制數(shù)
VideoMarqueeOption.Enable：是否開(kāi)啟文本顯示，1表示開(kāi)啟
VideoMarqueeOption.Opacity：文本透明度，0 透明，255 完全不透明
VideoMarqueeOption.Position：文本顯示的位置
VideoMarqueeOption.Refresh：字符串刷新的間隔（毫秒）對(duì)時(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()

我們?cè)诜庋b時(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=523077333&cache=1&type=url&id=566442496")

    while True:
        pass

在這里插入圖片描述

--effect-list=<字符串>

當(dāng)前可用的效果包括: dummy、scope、spectrum（頻譜）、spectrometer（頻譜儀）與vuMeter

--effect-fft-window=

可選的值{none,hann,flattop,blackmanharris,kaiser}

在Tkinter中嵌入視頻

上面的測(cè)試代碼都是在命令行執(zhí)行的，雖然運(yùn)行后啟動(dòng)了一個(gè)窗口渲染視頻，但是我們無(wú)法進(jìn)行暫停、快進(jìn)、退出、設(shè)置音量等操作，這是因?yàn)槲覀儧](méi)有寫(xiě)GUI程序，而tkinter作為Python犀利的圖形程序庫(kù)，可以幫助我們快速構(gòu)建一個(gè)界面程序。

完整示例代碼如下

import os, platform

# 設(shè)置VLC庫(kù)路徑，需在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)用都會(huì)重新加載資源
    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é)議支持才會(huì)生效)
    def set_time(self, ms):
        return self.media.get_time()

    # 音視頻總長(zhǎng)度，返回毫秒值
    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é)議支持才會(huì)生效)
    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，否則無(wú)法修改屏幕寬高
        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)

    # 注冊(cè)監(jiān)聽(tīng)器
    def add_callback(self, event_type, callback):
        self.media.event_manager().event_attach(event_type, callback)

    # 移除監(jiān)聽(tīng)器
    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()

在這里插入圖片描述

最后說(shuō)一點(diǎn)，如果我們?cè)趧?chuàng)建Player時(shí)，指定音頻可視化參數(shù)，如下,則當(dāng)播放音頻時(shí)，self._canvas中將顯示音頻可視化頻譜。

player = Player("--audio-visual=visual", 
"--effect-list=spectrum", "--effect-fft-window=flattop")

跨平臺(tái)

如果我們想用Python開(kāi)發(fā)跨平臺(tái)的播放器，在Linux系統(tǒng)中，不推薦集成VLC二進(jìn)制文件，我們可以有兩種思路，Ubuntu中，我們可以通過(guò)調(diào)用命令在線安裝vlc

sudo apt-get install vlc

另一種思路則是集成VLC源碼，調(diào)用系統(tǒng)的編譯命令進(jìn)行編譯。通常Linux平臺(tái)都會(huì)帶有gcc編譯器和make構(gòu)建工具。該方案同樣適用于Mac os平臺(tái)。

音頻播放器項(xiàng)目

在這里插入圖片描述

博主基于VLC編寫(xiě)的簡(jiǎn)單音頻播放器，可支持本地音頻文件以及在線流媒體播放，在線接口使用網(wǎng)易云音樂(lè)。傳送門(mén)

對(duì)tkinter的界面程序開(kāi)發(fā)感興趣的朋友，可觀看博主的tkinter從入門(mén)到實(shí)戰(zhàn)視頻
通過(guò)該播放器項(xiàng)目對(duì)tkinter界面編程進(jìn)行詳細(xì)講解，突出tkinter使用中的各種坑與細(xì)節(jié)。

到此這篇關(guān)于Python 流媒體播放器的實(shí)現(xiàn)(基于VLC)的文章就介紹到這了,更多相關(guān)Python 流媒體播放器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: