SwiftAudioManager
SwiftAudioManager 路线图
0.1.0 基础功能0.2.0 下载与本地存储- 0.3.0 关键 - URL - 音乐系统
- 0.4.0 存储音乐的键列表
- 0.5.0 BGM 淡入淡出
- 0.6.0 列表中自动播放下一首
反馈问题
- 多个 SFX 播放器,但是共享一个公共缓冲区?
使用
步骤1:准备
如果所有音频资源都是本地的,可以跳过此步骤
对于本地文件URL
目前,SwiftAudioManager通过URL进行工作。对于与代码库捆绑的本地音频资源,你可以使用以下代码获取其URL:
Bundle.main.url(forResource: "audio name", withExtension: "mp3")
对于在线文件链接
SwiftAudioManager需要一个有效的链接——一个在浏览器上可以工作的链接。例如:https://www.example.com/sounds/1/example.mp3 链接如果你已经有了,请使用以下代码下载音频文件。
// Note that the link string needs to be converted to URL
SwiftAudioManager.shared.prepareAssets(_ urlList: ["local url/link"]) { outcomeList in
for outcome in outcomeList {
// outcome is a typealias: (url: URL, success: Bool)
if !outccome.success {
// handle file retrieve/download failure for current local url/link
}
}
}
注意:下载的音频文件将永久缓存在磁盘上。
步骤2: 如何播放声音
- 作为BGM(背景音乐):会持续播放的音乐。如果音乐结束,将会重新播放。新音乐将覆盖旧音乐,一次只有一个BGM。
SwiftAudioManager.shared.playAsBGM("local url/link")
- 作为SFX(声音效果):例如点击、滑动或拍手的声音。新的SFX将立即播放,即使它们是相同的响声,也会覆盖当前的SFX。
SwiftAudioManager.shared.playAsSFX("local url/link")
其他有用的方法
- 停止所有声音效果
SwiftAudioManager.shared.enabled = false
工作示例
要运行示例项目,需要先克隆仓库,然后从示例目录运行pod install
。
需求
iOS 10.0+, Swift 4
安装
SwiftAudioManager 可通过 CocoaPods 获得。要安装,只需将以下行添加到您的 Podfile 中
pod 'SwiftAudioManager'
作者
许可
SwiftAudioManager 采用 MIT 许可证。有关更多信息,请参阅 LICENSE 文件。