projectM 项目中的预设切换回调机制解析

核心概念

projectM 是一个流行的音乐可视化引擎，其4.1.0版本对预设切换机制进行了重大改进。与3.x系列不同，新版的核心库不再维护内部播放列表，而是将预设切换的控制权完全交给应用程序。

回调机制详解

projectM 核心库提供了两种预设相关的回调函数：

1. 预设切换请求回调：当预设显示时间结束时触发，通知应用程序可以切换预设
2. 预设切换失败回调：当尝试加载新预设失败时触发，通知应用程序加载失败

关键点在于，核心库本身不会自动加载新预设，它只会在预设显示时间结束后发出一次切换请求。如果应用程序选择不切换预设，则不会收到进一步的切换请求。

播放列表库的作用

为了简化开发，projectM 提供了可选的播放列表库，它封装了核心库的回调机制，提供了更高级的功能：

• 管理播放列表（添加/删除预设或整个目录）
• 支持随机或顺序播放
• 提供预设切换成功后的通知回调
• 维护播放历史记录（最多1000条）
• 支持"返回上一首"功能

播放列表库实际上是在核心库回调基础上构建的中间层，为开发者提供了开箱即用的播放列表管理功能。

实际应用建议

对于需要自动切换预设的应用，建议：

1. 使用播放列表库而非直接使用核心库回调
2. 通过播放列表库的"预设已切换"回调来获得切换通知
3. 利用播放列表库的过滤和搜索功能来管理大量预设

这种架构设计使得projectM更加灵活，开发者可以根据需要选择直接使用核心库进行精细控制，或者使用播放列表库快速实现常见功能。