本教程详细介绍了如何使用python的tkinter和tkvideoplayer库创建一个功能完善的全屏视频播放器，支持从指定文件夹加载视频并自动按序播放。文章重点讲解了正确管理视频文件路径、高效使用python迭代器来构建和控制播放列表，以及如何通过事件绑定实现视频间的无缝切换，解决常见的播放顺序问题。
1. 核心库与概念
在构建此视频播放器时，我们主要依赖以下Python库：
- tkinter: Python的标准GUI（图形用户界面）库，用于创建应用程序的用户界面。
- tkVideoPlayer: 一个强大的Tkinter扩展库，专门用于在Tkinter窗口中播放视频文件。
- os: Python的内置模块，用于与操作系统进行交互，特别是文件系统操作，如遍历目录和拼接文件路径。
- functools: 提供高阶函数，如partial，它允许我们为事件绑定函数传递额外的参数。
2. 播放器框架搭建
首先，我们需要设置Tkinter主窗口并初始化tkVideoPlayer组件。为了提供沉浸式的观看体验，我们将播放器窗口配置为全屏无边框模式。
import functools
import tkinter as tk
from tkVideoPlayer import TkinterVideo
import os
if __name__ == "__main__":
root = tk.Tk()
# 获取屏幕宽度和高度，设置窗口为全屏
screen_width = root.winfo_screenwidth()
screen_height = root.winfo_screenheight()
root.geometry(f"{screen_width}x{screen_height}+0+0")
# 移除窗口的标题栏和边框，实现全屏无边框效果
root.overrideredirect(True)
# 初始化tkVideoPlayer组件
# master=root 指定父窗口，scaled=True 确保视频内容自动适应播放器尺寸
videoplayer = TkinterVideo(master=root, scaled=True)
videoplayer.pack(expand=True, fill="both") # 使播放器组件填充整个窗口
# ... 后续代码将在此处添加 ...
root.mainloop()root.overrideredirect(True) 是实现无边框全屏的关键，它将窗口装饰（如标题栏、边框）移除。
3. 构建与管理视频播放列表
一个功能完善的视频播放器必须能够识别并按顺序播放多个视频文件。这涉及两个关键步骤：从指定目录收集视频文件，以及使用迭代器高效管理播放顺序。
立即学习“Python免费学习笔记（深入）”；
3.1 收集视频文件路径
在从文件系统加载视频时，确保提供的是视频文件的完整绝对路径至关重要。如果只提供文件名，tkVideoPlayer将无法找到文件。我们使用os.walk遍历指定目录及其子目录，并利用os.path.join来构建每个视频文件的完整路径。同时，为了确保只添加视频文件，我们可以根据文件扩展名进行过滤。
# 视频文件所在的根目录
# 注意：在Windows上，路径分隔符通常是反斜杠，建议使用双反斜杠或原始字符串
origem = "C:\Python\Estudos\Videos"
lista = [] # 用于存储视频完整路径的列表
# 遍历指定目录及其子目录，收集所有视频文件的完整路径
for root_dir, _, files in os.walk(origem):
for file_name in files:
# 确保只添加常见的视频文件类型
if file_name.lower().endswith(('.mp4', '.avi', '.mov', '.mkv', '.flv')):
lista.append(os.path.join(root_dir, file_name)) # 使用os.path.join构建完整路径3.2 迭代器与播放顺序控制
Python的迭代器（通过iter()函数创建，通过next()函数获取下一个元素）是管理播放列表的理想工具。它们允许我们按需获取序列中的下一个元素，而无需手动管理索引。
关键修正点：
- 单次迭代器初始化： playlist = iter(lista) 应该只被调用一次，且位于首次使用next()之前。如果在播放第一个视频前再次调用iter(lista)，会重置迭代器，导致第一个视频之后无法正确播放第二个视频。
- 首次视频加载： 第一个视频也应通过 next(playlist, None) 来加载，这样迭代器会从列表的第一个元素开始，并正确地前进到下一个元素，确保后续视频的顺序播放。
# ... (前面的导入和框架代码) ...
# 初始化播放列表迭代器，确保只初始化一次
playlist = iter(lista)
# 首次加载视频：从迭代器中获取第一个视频
first_video = next(playlist, None)
if first_video: # 检查播放列表是否为空
load_v(first_video)
play_v()
else:
print(f"在目录 '{origem}' 中未找到任何视频文件。请检查路径和文件。")
root.quit() # 如果没有视频，则退出应用
# ... (后续事件绑定代码) ...4. 实现视频播放逻辑
视频播放的核心逻辑包括加载视频、播放视频以及在当前视频播放结束后自动切换到下一个视频。
4.1 视频加载与播放函数
为了代码的模块化和可读性，我们将视频的加载和播放操作封装成独立的函数。
def load_v(video_path):
"""加载指定路径的视频文件。"""
videoplayer.load(video_path)
print(f"加载视频: {video_path}")
def play_v():
"""播放当前加载的视频。"""
videoplayer.play()
print("开始播放。")4.2 自动播放下一个视频
tkVideoPlayer会在视频播放结束时触发 <<Ended>> 事件。我们可以绑定一个函数到这个事件，以实现自动播放列表中的下一个视频。
def play_next_video(event, videoplayer_instance, playlist_iterator):
"""
当当前视频播放结束时，加载并播放播放列表中的下一个视频。
event: Tkinter事件对象（通常不需要直接使用）。
videoplayer_instance: TkinterVideo的实例。
playlist_iterator: 视频播放列表的迭代器。
"""
next_video = next(playlist_iterator, None) # 尝试从迭代器中获取下一个视频
if not next_video:
print("播放列表已结束，所有视频播放完毕。")
# 播放列表结束后，可以选择退出应用、循环播放或显示结束信息
# root.quit() # 例如：播放完毕后退出应用程序
return
load_v(next_video)
play_v()这里使用了 functools.partial 来将 videoplayer 实例和 playlist 迭代器作为额外参数传递给事件处理函数 play_next_video。
# ... (前面的播放器初始化和首次视频加载代码) ...
# 绑定视频播放结束事件，当视频播放完毕时，自动调用play_next_video函数
# functools.partial 用于将额外的参数 (videoplayer实例和playlist迭代器) 传递给事件处理函数
videoplayer.bind("<<Ended>>", functools.partial(play_next_video, videoplayer_instance=videoplayer, playlist_iterator=playlist))
# 添加一个按键事件来退出全屏或应用程序 (例如：按ESC键退出)
def exit 
