SwiftAudioManager 0.2.1

SwiftAudioManager 0.2.1

Ming Sun 维护。



  • Ming Sun

SwiftAudioManager

CI Status Version License Platform

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'

作者

[email protected]

许可

SwiftAudioManager 采用 MIT 许可证。有关更多信息,请参阅 LICENSE 文件。