首页
/ 探索Subsonic:SwiftUI音频播放的轻量级解决方案

探索Subsonic:SwiftUI音频播放的轻量级解决方案

2024-05-23 02:48:18作者:凤尚柏Louis

Subsonic Logo

Subsonic是一个为SwiftUI设计的小巧而强大的音频处理库,它使得在各种场景下播放音频变得异常简单,无论是即时触发还是基于状态的播放。该库支持iOS 14+、macOS 11+、tvOS 14+以及watchOS 7+。

“Subsonic”这个名字源于音速之下,象征着这个库的存在几乎察觉不到,但它的功能强大到足以让你的音频体验提升一个档次。

安装

使用Swift Package Manager(SwiftPM)将Subsonic添加到你的项目中,只需在你的Package.swift文件的dependencies部分加入以下代码:

.package(url: "https://github.com/twostraws/Subsonic", from: "0.2.0"),

然后在需要的地方导入Subsonic即可开始使用。

播放音频

Subsonic提供了四种不同级别的控制方式来满足你的需求。

1. 简单播放音频

如果你只是想立即播放一个位于主bundle内的音频文件,可以这样操作:

Button("播放声音") {
    play(sound: "example.mp3")
}

2. 带有控制权的播放

当你需要精细控制音频播放时,可以创建一个SubsonicPlayer对象的@StateObject属性:

struct ContentView: View {
    @StateObject private var sound = SubsonicPlayer(sound: "example.mp3")

    var body: some View {
        VStack {
            Button("开始") {
                sound.play()
            }

            Button("停止") {
                sound.stop()
            }

            Slider(value: $sound.volume)
        }
    }
}

这允许你在需要的时候启动或停止音频,调整音量和其他属性。

3. 绑定播放状态

若希望音频的播放与程序状态同步,可以使用sound()修饰符:

struct ContentView: View {
    @State private var isPlaying = false

    var body: some View {
        Button {
            isPlaying.toggle()
        } label: {
            Image(systemName: isPlaying ? "speaker.wave.3" : "speaker")
        }
        .sound("example.mp3", isPlaying: $isPlaying)
    }
}

4. 自管理音频播放器

如果你想自行准备和播放音频,可以使用prepare(sound:)

Button("播放声音") {
    let player = prepare(sound: "example.mp3")
    // 配置后按需播放
}

请注意,你需要保存返回的player对象并自行控制播放。

停止音频

停止音频播放的方式取决于你是如何开始播放的:

  • 使用play(sound:)时,可调用stop(sound:)stopAllManagedSounds()
  • SubsonicPlayer实例可通过调用其stop()方法停止。
  • 对于sound()修饰符,状态改变会自动停止播放。
  • 如果使用prepare(sound:),则自行负责播放和停止。

参数选项

play(sound:)sound()修饰符接受一些额外参数:

  • bundle用于指定音频文件所在的捆绑包,默认是Bundle.main
  • volume设置相对音量,范围从0(静音)到1(最大),默认值为1。
  • repeatCount控制重复次数,0为一次,1为两次,以此类推,.continuous表示无限循环。
  • sound()修饰符还有一个playMode选项,它可以设置为.reset(从头开始播放) 或 .continue(从暂停处继续)。

prepare(sound:)也允许指定自定义的bundle。

对于SubsonicPlayer,这些参数可以在初始化时设定,并且它们也可以动态调整。

项目特点

  • 易用性:无论你是需要简单的播放还是复杂的控制,Subsonic都提供了直观的API。
  • 灵活性:你可以以声明式或命令式的方式操作音频,适应不同的编程风格。
  • 跨平台:Subsonic支持多个Apple平台,方便你在所有设备上构建一致的用户体验。
  • 小巧而强大:Subsonic的体积小,但在音频处理上毫不妥协,确保了性能和稳定性。

关于作者

Subsonic由Paul Hudson创建,他的个人网站Hacking with Swift提供了丰富的Swift教程资源。

Subsonic遵循MIT许可证,详细条款请查看LICENSE文件。

现在就尝试Subsonic,为你的SwiftUI应用添加生动的音频元素吧!

登录后查看全文
热门项目推荐