如何动态更新urwid.Text组件？Spotify TUI播放器开发疑问

核心思路 #

Spotify Web API没有提供播放状态变化的实时推送机制，所以我们需要通过定时轮询检测当前播放曲目，同时要保留Urwid文本组件的引用，才能在曲目变化时动态更新界面内容。

步骤1：修改播放曲目组件，保留文本对象引用 #

原来的playing_track_widget只返回组件，现在需要同时返回用于显示的Text对象，方便后续更新内容：

# lower part of the screen
def playing_track_widget(sp, playing_track):
    text_object = urwid.Text(playing_track)
    text_filler = urwid.Filler(text_object, 'bottom')
    frame = urwid.Frame(text_filler, footer=None)
    # 返回组件和文本对象，便于后续更新
    return frame, text_object

步骤2：编写曲目更新检测函数 #

这个函数负责获取当前播放曲目，对比上次的内容，若有变化则更新文本组件：

def update_playing_track(sp, text_widget, last_track):
    current_track = get_current_playing_track(sp)
    if current_track != last_track:
        text_widget.set_text(current_track)
        return current_track
    return last_track

步骤3：整合定时轮询到主循环 #

在run_tui中，我们需要利用Urwid的set_alarm_in方法设置定时任务，周期性触发更新：

# main function for TUI
def run_tui(tracks, sp):
    liked_tracks = urwid.Padding(convert_to_ListBox(u'Liked Tracks', tracks.values(), sp), left=2, right=2)

    # 初始化当前播放曲目
    current_track = get_current_playing_track(sp)

    # 获取播放组件和对应的文本对象
    lower_part, playing_text_widget = playing_track_widget(sp, current_track)

    # 收藏曲目组件
    right_part = liked_tracks_widget(liked_tracks, sp)

    columns = urwid.Columns([
        ('weight', 1, lower_part),
        ('weight', 1, right_part)
        ], dividechars=1)

    main_loop = urwid.MainLoop(columns, unhandled_input=unhandled_input)

    # 定时更新回调
    def update_loop(_loop, _data):
        nonlocal current_track
        # 更新曲目并保存最新状态
        current_track = update_playing_track(sp, playing_text_widget, current_track)
        # 每隔2秒再次执行更新（可根据需求调整间隔）
        _loop.set_alarm_in(2, update_loop)

    # 立即启动第一次更新
    main_loop.set_alarm_in(0, update_loop)

    main_loop.run()

注意事项 #

• 轮询间隔建议设为2-5秒，避免触发Spotify Web API的调用限额（免费版有请求次数限制）。
• nonlocal关键字用于在嵌套函数中修改外部函数的current_track变量，确保每次更新都能对比上一次的曲目状态，避免不必要的界面刷新。
• 如果你的TUI仅针对特定平台（如Linux），也可以尝试监听本地Spotify客户端的D-Bus事件来实现实时更新，比轮询更高效，但通用性会降低。

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