树莓派中python-vlc设为全屏仍以原生分辨率播放如何解决？

• Raspberry Pi 4 B
• Python 3.11.2
• python-vlc 3.0.20123

问题 #

视频在屏幕左上角打开，无窗口边框但未全屏显示，仅使用原生vlc播放器，初始化代码为：

MEDIA_PLAYER = vlc.MediaPlayer()

解决方案 #

方法1：直接调用全屏API #

初始化播放器后，在播放前设置全屏属性：

import vlc

MEDIA_PLAYER = vlc.MediaPlayer()
# 加载目标视频
media = vlc.Media("你的视频文件路径.mp4")
MEDIA_PLAYER.set_media(media)
# 开启全屏
MEDIA_PLAYER.set_fullscreen(True)
# 启动播放
MEDIA_PLAYER.play()

方法2：指定RPi帧缓冲窗口句柄 #

如果直接设置全屏无效，可强制绑定到Raspberry Pi的帧缓冲根窗口：

import vlc

MEDIA_PLAYER = vlc.MediaPlayer()
# 绑定到帧缓冲根窗口（句柄为0）
MEDIA_PLAYER.set_xwindow(0)
MEDIA_PLAYER.set_fullscreen(True)
# 加载并播放视频
media = vlc.Media("你的视频文件路径.mp4")
MEDIA_PLAYER.set_media(media)
MEDIA_PLAYER.play()

方法3：通过实例参数强制全屏 #

初始化vlc实例时直接传入全屏参数，默认以全屏模式启动：

import vlc

# 创建带全屏参数的vlc实例
instance = vlc.Instance("--fullscreen", "--no-window-decorations")
MEDIA_PLAYER = instance.media_player_new()
# 加载并播放视频
media = instance.media_new("你的视频文件路径.mp4")
MEDIA_PLAYER.set_media(media)
MEDIA_PLAYER.play()

额外提示 #

• 确保Raspberry Pi的显示分辨率已设置为屏幕原生尺寸，可通过raspi-config工具调整
• 若在无桌面的命令行环境运行，需保证vlc使用帧缓冲输出，避免依赖X11服务

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