【v0.2.0】使用音频实例类替换单音频操作函数

发布简介

Important

本版本存在大量接口变更，使用以前版本的项目请谨慎使用本版本

本版本移除了下列音频操作函数

    bool isPlaying(size_t instanceId);
    void setVolume(size_t instanceId, float volume);
    float getVolume(size_t instanceId);
    void stop(size_t instanceId);
    void resume(size_t instanceId);
    void setMuted(size_t instanceId, bool muted);

相应的功能移交给了audioInstance类

为了适配这个更改，addAudio的行为从返回ID变更为了返回实例对象，同时新增了regain函数根据ID重新获取实例对象。

新增registerPlaybackFinishedCallback函数用于注册回调以便更简单的获知音频播放完毕

本版本优化了内部逻辑，安全性、稳定性均得到一定水平的提高

主要变更（PR）

• [开发][接口变更] 移除使用ID操作音频的函数，以示例类替代，新增回调函数处理播放完成状态，@yumotec，#20
• Baka Baka Baka Baka，@yumotec，#21
• 修复音频预加载指针有效性检查，@xiaoditx，#23
• 修正命名和音量夹紧，@GreMarkUndeletableDC，#24
• 重构音频回调处理，优化缓冲区管理，@xiaoditx，#25
• 更新测试文件的音频状态处理 ，@yumotec，#26
• 将isPlaying改为audioInstance方法并更新头文件注释，@xiaoditx，#27

新贡献者

• @GreMarkUndeletableDC 在 #24 做了他的第一个贡献

完整的变更日志: v0.1.1...v0.2.0

【v0.1.1】优化异常处理

优化了库的错误处理，细化了错误类型

变更

• [开发] 完善异常处理机制 ： @yumotec ， #19

Full Changelog: v0.1.0...v0.1.1

【v0.1.0】加入mp3播放支持

更改

• 添加MP3支持，改进音频处理和文档 - @xiaoditx ( #18 )

使用

本次版本更新没有改变接口，想要播放mp3，只要将mp3文件的路径传给preloadAudio即可，就像处理wav时一样

---

完整的变更日志: v0.0.3...v0.1.0

【v0.0.3】删除无用接口并优化yumo::atomic类

What's Changed

• [开发][接口变更] 删除不必要的接口，修缮头文件细节 by @xiaoditx in #17

Full Changelog: v0.0.2...v0.0.3

【v0.0.2】32位版本提供

What's Changed

• Refactor Makefile for architecture-specific builds by @yumotec in #16

Full Changelog: v0.0.1...v0.0.2

【0.0.1】测试发布版

What's Changed

• 实现了基本的WAV文件信息读取功能 by @xiaoditx in #1
• [文档] 修改README.md by @xiaoditx in #2
• 库功能的早期quick-and-dirty实现 by @xiaoditx in #3
• 多音频文件播放优化 by @xiaoditx in #4
• Update API and optimize code with new mute interface by @xiaoditx in #5
• 构建脚本；依赖库摆脱；错误修正 by @xiaoditx in #6
• Refactor audio loading interfaces and improve build tools by @xiaoditx in #9
• Refactor audio pool with enhanced control features by @xiaoditx in #10
• 重构音频池为全局接口封装，引入 audioSign 全局控制对象 by @xiaoditx in #11
• Replace std::atomic with custom yumo::atomic for audio control by @xiaoditx in #12
• 接口变更，向用户隐藏音频池类的存在 by @xiaoditx in #14
• Add Makefile and update .gitignore for build directory by @yumotec in #15

New Contributors

• @xiaoditx made their first contribution in #1
• @yumotec made their first contribution in #15

Full Changelog: https://github.com/keyBonk-org/audio-player/commits/v0.0.1