docs(plans): 下发 K27.1 中心按钮口径

This commit is contained in:
Zhou Weidong authored and trae-solo-agent committed 2026-10-19 16:48:46 +08:00
1 parent 7801fad1b5
commit 80a3b27353
1 file changed
+25
+25
View File
@@ -20,6 +20,31 @@
---
## [待处理] 2026-10-19 | K27.1 中心按钮改口径:播放中不显示,仅暂停时显示播放按钮
**用户指令(2026-10-19,原文)**:
> 「播放按钮不用显示啊 就点击暂停的时候显示」
**口径(覆盖 K27 第三节,其余不变)**
- 播放中:**不显示任何中心按钮**;点击画面 = 暂停(点一下暂停)。
- 暂停后:中心显示播放按钮(Key 沿用 `player-play-toggle`,`playing: false`),点击或再点画面 = 播放;播放开始后按钮立即消失。
- 首页沉浸 feed 同步:暂停时显示中心播放按钮 `home-feed-center-play`,播放中不显示;点画面仍是播放/暂停切换。
- 清屏状态下中心按钮一并隐藏;点画面先恢复控制层,不改变播放态。
- 不引入任何定时器;控制层仍然常驻。
**实现要点**
1. `_PlaybackOverlay`:把 `if (widget.playing) PlayerCenterToggle(playing: true)` 改为 `if (!widget.playing) PlayerCenterToggle(playing: false, onTap: widget.onTogglePlay)`。
2. `_onVideoTap`:控制层可见时直接 `widget.onTogglePlay()`;清屏时只恢复控制层。
3. `player_view.dart` 首页分支:恢复暂停态中心播放按钮(`home-feed-center-play` → `setUserWantsPlay(true)`),播放态不渲染;PiP/清屏时不渲染。
4. 测试更新:
- 播放中 `player-play-toggle` 不存在;点画面后视频暂停且按钮出现;点按钮后恢复播放且按钮消失。
- 首页暂停后 `home-feed-center-play` 出现,播放后消失。
- 清屏隐藏中心按钮,点画面恢复控制层。
- `pump` 5 秒控件仍在。
5. 门禁/分支/提交规范同 K27:从 `develop` 拉 `fix/flutter-paused-play-toggle`,`dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`,`--no-ff` 合回 develop 并 push,作者 `Zhou Weidong <502333560@qq.com>`,PROGRESS 留痕;真机验收由用户执行。
---
## [已完成·待用户验收] 2026-10-19 | K27 播放器控制层交互重做:清屏按钮 + 取消自动隐藏 + 暂停按钮即时消失
**用户指令(2026-10-19,原文)**: