尝试支持类似Apple Music的AutoMix[半成品]

[kazukokawagawa]

No description provided.

[gemini-code-assist]

Summary of Changes

Hello @kazukokawagawa, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

此拉取请求旨在引入一个类似Apple Music的AutoMix功能，以实现歌曲之间更智能、更流畅的过渡体验。通过集成Rust编写的高性能音频分析库，系统现在能够深入分析音频文件的关键特性，如BPM、响度、淡入淡出点和人声区域。这些分析数据被用于驱动播放引擎的增强型交叉淡入淡出逻辑，包括BPM对齐、响度标准化以及基于歌曲结构（如人声开始/结束、能量骤升）的智能过渡触发。此外，还新增了分析结果的本地缓存机制和用户可配置的AutoMix设置，以优化性能和用户体验。

Highlights

• 引入AutoMix功能: 新增类似Apple Music的AutoMix功能，旨在提供歌曲间的无缝智能过渡。
• 集成Rust音频分析库: 引入Rust symphonia库，用于执行高效的音频文件分析，包括时长、BPM、响度、淡入/淡出点、人声位置和能量骤升点（Drop）。
• 音频分析结果缓存: 在本地数据库中新增 audio_analysis 表，用于缓存音频分析结果，避免重复计算，提高效率。
• 增强音频播放引擎: 扩展 AudioEffectManager 和 BaseAudioPlayer，支持多种渐变曲线（线性、等功率、指数）和高通/低通滤波器，为AutoMix提供底层混音能力。
• 实现智能交叉淡入淡出: AudioManager 新增 crossfadeTo 方法，实现了在两首歌曲之间进行平滑的交叉淡入淡出，并处理BPM对齐和响度匹配。
• PlayerController集成AutoMix逻辑: PlayerController 现在能够预取下一首歌曲的分析数据，并根据分析结果（如人声位置、BPM、能量骤升点）智能决定何时以及如何触发AutoMix过渡。
• 新增AutoMix设置: 在播放设置中添加了启用/禁用AutoMix的开关，以及配置最大分析时间的选项。

Changelog

• Cargo.lock
  • 更新了依赖项，新增了 bitflags 的旧版本依赖和 extended 包，并添加了 symphonia 及其相关组件。
• electron/main/database/LocalMusicDB.ts
  • 添加了 ANALYSIS_SCHEMA 用于定义音频分析结果表。
  • 新增了 getAnalysis 和 saveAnalysis 方法来管理分析数据的存取。
• electron/main/ipc/ipc-file.ts
  • 引入了原生模块 tools.node 中的 analyzeAudioFile 函数。
  • 注册了 analyze-audio IPC 处理器，实现了音频分析的调用和缓存检查逻辑。
• electron/main/services/LocalMusicService.ts
  • 为本地音乐服务添加了 getAnalysis 和 saveAnalysis 方法，用于与数据库交互。
• electron/main/utils/native-loader.ts
  • 更新了 loadNativeModule 函数中的路径解析逻辑，以更好地适配 tools 模块的结构。
• native/tools/Cargo.toml
  • 添加了 symphonia 库作为依赖，并启用了多种音频格式（mp3, flac, aac, isomp4, alac, vorbis, wav）支持。
• native/tools/index.d.ts
  • 声明了 analyzeAudioFile 函数及其返回的 AudioAnalysis 接口，包含了音频分析的各项详细数据。
• native/tools/package.json
  • 为 tools 模块添加了 types 字段，指向 index.d.ts。
• native/tools/src/analysis.rs
  • 新增文件，实现了核心的Rust音频分析逻辑。
  • 包括 AudioAnalysis 结构体定义、高通滤波器 (HighPassFilter)、双二阶滤波器 (BiquadFilter) 和响度计 (LoudnessMeter)。
  • analyze_audio_file 函数负责解码音频、计算RMS包络、高频比、响度（LUFS），并检测淡入/淡出点、BPM、能量骤升点和人声区域。
• native/tools/src/lib.rs
  • 导出了 analysis 模块，使其可在NAPI中调用。
• package.json
  • 添加了 tools 作为本地依赖。
• pnpm-lock.yaml
  • 更新了 pnpm 锁定文件，以反映新的依赖关系和 @electron/node-gyp 的引用方式。
• src/components/Setting/config/play.ts
  • 在播放设置中新增了“启用自动混音”开关和“最大分析时间”的数字输入框。
• src/core/audio-player/AudioEffectManager.ts
  • 增加了 highPassFilter 和 lowPassFilter 成员，并在音频效果链中连接了这些滤波器。
  • 新增了 setHighPassFilter 和 setLowPassFilter 方法来控制这些滤波器。
• src/core/audio-player/BaseAudioPlayer.ts
  • 修改了 init 方法以使用共享的 AudioContext。
  • 更新了 destroy 方法以正确断开所有节点连接。
  • 增强了 play 和 pause 方法的选项，支持 fadeCurve 类型和 keepContextRunning。
  • 重构了 applyFadeTo 方法，支持线性、指数和等功率三种渐变曲线。
  • 新增了 setHighPassFilter 和 setLowPassFilter 的代理方法。
• src/core/audio-player/IPlaybackEngine.ts
  • 定义了 FadeCurve 类型，并在 PlayOptions 和 PauseOptions 接口中添加了 fadeCurve 属性。
  • PauseOptions 新增 keepContextRunning。
  • IPlaybackEngine 接口新增 setHighPassFilter 和 setLowPassFilter 方法。
• src/core/audio-player/SharedAudioContext.ts
  • 新增文件，导出一个单例的 AudioContext 实例，确保所有播放器引擎共享同一个音频上下文。
• src/core/player/AudioManager.ts
  • 引入了 pendingEngine 和 pendingSwitchTimer 来管理交叉淡入淡出期间的引擎切换。
  • 新增了 crossfadeTo 方法，实现了在两个播放引擎之间进行平滑过渡的逻辑，包括MPV引擎的特殊处理、音量预设、ReplayGain应用、低音交换滤波器设置以及过渡完成后的引擎销毁。
• src/core/player/PlayerController.ts
  • 引入了 AudioAnalysis 接口和相关状态变量。
  • 重构了 applyReplayGain 方法以支持AutoMix增益调整。
  • 新增 prepareAudioSource 方法用于获取音频源和分析数据。
  • 新增 setupSongUI 方法用于统一设置歌曲UI状态。
  • 修改 playSong 方法以支持AutoMix的智能切入点、BPM对齐和交叉淡入淡出。
  • 新增 rampRateTo 方法用于平滑过渡播放速率。
  • 在 timeUpdate 事件中集成了AutoMix的触发逻辑，包括预取下一首歌曲分析、计算交叉淡入淡出时长和触发点。
  • 新增 automixPlay 方法来处理AutoMix的实际播放逻辑，包括响度匹配和UI切换。
  • 新增 getNextSongForAutomix 方法用于获取下一首歌曲。
• src/core/player/SongManager.ts
  • 在 prefetchNextSong 方法中增加了对本地歌曲的音频分析预处理逻辑，以支持AutoMix。
• src/stores/setting.ts
  • 在 SettingState 接口和默认状态中添加了 enableAutomix 和 automixMaxAnalyzeTime 属性。

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩