python-vlc 视频播放器跑马灯（Marquee）文本叠加功能实现指南

import vlc

# 推荐使用 --sub-source=marq
# instance = vlc.Instance("--sub-source=marq")
# 或者
instance = vlc.Instance("--no-xlib --quiet --sub-source=marq") 
# --no-xlib 和 --quiet 是可选参数，用于在无X服务器环境或减少日志输出

player = instance.media_player_new()

# 启用跑马灯
player.video_set_marquee_int(vlc.VideoMarqueeOption.Enable, 1) # 或 player.video_set_marquee_int(0, 1)

# 设置字体大小为 48 像素
player.video_set_marquee_int(vlc.VideoMarqueeOption.Size, 48)  # 或 player.video_set_marquee_int(6, 48)

# 设置位置为底部
player.video_set_marquee_int(vlc.VideoMarqueeOption.Position, 8) # 或 player.video_set_marquee_int(4, 8)

# 设置超时为 0，即永久显示
player.video_set_marquee_int(vlc.VideoMarqueeOption.Timeout, 0) # 或 player.video_set_marquee_int(7, 0)

# 设置跑马灯文本
player.video_set_marquee_string(vlc.VideoMarqueeOption.Text, '初始跑马灯文本') # 或 player.video_set_marquee_string(1, '初始跑马灯文本')

# 这会导致 NameError
player.video_set_marquee_string(VideoMarqueeOption.Text, "Some Text")

# 方法一：使用 vlc.VideoMarqueeOption 枚举 (推荐)
player.video_set_marquee_string(vlc.VideoMarqueeOption.Text, "Some Text")

# 方法二：使用对应的数值常量
player.video_set_marquee_string(1, "Some Text")

import vlc
import time
import sys

# 假设视频文件路径为 "path/to/your/video.mp4"
# 请替换为你的实际视频文件路径
VIDEO_PATH = "/home/rolf/BBB.ogv" # 示例路径

# 1. 初始化 VLC 实例并启用跑马灯子源
# --no-xlib: 在没有X服务器的系统上可能需要
# --quiet: 减少控制台输出
# --sub-source=marq: 启用跑马灯功能
instance = vlc.Instance('--no-xlib --quiet --sub-source=marq')

# 2. 创建媒体播放器
player = instance.media_player_new()

# 3. 创建媒体对象并设置给播放器
try:
    media = instance.media_new(VIDEO_PATH)
except Exception as e:
    print(f"Error loading media: {e}")
    print("Please ensure VIDEO_PATH is correct and the file exists.")
    sys.exit(1)

player.set_media(media)

# 4. 配置跑马灯属性
# 启用跑马灯
player.video_set_marquee_int(vlc.VideoMarqueeOption.Enable, 1) # 或使用 0
# 设置字体大小为 48 像素
player.video_set_marquee_int(vlc.VideoMarqueeOption.Size, 48)  # 或使用 6
# 设置位置为底部 (例如 8)
player.video_set_marquee_int(vlc.VideoMarqueeOption.Position, 8) # 或使用 4
# 设置超时为 0，即永久显示（直到手动更改或禁用）
player.video_set_marquee_int(vlc.VideoMarqueeOption.Timeout, 0) # 或使用 7

# 5. 设置初始跑马灯文本
player.video_set_marquee_string(vlc.VideoMarqueeOption.Text, '欢迎使用 python-vlc 播放器') # 或使用 1

# 6. 开始播放视频
player.play()

# 7. 模拟动态更新跑马灯文本
print("视频开始播放，跑马灯文本将动态更新...")
for iter_count in range(45):
    if iter_count == 15:
        # 在播放约 7.5 秒后更新文本
        player.video_set_marquee_string(vlc.VideoMarqueeOption.Text, "跑马灯文本更新中...")
        print("文本更新至：跑马灯文本更新中...")
    if iter_count == 30:
        # 在播放约 15 秒后再次更新文本
        player.video_set_marquee_string(vlc.VideoMarqueeOption.Text, "最终跑马灯文本")
        print("文本更新至：最终跑马灯文本")
    time.sleep(0.5) # 每 0.5 秒检查一次

# 8. 停止播放器并释放资源
player.stop()
print("播放结束。")