使用python實現視頻播放器（支持拖動播放位置跳轉）

Python實現視頻播放器，在我早期的博文中介紹或作為資料記錄過

Python實現視頻播放器 https://blog.csdn.net/cnds123/article/details/145926189

Python實現本地視頻/音頻播放器https://blog.csdn.net/cnds123/article/details/137874107

Python簡單GUI程序示例 中 “四、視頻播放器” https://blog.csdn.net/cnds123/article/details/122903311

但是，一直不盡人意。現在，再介紹一個。

這是一個基于 PyQt6 和 python-vlc 開發的視頻播放器，主要實現了我多次試圖實現未果的功能

——帶有播放進度條，不僅顯示播放進度，還支持拖動播放位置跳轉。

普通版視頻播放器

主要特點：

? ? 播放畫面隨窗口縮放

??? 支持常見格式（MP4、AVI、MKV 等）

??? 通過文件對話框加載視頻文件

??? 播放/暫停、停止、播放進度跳轉、音量調節

??? 顯示視頻文件名、當前播放時間、總時長

播放進度條：顯示播放進度并支持拖動播放位置跳轉。

音量滑塊：音量滑塊調整音量大小。

需安裝以下 Python第三方庫：

python-vlc、 PyQt6

Windows中，還要安裝 VLC 播放器，其下載 地址 https://www.videolan.org/vlc/ 。否則，將報錯：缺少 libvlc.dll。

運行效果界面如下：

基本使用操作：

??? 打開文件：點擊菜單欄 文件 > 打開文件（快捷鍵 Ctrl+O） 或底部 打開文件 按鈕

??? 播放/暫停：空格鍵 或 點擊 按鈕切換

??? 停止：停止 按鈕???

??? 進度跳轉：拖動進度條

??? 音量調節：拖動底部音量滑塊

源碼如下：

import sys
import time
import vlc
import os
from PyQt6 import QtWidgets, QtCore, QtGuiclass VLCPlayer(QtWidgets.QMainWindow):def __init__(self):super().__init__()self.instance = vlc.Instance()self.player = self.instance.media_player_new()self.timer = QtCore.QTimer(self)self.timer.timeout.connect(self.update_ui)self.current_file = Noneself.media_loaded = Falseself.init_ui()def init_ui(self):# 主窗口設置self.setWindowTitle("PyQt6 VLC Player")self.resize(800, 600)# 創建菜單欄menubar = self.menuBar()file_menu = menubar.addMenu("文件(&F)")# 添加"打開"動作open_action = QtGui.QAction("打開文件...", self)open_action.setShortcut("Ctrl+O")open_action.triggered.connect(self.open_file)file_menu.addAction(open_action)# 創建主容器和布局central_widget = QtWidgets.QWidget(self)self.setCentralWidget(central_widget)main_layout = QtWidgets.QVBoxLayout(central_widget)main_layout.setContentsMargins(0, 0, 0, 0)# 視頻標題標簽 self.title_label = QtWidgets.QLabel("當前未選擇媒體文件")self.title_label.setAlignment(QtCore.Qt.AlignmentFlag.AlignCenter)self.title_label.setStyleSheet("font-size: 14px; color: #666; margin: 5px;")main_layout.addWidget(self.title_label)# 視頻顯示區域self.video_widget = QtWidgets.QWidget()self.video_widget.setStyleSheet("background-color: black;")main_layout.addWidget(self.video_widget, stretch=1)# 控制面板control_panel = QtWidgets.QWidget()control_layout = QtWidgets.QVBoxLayout(control_panel)# 進度條self.progress_bar = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)self.progress_bar.setMinimum(0)self.progress_bar.sliderMoved.connect(self.set_position)control_layout.addWidget(self.progress_bar)# 時間標簽self.time_label = QtWidgets.QLabel("00:00:00 / 00:00:00")control_layout.addWidget(self.time_label)# 控制按鈕button_layout = QtWidgets.QHBoxLayout()self.play_btn = QtWidgets.QPushButton("播放")self.play_btn.clicked.connect(self.toggle_play)self.stop_btn = QtWidgets.QPushButton("停止")self.stop_btn.clicked.connect(self.stop)self.open_btn = QtWidgets.QPushButton("打開文件")self.open_btn.clicked.connect(self.open_file)# 音量控制self.volume_slider = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)self.volume_slider.setRange(0, 100)self.volume_slider.setValue(100)self.volume_slider.valueChanged.connect(self.set_volume)# 添加控件button_layout.addWidget(self.open_btn)button_layout.addWidget(self.play_btn)button_layout.addWidget(self.stop_btn)button_layout.addWidget(QtWidgets.QLabel("音量:"))button_layout.addWidget(self.volume_slider)control_layout.addLayout(button_layout)main_layout.addWidget(control_panel)# 設置VLC渲染if sys.platform == "win32":self.player.set_hwnd(int(self.video_widget.winId()))elif sys.platform == "linux":self.player.set_xwindow(self.video_widget.winId())elif sys.platform == "darwin":from PyQt6.QtGui import QCocoaNativeContextself.player.set_nsobject(int(QCocoaNativeContext(self.video_widget.winId()).nsview()))self.timer.start(200)def open_file(self):# 修復1：打開文件前先停止播放if self.player.is_playing():self.player.stop()self.media_loaded = Falseself.play_btn.setText("播放")file_dialog = QtWidgets.QFileDialog(self)file_dialog.setNameFilter("視頻文件 (*.mp4 *.avi *.mkv *.mov *.flv)")if file_dialog.exec():selected_files = file_dialog.selectedFiles()if selected_files:self.load_media(selected_files[0])def load_media(self, file_path):try:# 新增：停止定時器避免沖突self.timer.stop()# 修復2：確保徹底釋放舊媒體資源self.player.stop()self.player.set_media(None)  # 清除舊媒體引用# 重置狀態self.media_loaded = Falseself.play_btn.setText("播放")self.progress_bar.setValue(0)self.time_label.setText("00:00:00 / 00:00:00")# 加載新文件self.current_file = file_pathmedia = self.instance.media_new(file_path)self.player.set_media(media)# 更新標題file_name = os.path.basename(file_path)self.title_label.setText(f"當前播放: {file_name}")# 修復3：異步解析媒體信息（避免阻塞UI）media.parse_with_options(vlc.MediaParseFlag.network, 1000)# 設置進度條最大值self.progress_bar.setMaximum(media.get_duration())self.media_loaded = True# 顯示總時長total_time = time.strftime("%H:%M:%S", time.gmtime(media.get_duration() // 1000))self.time_label.setText(f"00:00:00 / {total_time}")# 新增：確保媒體加載完成后再啟定時器self.timer.start(200)except Exception as e:QtWidgets.QMessageBox.critical(self, "錯誤", f"無法加載文件:\n{str(e)}")self.media_loaded = Falseself.title_label.setText("媒體加載失敗")def toggle_play(self):if not self.media_loaded:self.open_file()return# 修復4：強制同步按鈕狀態if self.player.is_playing():self.player.pause()self.play_btn.setText("播放")else:self.player.play()self.play_btn.setText("暫停")def stop(self):self.player.stop()self.progress_bar.setValue(0)self.time_label.setText("00:00:00 / 00:00:00")self.play_btn.setText("播放")self.title_label.setText("播放已停止")def set_volume(self, value):self.player.audio_set_volume(value)def set_position(self, value):if self.player.is_seekable():self.player.set_position(value / self.progress_bar.maximum())def update_ui(self):if not self.media_loaded:return  # 新增：防止在無媒體時更新media_length = self.player.get_length()if media_length > 0:current_time = self.player.get_time()# 新增：檢測播放結束if current_time >= media_length - 500:  # 留50ms容差self.stop()returnself.progress_bar.setMaximum(media_length)self.progress_bar.setValue(current_time)total_time = time.strftime("%H:%M:%S", time.gmtime(media_length // 1000))current_time_str = time.strftime("%H:%M:%S", time.gmtime(current_time // 1000))self.time_label.setText(f"{current_time_str} / {total_time}")def closeEvent(self, event):self.player.stop()event.accept()if __name__ == "__main__":app = QtWidgets.QApplication(sys.argv)player = VLCPlayer()player.show()sys.exit(app.exec())

專用版視頻播放控制器（視頻播控器）

主要添加視頻“加密”、“解密”功能

運行條件除了和上面的一樣外，還需安裝第三方庫pycryptodome

pycryptodome 是一個強大的加密庫，用于實現加密算法。

界面如下：

1)加密視頻

菜單欄點擊 安全 → 加密視頻

優先當前播放文件路徑，即：

??? 如果當前正在播放視頻且未加密 → 彈出確認對話框

??? 否則 → 彈出文件選擇對話框

加密文件的后綴 .vef，放在原文將后綴之后。命名規則為：原文件名.vef（如 video.mp4 → video.mp4.vef）

2)解密視頻

菜單欄點擊 安全 → 解密視頻

文件過濾：僅顯示 .vef 文件

解密文件，出現保存對話框，默認放置在原位置，默認用文件名（可改），若存放處有同名文件，提示是否替換。

命名規則：自動去除 .vef 后綴 → video.mp4

解密時，若輸入的密碼和加密時不一致，提示：密碼錯誤或文件損壞 → 立即終止并提示

源碼如下：

import sys
import time
import hashlib
import secrets
from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad
import vlc
import os
from PyQt6 import QtWidgets, QtCore, QtGuiclass VLCPlayer(QtWidgets.QMainWindow):def __init__(self):super().__init__()self.instance = vlc.Instance()self.player = self.instance.media_player_new()self.timer = QtCore.QTimer(self)self.timer.timeout.connect(self.update_ui) # 連接定時器到更新方法self.current_file = Noneself.media_loaded = Falseself.temp_files = set() #用于跟蹤臨時解密文件self.init_ui()self.init_crypto()def init_ui(self):# 主窗口設置self.setWindowTitle("視頻播控器（特別專用版）")self.resize(800, 600)# 初始化菜單menubar = self.menuBar()file_menu = menubar.addMenu("文件(&F)")crypto_menu = menubar.addMenu("安全(&S)")# 文件操作open_action = self.create_action("打開文件...", "Ctrl+O", self.open_file)# exit_action = self.create_action("退出", "Ctrl+Q", lambda: self.close()) # 播放退出太慢# 加密解密操作encrypt_action = self.create_action("加密視頻...", "Ctrl+E", self.encrypt_video)decrypt_action = self.create_action("解密視頻...", "Ctrl+D", self.decrypt_video)# 添加菜單項file_menu.addAction(open_action)file_menu.addSeparator()# file_menu.addAction(exit_action)crypto_menu.addAction(encrypt_action)crypto_menu.addAction(decrypt_action)# 創建主容器和布局central_widget = QtWidgets.QWidget(self)self.setCentralWidget(central_widget)main_layout = QtWidgets.QVBoxLayout(central_widget)main_layout.setContentsMargins(0, 0, 0, 0)# 視頻標題標簽 self.title_label = QtWidgets.QLabel("當前未選擇媒體文件")self.title_label.setAlignment(QtCore.Qt.AlignmentFlag.AlignCenter)self.title_label.setStyleSheet("font-size: 14px; color: #666; margin: 5px;")main_layout.addWidget(self.title_label)# 視頻顯示區域self.video_widget = QtWidgets.QWidget()self.video_widget.setStyleSheet("background-color: black;")main_layout.addWidget(self.video_widget, stretch=1)# 控制面板control_panel = QtWidgets.QWidget()control_layout = QtWidgets.QVBoxLayout(control_panel)# 進度條self.progress_bar = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)self.progress_bar.setMinimum(0)self.progress_bar.sliderMoved.connect(self.set_position)control_layout.addWidget(self.progress_bar)# 時間標簽self.time_label = QtWidgets.QLabel("00:00:00 / 00:00:00")control_layout.addWidget(self.time_label)# 控制按鈕button_layout = QtWidgets.QHBoxLayout()self.play_btn = QtWidgets.QPushButton("播放")self.play_btn.clicked.connect(self.toggle_play)self.stop_btn = QtWidgets.QPushButton("停止")self.stop_btn.clicked.connect(self.stop)self.open_btn = QtWidgets.QPushButton("打開文件")self.open_btn.clicked.connect(self.open_file)# 音量控制self.volume_slider = QtWidgets.QSlider(QtCore.Qt.Orientation.Horizontal)self.volume_slider.setRange(0, 100)self.volume_slider.setValue(100)self.volume_slider.valueChanged.connect(self.set_volume)# 添加控件button_layout.addWidget(self.open_btn)button_layout.addWidget(self.play_btn)button_layout.addWidget(self.stop_btn)button_layout.addWidget(QtWidgets.QLabel("音量:"))button_layout.addWidget(self.volume_slider)control_layout.addLayout(button_layout)main_layout.addWidget(control_panel)# 設置VLC渲染if sys.platform == "win32":self.player.set_hwnd(int(self.video_widget.winId()))elif sys.platform == "linux":self.player.set_xwindow(self.video_widget.winId())elif sys.platform == "darwin":from PyQt6.QtGui import QCocoaNativeContextself.player.set_nsobject(int(QCocoaNativeContext(self.video_widget.winId()).nsview()))self.timer.start(200)def init_crypto(self):"""初始化加密參數"""self.key_derivation_iterations = 100000self.salt_size = 16self.nonce_size = 16self.tag_size = 16self.chunk_size = 64 * 1024  # 64KB塊處理def create_action(self, text, shortcut, callback):"""創建標準化菜單動作"""action = QtGui.QAction(text, self)action.setShortcut(shortcut)action.triggered.connect(callback)return action        def open_file(self):# 修復1：打開文件前先停止播放if self.player.is_playing():self.player.stop()self.media_loaded = Falseself.play_btn.setText("播放")file_dialog = QtWidgets.QFileDialog(self)file_dialog.setNameFilter("視頻文件 (*.mp4 *.avi *.mkv *.mov *.flv)")if file_dialog.exec():selected_files = file_dialog.selectedFiles()if selected_files:self.load_media(selected_files[0])def load_media(self, file_path):try:# 如果是加密文件需要特殊處理if file_path.lower().endswith('.vef'):QtWidgets.QMessageBox.warning(self, "警告", "請使用菜單中的解密功能打開加密文件")return# 新增：停止定時器避免沖突self.timer.stop()# 修復2：確保徹底釋放舊媒體資源self.player.stop()self.player.set_media(None)  # 清除舊媒體引用# 重置狀態self.media_loaded = Falseself.play_btn.setText("播放")self.progress_bar.setValue(0)self.time_label.setText("00:00:00 / 00:00:00")# 加載新文件self.current_file = file_pathmedia = self.instance.media_new(file_path)self.player.set_media(media)# 更新標題file_name = os.path.basename(file_path)self.title_label.setText(f"當前播放: {file_name}")# 修復3：異步解析媒體信息（避免阻塞UI）media.parse_with_options(vlc.MediaParseFlag.network, 1000)# 設置進度條最大值self.progress_bar.setMaximum(media.get_duration())self.media_loaded = True# 顯示總時長total_time = time.strftime("%H:%M:%S", time.gmtime(media.get_duration() // 1000))self.time_label.setText(f"00:00:00 / {total_time}")# 新增：確保媒體加載完成后再啟定時器self.timer.start(200)except Exception as e:QtWidgets.QMessageBox.critical(self, "錯誤", f"無法加載文件:\n{str(e)}")self.media_loaded = Falseself.title_label.setText("媒體加載失敗")def toggle_play(self):if not self.media_loaded:self.open_file()return# 修復4：強制同步按鈕狀態if self.player.is_playing():self.player.pause()self.play_btn.setText("播放")else:self.player.play()self.play_btn.setText("暫停")# ---------- 加密解密功能 ----------def _get_encrypted_filename(self, src_path):"""生成加密文件名（原文件名+.vef）"""return src_path + ".vef"  # 直接在原文件名后追加.vefdef encrypt_video(self):"""智能加密方法：優先處理當前播放文件"""# 自動檢測當前播放文件src_path = Noneif self.current_file and os.path.exists(self.current_file):# 檢查是否已經是加密文件if not self.current_file.lower().endswith('.vef'):reply = QtWidgets.QMessageBox.question(self, '加密確認', f"是否加密當前播放的文件？\n{os.path.basename(self.current_file)}",QtWidgets.QMessageBox.StandardButton.Yes | QtWidgets.QMessageBox.StandardButton.No)if reply == QtWidgets.QMessageBox.StandardButton.Yes:src_path = self.current_file# 如果無當前可用文件，則選擇文件if not src_path:src_path, _ = QtWidgets.QFileDialog.getOpenFileName(self, "選擇要加密的視頻文件", "","視頻文件 (*.mp4 *.avi *.mkv *.mov *.flv)")if not src_path:return# 處理加密文件特殊情況if src_path.lower().endswith('.vef'):QtWidgets.QMessageBox.warning(self, "警告", "不能加密已加密文件")return# 獲取保存路徑default_name = self._get_encrypted_filename(os.path.basename(src_path))dest_path, _ = QtWidgets.QFileDialog.getSaveFileName(self, "保存加密文件", os.path.join(os.path.dirname(src_path), default_name),  # 默認原目錄"加密視頻 (*.vef)")if not dest_path:return# 獲取密碼password, ok = QtWidgets.QInputDialog.getText(self, "輸入密碼", "設置加密密碼:", QtWidgets.QLineEdit.EchoMode.Password)if not ok or not password:return# 執行加密流程try:# 如果是當前播放文件，停止播放was_playing = Falseif src_path == self.current_file:was_playing = self.player.is_playing()self.player.stop()self.media_loaded = Falseself._encrypt_file(src_path, dest_path, password)# 成功提示msg = f"加密成功！\n原文件: {os.path.basename(src_path)}\n加密文件: {os.path.basename(dest_path)}"QtWidgets.QMessageBox.information(self, "完成", msg)# 如果加密的是當前文件，詢問是否加載加密文件if src_path == self.current_file:choice = QtWidgets.QMessageBox.question(self, "加載文件", "是否立即加載加密后的文件？",QtWidgets.QMessageBox.StandardButton.Yes | QtWidgets.QMessageBox.StandardButton.No)if choice == QtWidgets.QMessageBox.StandardButton.Yes:self.load_media(dest_path)except Exception as e:self.show_error(f"加密失敗: {str(e)}")finally:# 恢復原始狀態（如果需要）if was_playing and src_path != dest_path:self.load_media(src_path)def _encrypt_file(self, src_path, dest_path, password):"""執行文件加密（新增）"""try:# 生成加密參數salt = secrets.token_bytes(self.salt_size)key = hashlib.pbkdf2_hmac('sha256',password.encode('utf-8'),salt,self.key_derivation_iterations,dklen=32)cipher = AES.new(key, AES.MODE_GCM)cipher.update(salt)# 分塊加密with open(src_path, 'rb') as fin, open(dest_path, 'wb') as fout:# 寫入加密頭fout.write(salt)fout.write(cipher.nonce)while True:chunk = fin.read(self.chunk_size)if not chunk:breakencrypted = cipher.encrypt(pad(chunk, AES.block_size))fout.write(encrypted)# 寫入認證標簽fout.write(cipher.digest())except PermissionError:raise RuntimeError("文件被其他程序占用，請關閉后重試")except Exception as e:raise RuntimeError(f"加密失敗: {str(e)}")def _get_decrypted_filename(self, src_path):"""生成解密文件名（去除.vef后綴）"""if src_path.lower().endswith('.vef'):return src_path[:-4]  # 去除.vefreturn src_path + "_decrypted"def decrypt_video(self):"""增強型解密方法"""try:# 選擇加密文件src_file, _ = QtWidgets.QFileDialog.getOpenFileName(self, "選擇要解密的文件", "", "加密視頻 (*.vef)")if not src_file:return# 生成默認保存路徑default_path = self._get_decrypted_filename(src_file)dest_file, _ = QtWidgets.QFileDialog.getSaveFileName(self, "保存解密文件",default_path,  # 默認原目錄+去后綴"視頻文件 (*.*)")if not dest_file:return# 檢查文件是否已存在if os.path.exists(dest_file):reply = QtWidgets.QMessageBox.question(self, "文件存在",f"目標文件已存在，是否覆蓋？\n{dest_file}",QtWidgets.QMessageBox.StandardButton.Yes | QtWidgets.QMessageBox.StandardButton.No)if reply != QtWidgets.QMessageBox.StandardButton.Yes:return# 獲取密碼password, ok = QtWidgets.QInputDialog.getText(self, "輸入密碼", "解密密碼:", QtWidgets.QLineEdit.EchoMode.Password)if not ok or not password:return# 執行解密decrypted_path = self._decrypt_file(src_file, password, dest_file)if decrypted_path:QtWidgets.QMessageBox.information(self, "成功", f"文件解密成功！\n保存路徑: {decrypted_path}")self.load_media(decrypted_path)except Exception as e:self.show_error(f"解密失敗: {str(e)}")def _decrypt_file(self, src_path, password, dest_path):"""增強型解密方法（保存到指定路徑）"""try:with open(src_path, 'rb') as fin:salt = fin.read(self.salt_size)nonce = fin.read(self.nonce_size)key = self._derive_key(password, salt)cipher = AES.new(key, AES.MODE_GCM, nonce=nonce)cipher.update(salt)with open(dest_path, 'wb') as fout:encrypted = fin.read()ciphertext, tag = encrypted[:-self.tag_size], encrypted[-self.tag_size:]# 分塊解密寫入chunk_size = self.chunk_size + AES.block_sizefor i in range(0, len(ciphertext), chunk_size):chunk = ciphertext[i:i+chunk_size]decrypted = unpad(cipher.decrypt(chunk), AES.block_size)fout.write(decrypted)# 驗證標簽cipher.verify(tag)return dest_pathexcept ValueError as ve:# 清理已寫入的部分文件if os.path.exists(dest_path):try:os.remove(dest_path)except:passraise ValueError("解密失敗 - 密碼錯誤或文件損壞") from veexcept Exception as e:if os.path.exists(dest_path):try:os.remove(dest_path)except:passraise RuntimeError(f"解密過程錯誤: {str(e)}") from edef _derive_key(self, password, salt):"""生成加密密鑰"""return hashlib.pbkdf2_hmac('sha256',password.encode('utf-8'),salt,self.key_derivation_iterations,dklen=32  # AES-256需要32字節密鑰)# ---------- 輔助功能 ----------def show_error(self, message):"""顯示錯誤提示"""QtWidgets.QMessageBox.critical(self, "錯誤", message)def closeEvent(self, event):"""關閉處理，清理臨時文件"""for temp_file in self.temp_files:try:if os.path.exists(temp_file):os.remove(temp_file)except Exception as e:print(f"刪除臨時文件失敗: {str(e)}")self.player.stop() # 停止播放器event.accept()  # def stop(self):self.player.stop()self.progress_bar.setValue(0)self.time_label.setText("00:00:00 / 00:00:00")self.play_btn.setText("播放")self.title_label.setText("播放已停止")def set_volume(self, value):self.player.audio_set_volume(value)def set_position(self, value):if self.player.is_seekable():self.player.set_position(value / self.progress_bar.maximum())def update_ui(self):if not self.media_loaded:return  # 新增：防止在無媒體時更新media_length = self.player.get_length()if media_length > 0:current_time = self.player.get_time()# 新增：檢測播放結束if current_time >= media_length - 500:  # 留50ms容差self.stop()returnself.progress_bar.setMaximum(media_length)self.progress_bar.setValue(current_time)total_time = time.strftime("%H:%M:%S", time.gmtime(media_length // 1000))current_time_str = time.strftime("%H:%M:%S", time.gmtime(current_time // 1000))self.time_label.setText(f"{current_time_str} / {total_time}")if __name__ == "__main__":app = QtWidgets.QApplication(sys.argv)player = VLCPlayer()player.show()sys.exit(app.exec())