`Video` 控件 API 已废弃

INFO

本指南以 Flet 0.85.0 为准，内容是最准确的。后续版本可能会新增 API 或增加额外的迁移路径。

破坏性变更与废弃索引列出了为每个版本编写的指南。

概述

Flet 0.85.0 废弃了 Video.show_controls、Video.playlist_add() 和 Video.playlist_remove()。

请使用 [Video.controls][flet_video.Video.controls] 来配置或隐藏视频控件。用标准列表方法直接修改 [Video.playlist][flet_video.Video.playlist]。

Video.controls 为内置和自定义视频控件提供了一个统一的配置点。它还通过把值设为 None 来支持旧的隐藏控件行为。

播放列表现在成为视频项的唯一来源。直接修改列表能保持 API 与其他基于列表的 Flet 控件一致。

迁移前代码：

python

video = ft.Video(
    playlist=[media],
    show_controls=False,
)

迁移后代码：

python

video = ft.Video(
    playlist=[media],
    controls=None,
)

迁移前代码：

python

video.playlist_add(media)
video.playlist_remove(media_index)

迁移后代码：

python

video.playlist.append(media)
video.playlist.pop(media_index)
video.update()

当修改发生在控件已经被添加到页面之后，调用 video.update()。