RELEASE NOTES
持续记录小枫音乐播放器的功能更新、兼容性改进与稳定性修复。
新增 iOS/iPadOS 音量操作提示,支持中英文;
修复销毁重挂、关闭可视化后播放无声等问题;
改善旧版 Chrome 兼容性,歌单加载失败时不再永久空白;
优化拖动、歌单渲染和波形动画,减少重复计算及资源消耗,优化安卓和win渲染卡顿的问题。
新增 FLAC、WAV、AIFF 元数据读取,支持音频参数、歌曲标签、封面和歌词;统一解析与异常处理。
优化歌词阴影:颜色更深、模糊更小,文字更清晰,原背景效果保持不变。
播放修复:处理长音频地址截断、清空歌单后旧音频残留,以及脚本延迟加载时漏挂载的问题。
歌词优化:底部歌词背景按封面取色或主题色生成半透明颜色;加粗文字并增加阴影,改善可读性。
交互与性能:切歌时歌曲名和作者加入动感模糊过渡;精简冗余代码和依赖。
修复 Windows 10 浏览器中实时波形进度条和歌词背景柱状动效无法正常更新的问题,提升音频可视化在不同渲染环境下的稳定性。
修复 Windows 10 浏览器中播放器弹出、收起动画卡顿的问题,优化动画合成与状态切换流程。
修复部分浏览器音频加载策略较严格时,首播失败被误判为资源损坏并进入自动换歌恢复流程的问题。
修复系统监控功能开启后的模块状态与布局异常,保证监控面板和播放器主体保持正确位置。
修复播放器与消息弹窗在复杂页面堆叠上下文中的层级问题,增强高层级导航和弹窗场景的显示可靠性。
优化播放器生产代码,移除不属于公开 API 的内部测试请求链路,减少主包中的非必要逻辑。
新增键盘控制独立防抖,避免连续按下播放、切歌或展开快捷键时重复触发播放器状态变更。
新增页面滑动到底部时自动隐藏底部歌词按钮,用户上滑或离开页面底部后自动恢复显示,减少歌词控件对正文底部内容的遮挡。
新增可配置的 2D Canvas 音频可视化能力,支持实时波形进度条和歌词背景柱状动效;多彩歌词开启时,歌词背景柱状条会使用稳定分色。
优化歌词背景音频动效的柱状密度、宽度和平滑插值,并整理非必要运行逻辑,减少无效绘制和重复状态同步。
新增进度条歌词预览:PC 端鼠标经过时实时展示指针时间对应歌词,移动端点击或拖动时展示,并在松手后保留约 1.5 秒;无真实歌词或仅有纯音乐兜底歌词时不会渲染。
优化歌词预览背景板的主题适配、边界定位与淡入淡出效果,并增加居中指向三角,使拖动位置与歌词信息的对应关系更清晰。
修复移动端进度条手势可能误触播放按钮或相邻控件的问题,完善拖动期间的控件显隐及指针释放流程。
修复歌单滚动条外观被宿主网站全局样式覆盖的问题,滚动条现在由播放器主题独立控制;同时加入可累积的逐帧缓动,改善鼠标滚轮滚动的流畅度,并保留列表边界处的页面滚动行为。
增强移动端音量拖动控制,完善指针捕获、取消与释放流程,并为旧移动浏览器补充触摸事件回退,减少拖动中断或音量未更新的问题。
修复播放器在高层级弹窗、固定导航或复杂堆叠上下文的网站中被遮挡的问题。播放器优先进入浏览器 Top Layer,并以最大有效层级兼容降级,同时保持零尺寸宿主,避免覆盖网页交互区域。
小枫音乐播放器首个稳定版本正式发布,基于 Lit 与 Howler 构建,提供清晰的接入方式、稳定的播放体验与完整的基础能力。
支持云端模式、本地模式、歌词、歌单、记忆播放、单曲循环、随机播放和主题切换,并提供 Web Component、IIFE、ESM、npm 与 CDN 等接入方式。