AudioPlayer

AudioPlayer 是一个简单的用于在 iOS、macOS 和 tvOS 应用中播放音频的类。

用法

// Initialize
let audioPlayer = AudioPlayer("sound.mp3")

// Start playing
audioPlayer.play()

// Stop playing with a fade out
audioPlayer.fadeOut()

查看示例项目以了解高级用法

安装

CocoaPods

将以下内容添加到您的 Podfile 中

pod 'AudioPlayerSwift'

Carthage

将以下内容添加到您的 Cartfile 中

github 'tbaranes/AudioPlayerSwift'

Swift 包管理器

AudioPlayer 在 SPM (Swift Package Manager) 中可用。只需在您的包文件中添加以下内容

import PackageDescription

let package = Package(
    dependencies: [
        .Package(url: "https://github.com/tbaranes/AudioPlayerSwift.git", majorVersion: 1)
    ]
)

手动安装

只需将 Source/*.swift 文件拖到您的项目中。

AudioPlayer 属性

name

声音的名称。这可能是传递给 init 的名称，或者是音频文件的最后一个路径组件。

url

音频文件的绝对 URL。

completionHandler

当音频播放完成或停止时将被调用的回调闭包。

isPlaying

是否正在播放？

duration

声音的持续时间。

currentTime

当前播放位置的当前时间偏移量。

volume

声音的音量。正常范围是 0.0 到 1.0。

numberOfLoops

声音在到达结尾时返回开始的次数。

• 零值意味着只播放一次声音。
• 一值将导致声音播放两次，依此类推。
• 任何负数都将以无限循环播放，直到停止。

pan

文件左右立体声的平移。-1.0 表示左，0.0 表示中心，1.0 表示右。

AudioPlayer 方法

init(fileName: String) throws
init(contentsOfPath path: String) throws
init(contentsOf url: URL) throws

这些方法从文件名或文件路径创建新的 AudioPlayer 实例。

func play()

播放声音。如果声音已经播放，则没有效果。

func stop()

停止声音。如果没有播放声音，则没有效果。

func fadeTo(volume: Float, duration: TimeInterval = 1.0)

该方法将在指定期间将声音的当前音量淡入到指定的音量。

func fadeIn(duration: TimeInterval = 1.0)

在指定的持续时间内在 0.0 到 1.0 之间淡入声音音量。

func fadeOut(duration: TimeInterval = 1.0)

在指定的持续时间内在当前音量到 0.0 之间淡出声音音量。

通知

SoundDidFinishPlayingNotification

当声音播放结束时（通过NSNotificationCenter触发），无论是自然结束还是调用停止方法，都会发出此通知。通知对象是AudioPlayer类的实例。您可以通过访问AudioPlayer类的name属性来查看哪个声音已结束。

接下来是什么

• AudioPlayerManager
• 您的功能！

贡献

• 如果您发现了bug，请开启一个issue
• 如果您有一个功能请求，请开启一个issue
• 如果您想贡献，请提交一个pull request

许可协议

AudioPlayerSwift遵循MIT许可协议。更多信息请查看LICENSE文件。