python-vlc 如何在播放结束后编程关闭播放器窗口且不退出整个应用

问题根因 #

MediaPlayerEndReached事件的回调函数运行在VLC内部的事件处理线程中，回调执行时VLC本身还持有播放器实例的操作锁，此时在回调内直接调用stop()、release()系列方法会触发锁等待，形成死锁，导致资源无法释放、播放器窗口无法关闭。

修复方案 #

将资源释放逻辑从VLC的回调线程转移到主线程执行，回调仅负责标记播放结束状态，避免线程锁冲突。修改后的可运行代码如下：

import vlc
import time

VIDEO_PATH = "/path/to/video.mp4"
play_finished = False

def end_callback(event):
    global play_finished
    print("End of playing reached")
    play_finished = True

def play():
    global play_finished
    vlc_instance = vlc.Instance(["--no-xlib"])
    media_player = vlc.MediaPlayer(vlc_instance, VIDEO_PATH)

    # 绑定结束事件
    event_manager = media_player.event_manager()
    event_manager.event_attach(vlc.EventType.MediaPlayerEndReached, end_callback)
    
    media_player.play()
    # 轮询检测播放状态
    while not play_finished:
        time.sleep(0.2)
    
    # 主线程内执行资源释放，无死锁问题
    media_player.stop()
    media = media_player.get_media()
    if media:
        media.release()
    media_player.release()
    vlc_instance.release()
    # 重置标志位，方便多次调用play方法
    play_finished = False

play()

input("press Enter to exit")

方案说明 #

• 未使用sys.exit，不会终止整个应用进程，你可以在play方法执行完成后继续运行其他业务逻辑
• 兼容你提供的所有测试环境版本，无额外依赖
• 如果需要支持多次播放视频，仅需要复用上述逻辑即可，不需要额外调整

内容的提问来源于stack exchange，提问作者Aidin