lxh2875931338/QingTing-Player
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
110 Commits 3 Branches 0 Tags
ca4546871c6d363e1ac59e4c914882fa2d2ecd57
Commit Graph
52 Commits
Author SHA1 Message Date
lxh2875931338 ca4546871c fix(playback): 位置回退保护 + 恢复用最后已知位置 + 缓冲感知重试 
对应 10/24 日志里的"播到一半中断后从头重播"：
  23:05:26 ffurl_read -> 从 77s 重连成功
  23:05:33 再断 -> position 归 0 -> 看门狗"从 0s 继续"，听感就是重新开始

- 新增 _lastKnownPosition：位置流累积，切歌归零；
  所有恢复路径（看门狗 / 网络切换 / 打开失败）都用它续播
- 位置回退保护（抽成 utils/position_guard.dart）：
  已播 >10s 且新位置 <5s 时忽略回退，除非用户 seek / 切歌 / 正在恢复
- _scheduleOpenRetry 改为缓冲感知：
  缓冲余量 >=12s 时延迟 4s 重试（不打断），否则 1.2s；
  重试前若位置已推进超过 1s，判定 mpv 自愈，取消重连
- 收藏列表点击改为整队入队（setQueue，从点击项开始）

测试：新增 position_guard 6 个用例，累计 25 个全绿。
真机验证：收藏整队日志 "17 首，从第 16 首开始"，播放正常。
 2026-10-31 21:22:56 +08:00
lxh2875931338 18308d9d4e feat(metadata): 元数据分阶段探测（128KB → 512KB）+ song_key 改为纯 URL 
渐进探测：
- FileProvider.getFile 增加 maxBytes 参数，WebDAV 按需只取头部
- MetadataService 先取 128KB 读标签；title/artist 都为空时再补到 512KB
- 缓存文件按上限区分（metadata_<hash>_128k.part / _512k.part）

song_key：
- 从 md5(url|size) 改为 md5(url)。分阶段探测的大小不同，
  带 size 会让同一首歌产生两个键；URL 在各阶段稳定。
- 代价：同 URL 换内容不自动失效，由清除单曲缓存/forceRefresh 兜底
- 数据库升到 v6，清空 songs / metadata_cache（可再生）

验证（release，真机）：
  📦 取头部 128KB（上限 128KB，不再整文件下载）
  🧭 状态机: first_seen → pending（validations=1）
  📊 pending conf=0.92 evidence={...}
  ✅ saved: 两生关 - 谢安琪

测试：新增 song_key 3 个用例，累计 19 个全绿。
 2026-10-24 20:28:50 +08:00
lxh2875931338 9f53d1c604 fix(playback): 打开失败后 1.5s 立即重试，切歌前摇从 ~20s 降到 ~7s 
实测时间线（20:08:53 那次切歌）：
  53.881 next -> play
  53.947 open 完成 65ms
  59.525 player error: tcp ffurl_read / Failed to open   （mpv 5.6s 后放弃）
  09:13.801 起播看门狗才触发重连                        （又等 14s）

原因：看门狗 5s 一跳、阈值 10s，最坏要两个 tick 才触发。

- error 流里识别 Failed to open / ffurl_read，1.5s 后立即重试一次
  （每首歌最多一次，force 模式跳过节流）
- 进度看门狗 tick 10s -> 5s，任何卡死最多多等 5s

预期：失败发生在 5~6s，重试在 7~8s 开始，前摇 ~10s 降到 7~8s；
若首次打开成功则完全无感。
 2026-10-24 20:14:31 +08:00
lxh2875931338 98db2321fb fix(playback): 冷启动不再预加载音频，首次播放按保存进度打开 
按今日日志定位：所谓"后台假死"其实是进程被系统回收
（13:14:46 ActivityManager: has died: prcp FGS，当时内存压力下批量杀进程）。
冷启动后旧代码会先联网 play→seek→pause，既慢又会和用户点播放打架。

- restorePlaybackState: 只恢复队列/进度/UI，不联网，不再调用 _loadRestoredPlayback
- 新增 playOrResume(): UI 按钮、通知栏、耳机键统一入口；
  冷启动首次播放走 _playCurrent（open + seek 到保存位置 + play）
- AudioPlayerHandler.play() 改走 playOrResume()
- 播放中每 10s 持久化一次进度，冷启动恢复更准确
- 窗口期收紧：网络轮询 10s→3s、切换去抖 3s→2s、
  起播看门狗 15s→10s、中段卡死 30s→20s

真机验证（release）：
  冷启动 8s 内 play 调用 0 次（不再预加载）
  按键播放：冷启动首次播放 → open 21ms → restored position 15.751s → 1.5s 出声
 2026-10-24 20:04:42 +08:00
lxh2875931338 af895c18e1 fix(metadata): 元数据回退到文件名时，在 80% 处重试一次 
云服日志显示：对 /dav/.../*.flac 的 Range GET 在 10.3s 后返回 502，
是反代等待上游首包超时（清远源站响应慢），与我方 15s 超时无关。
影响仅限该曲的标签/封面，播放不受影响，但会一直回退文件名。

- _loadMetadataForCurrentSong: source == 'filename' 时置 _metadataNeedsRetry
- 播放到 80% 且该曲未重试过 → 再抓一次（每首歌最多一次）
- 因"播放未稳定"被跳过抓取的情况也标记为待重试
- 换歌时清空标记
 2026-10-23 23:11:39 +08:00
lxh2875931338 2d571eaae4 feat(playback): 下一首预热（60% 时 HEAD 预握手） 
日志实测：open 完成仅 37~60ms，但起播耗时 2.1~2.8s，
说明等待发生在 mpv 拿首批数据，而不是建连。

- 新增 PrefetchService：HEAD + Range 0-0，只走 DNS/TLS/反代，
  不下载正文；失败静默，不影响播放
- AudioService 在进度达到 60%（且时长 > 60s）时预热下一首，
  每首歌只触发一次；shuffle 模式下按当前随机索引推算

待验证：播到 60% 时应出现
  🔥 [AudioService] 预热下一首：xxx
  🔥 [Prefetch] 预热完成 xxxms，status=200/206
对比下一首的 "起播耗时" 是否下降。
 2026-10-23 23:06:18 +08:00
lxh2875931338 111369c20c feat(playback): 起播看门狗 + 起播耗时打点 
现象（Plastic Love）：state=PLAYING、position 恒为 0，75 秒内没有任何
buffering/error 日志，mpv 既不报错也不推进。通用看门狗要求"近期有缓冲"，
因此完全没反应。

- 新增起播看门狗：position 持续为 0 超过 15s 且 playing=true → 强制重连
  （不再要求 buffering 事件；暂停时 playing=false，不会误触发）
- 中段卡死判定也放宽为 playing || recentlyBuffering
- 打点：
  * PlaybackService: "open 完成 xxxms，play 完成 xxxms"
  * AudioService: "起播耗时 xxxms（open 完成 -> 出声）"
  下次再出现"下一首很久"，日志能直接区分是 open 慢还是数据到得慢。
 2026-10-23 21:55:13 +08:00
lxh2875931338 b517c75cdd feat(playback): 网络切换后自动重连当前歌曲 
mpv 的 HTTP 长连接不会跟随网络迁移：换 Wi-Fi / Wi-Fi<->移动数据
会换掉出口 IP，旧连接失效但不一定报错，表现为进度停住、一直缓冲。

- 新增 NetworkWatcher：每 10s 枚举 IPv4 接口，签名变化即视为网络切换
  （不依赖插件和额外权限，也能覆盖"同类型网络换 AP"的情况）
- AudioService 收到变化后 3s 去抖，然后强制重连当前歌曲并 seek 回原位置
  （force 参数跳过 2 分钟节流，因为这是明确的外部事件）

真机验证（公网链路 + 移动数据）：
  21:43:23.123  检测到网络变化
  21:43:26.124  主动重连（3s 去抖）
  21:43:26.289  自动恢复完成（165ms）
  随后 position 35.5s -> 41.7s 正常推进
 2026-10-23 21:44:55 +08:00
lxh2875931338 937bcdd63d fix(playback): 缓冲抖动下看门狗失效 + 元数据改到播放稳定后再抓 
实测（公网链路，自然播完 -> 自动下一首）暴露两个新问题：

1. 看门狗在 buffering 抖动时永远不触发
   原实现每次 buffering=true 都重置 30s 计时器，而弱网下它会 true/false
   每 2~5s 抖一次，于是计时器一直被重置，卡死 60s+ 也不会自愈。
   改为记录"最近一次缓冲时间"，用「进度 30s 未推进 + 20s 内发生过缓冲」
   两个条件判定，暂停时不会误触发。

2. 元数据抓取在起播瞬间抢带宽
   新歌 open 后 mpv 还在持续填缓冲，此时插入 2MB 标签下载会把缓冲打回 0。
   实测下一首因此要等 60s+。
   改为等播放真正稳定（进度 >= 5s 且连续 2s 不在 buffering，最多等 30s）
   再抓元数据；等不到就跳过本次（下次播放再试），优先保证出声。

验证：公网 + 移动数据下切歌，next 发起后 2ms 即 open；
未稳定时日志出现"播放未稳定，跳过本次元数据抓取"，不再有 2MB 下载与播放抢带宽。
 2026-10-23 21:35:40 +08:00
lxh2875931338 2b33c17aab fix(playback): 增加进度看门狗，兜住不产生 buffering 事件的半开连接 
公网链路实测（清远->华为云->香港CN2->openresty->OpenList HTTPS）中
出现过 tcp: ffurl_read 错误但未触发 buffering=true 的情况，
仅靠缓冲事件无法覆盖这类"连接半死"的卡顿。

- 每 10s 检查一次播放进度；播放中且 30s 未推进 → 触发自愈（重开 + seek 回原位）
- 切歌中/暂停时重置基准，避免误触发
- 与 buffering 看门狗共用 2 分钟节流

验证：公网路径连续播放 65s，无 false positive，进度正常推进。
 2026-10-23 21:18:02 +08:00
lxh2875931338 9e58d52678 fix(playback): 修复切歌永久假死，并让元数据抓取不再抢播放带宽 
问题（后台播一段时间后无法缓冲，点下一首也没反应，只能重启）：
1. _isChangingTrack 是没有超时的锁：_playCurrent() 置 true 后，
   只有走完 finally 才会清。mpv 的 open() 在弱网下可能挂很久，
   锁就一直不释放，之后 next()/previous() 全被静默拒绝。
2. 元数据用 dio.download 整文件下载，和 mpv 流式播放抢带宽，
   20Mbps FRP 下播放流只剩一两百 K/s，缓冲长期为 0。
3. 没有订阅 mpv 的 error/buffering，失败无感知、无法自愈。

改动：
- playback_service: open 20s / 控制命令 5s 超时；失败时 stop 回空闲并上抛异常
- audio_service:
  * 去掉「正在切歌就拒绝」的逻辑，改为 latest-wins（epoch 校验，
    旧请求自行放弃，只有最新请求解锁）
  * 播放失败不再吞掉：记录 lastPlaybackError 并 notifyListeners
  * 订阅 stream.error / stream.buffering
  * 缓冲超过 30s 自动重连当前歌曲并 seek 回原位置（2 分钟内最多一次）
- file_provider: 元数据改为 Range 只取头部 2MB，流式写入并在切歌时取消上一请求
- home_page: 去掉重复的 PlaybackService().play()（同一首歌会被 open 两次），
  登录校验提前

验证：dart analyze 无 error；gradlew assembleDebug BUILD SUCCESSFUL。
真机验证待设备重新连接后进行。
 2026-10-23 21:04:45 +08:00
lxh2875931338 46a9add5cb build+fix: debug 包独立为 .dev，并修复元数据缓存永远查不到 
包名：
- debug 使用 com.lxh.qingting_player.dev（应用名"清听 Dev"），可与 release 并存
- release 保持 com.lxh.qingting_player
- Android 包名每一段必须以字母开头，因此用 .dev 而非 _dev
- AGP 9 需显式开启 buildFeatures.resValues；移除 manifest 中已废弃的 package 属性

元数据（两个独立原因叠加）：
1. song_key 之前用 String.hashCode / 本地临时文件 mtime，都不稳定；
2. songs.remote_path 存的是完整 URL，而所有查询都用相对路径（song.id），
   getSongByPath 永远 miss，UI 只能回退到文件名。

- 新增 utils/song_key.dart：songKeyFor(url,size)=md5(url|size)，跨进程稳定
- metadata_service: remote_path 改存 fileId（相对路径），并改用稳定 song_key
- audio_service / file_provider: 同步使用稳定键
- 数据库升级 v5：清空 songs / metadata_cache（可再生缓存；歌单与收藏按路径存储，不受影响）
- device-check.ps1: 支持 -Package，默认校验 dev 包，启动组件改为向 PackageManager 解析

验证：两次独立 dart 进程 song_key 输出一致；真机 debug/release 并存安装，单实例自检通过。
 2026-10-22 23:47:32 +08:00
lxh2875931338 6445ee94bf fix(playback): 播放中不再向系统上报 idle，修复播放设备页显示未在播放 
audio_service 把 idle 映射成 PlaybackState.STATE_NONE，之前用 duration>0 判断，
时长尚未解析出来时会一直上报 NONE。改为 playing || duration>0 即视为 ready。

设备验证（MEIZU 21 Pro / Android 16）：
  播放 -> state=PLAYING(3)，暂停 -> state=PAUSED(2)，不再出现 NONE(0)。

同时加固 device-check.ps1：确认进程真正退出后再抓冷启动日志，最多重试两次。
 2026-10-22 22:57:34 +08:00
lxh2875931338 56c26e2fd5 snapshot: 存档 flutter create 模板覆盖后的现场，作为多实例修复前的基线 2026-10-22 21:59:09 +08:00
lxh2875931338 40d4af322b 开始进入修复阶段 2026-09-02 21:42:42 +08:00
lxh2875931338 974dee2995 revert 99917bac87 
revert Core Freeze：核心链路功能已经完成设计，后续进入beta功能开发模式，接下来会在UI部分微调后，进入首个Release版本（1.1.0-Release）
 2026-09-02 10:15:54 +08:00
lxh2875931338 02ca590c65 LGPL库引入后导致app整体处于全面重适配状态，将会处于长期不可用状态 2026-08-30 21:51:19 +08:00
lxh2875931338 99917bac87 Core Freeze：核心链路功能已经完成设计，后续进入beta功能开发模式，接下来会在UI部分微调后，进入首个Release版本（1.1.0-Release） 2026-08-28 22:59:04 +08:00
lxh2875931338 fa396ce681 播放列表持久化设计、播放列表点击显示当前播放歌曲的列表内位置 2026-08-28 22:16:55 +08:00
lxh2875931338 f91846be9a 优化下一曲检测时长，窗口放宽到800ms 2026-08-28 20:52:03 +08:00
lxh2875931338 bb74cd1351 顺序播放跳曲与首次启动跳曲问题的metadata部分修复完成，测试已通过 2026-08-27 23:27:05 +08:00
lxh2875931338 6cb1167a21 顺序播放跳曲与首次启动跳曲问题已部分修复，播放逻辑正确，metadata部分仍需修复 2026-08-27 23:18:40 +08:00
lxh2875931338 9fec9b98c5 现在正在修复首次启动点击跳曲问题与顺序播放的跳曲问题 2026-08-27 22:54:18 +08:00
lxh2875931338 e58be9c17f 引入播放列表库，同时引入全新的播放控制器，以控制读库与播放模式的动作，但是功能仍在完善，需要确认部分边界问题 2026-08-27 22:29:20 +08:00
lxh2875931338 8f3f827429 优化部分功能逻辑：元数据信息漂移 
优化部分体验问题，包含动画、界面层级等
 2026-08-26 21:13:09 +08:00
lxh2875931338 94d37fe263 去掉部分高频刷新的log 2026-08-25 23:14:39 +08:00
lxh2875931338 f2b4d1f46d 通知中心封面图显示 
部分界面的信息更新
缓存系统初步引入
即将进入播放列表更新
 2026-08-25 23:09:17 +08:00
lxh2875931338 0e8921742c 引入部分缓存机制 
引入封面图信息

正在进入测试阶段
 2026-08-25 22:13:36 +08:00
lxh2875931338 b75ea9e4ce 现在版本下，通知中心的进度条拖动seek能力边界问题已全部修复 2026-08-24 23:49:32 +08:00
lxh2875931338 bb466ca534 修复通知中心暂停后播放进度归0的问题 2026-08-24 23:00:45 +08:00
lxh2875931338 f6eb1b108a 现在播放页的实时效果有了 2026-08-23 21:42:37 +08:00
lxh2875931338 d593ce05a1 现在的问题比较大，因为metadata的引入导致原有的部分播放进度信息推送错误 2026-08-23 20:29:31 +08:00
lxh2875931338 9a60441e04 基础实现代码框架先上，后面慢慢改逻辑 2026-08-23 19:24:16 +08:00
lxh2875931338 c3271b07f1 后台连续播放 + MediaItem + 播放状态 + 实时进度 + 系统 seek + seek 后继续实时更新均已正常达成目标 2026-08-23 19:03:49 +08:00
lxh2875931338 be49823b60 播放进度更新已达成，准备优化通知中心的进度条拖动点击 2026-08-23 18:58:43 +08:00
lxh2875931338 1a07664f62 当前固定audio_service为0.18.19，同时已优化媒体信息推送的部分能力，尚在进行媒体信息-播放进度的更新 2026-08-23 18:21:49 +08:00
lxh2875931338 fe3b7de20a 全部包名与名称确定，后台播放能力已完整，准备进入媒体信息推送部分 2026-08-23 17:55:04 +08:00
lxh2875931338 89c4ba8191 现阶段通知中心播放暂停切换功能已实现，但是上下一曲功能暂时消失，需要后续优化，这个commit是snapshot 2026-08-21 22:58:44 +08:00
lxh2875931338 94a4906671 换上全新的通知中心控制逻辑，晚上按3commit的方式进行测试 2026-08-21 09:04:35 +08:00
lxh2875931338 9af035429c 更新了部分逻辑 2026-08-21 08:54:11 +08:00
lxh2875931338 8ecca4ac01 目前状态栏控制大部分已生效，剩余暂停到播放的链路还有问题 2026-08-21 00:03:04 +08:00
lxh2875931338 bb8e4caf48 后台播放能力已调通，介入部分细节优化 2026-08-20 22:36:10 +08:00
lxh2875931338 f94cda4234 权限配置暂时到此，后台播放问题并入生命周期管理同步开发 2026-08-20 22:07:59 +08:00
lxh2875931338 90f4b4e7ae 正在进行初始化减负处理 2026-08-19 23:56:31 +08:00
lxh2875931338 c05398d76f 部分界面调整，把底部的播放控件完整前置 2026-08-18 22:57:29 +08:00
lxh2875931338 e96da3fb04 播放页部分调整，播放链路已打通 2026-08-17 23:29:19 +08:00
lxh2875931338 725116760a 还在尝试跑通播放状态 2026-08-17 23:00:30 +08:00
lxh2875931338 a6056c7f1a webdav存在自引用问题，现版本修复完成 2026-08-17 22:24:56 +08:00
lxh2875931338 457a9bf1e5 界面部分阶段性达成效果 2026-08-16 21:58:18 +08:00
lxh2875931338 699ab7ce86 暂时把bug先处理掉了，准备尝试实现最小播放目标 2026-08-15 23:20:54 +08:00