Need help with AudioPlayerSwift?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

tbaranes
218 Stars 36 Forks MIT License 86 Commits 0 Opened issues

Description

AudioPlayer is a simple class for playing audio in iOS, macOS and tvOS apps.

Services available

!
?

Need anything else?

Contributors list

# 6,453
Swift
swift-3
swift-f...
swift4
55 commits
# 556,146
Ruby
HTML
Shell
4 commits
# 222,962
Objecti...
Shell
Scala
iOS
2 commits
# 157,646
vuejs
.NET
guard
stow
2 commits
# 662,241
Ruby
Objecti...
2 commits
# 188,800
Swift
Shell
assembl...
dos
2 commits
# 518
program...
analysi...
2d-fram...
Sketch
1 commit
# 724,628
Ruby
Objecti...
1 commit

AudioPlayer

Travis Language CocoaPods Carthage compatible Platform

AudioPlayer is a simple class for playing audio in iOS, macOS and tvOS apps.

Usage

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

// Start playing audioPlayer.play()

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

See the samples project to see advanced usage

Installation

CocoaPods

Add the following to your Podfile:

pod 'AudioPlayerSwift'

Carthage

Add the following to your Cartfile:

github 'tbaranes/AudioPlayerSwift'

Swift Package Manager

AudioPlayer is available on SPM. Just add the following to your Package file:

import PackageDescription

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

Manual Installation

Just drag the

Source/*.swift
files into your project.

AudioPlayer properties

name

The name of the sound. This is either the name that was passed to the

init
, or the last path component of the audio file.
url

The absolute URL of the audio file.

completionHandler

A callback closure that will be called when the audio finishes playing, or is stopped.

isPlaying

Is it playing or not?

duration

The duration of the sound.

currentTime

The current time offset into the sound of the current playback position.

volume

The volume for the sound. The nominal range is from 0.0 to 1.0.

numberOfLoops

Number of times that the sound will return to the beginning upon reaching the end.

  • A value of zero means to play the sound just once.
  • A value of one will result in playing the sound twice, and so on..
  • Any negative number will loop indefinitely until stopped.
pan

The left/right stereo pan of the file. -1.0 is left, 0.0 is center, 1.0 is right.

AudioPlayer methods

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

These methods create a new AudioPlayer instance from a file name or file path.

func play()

Plays the sound. Has no effect if the sound is already playing.

func stop()

Stops the sound. Has no effect if the sound is not already playing.

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

This method fades a sound from it's current volume to the specified volume over the specified time period.

func fadeIn(duration: TimeInterval = 1.0)

Fades the sound volume from 0.0 to 1.0 over the specified duration.

func fadeOut(duration: TimeInterval = 1.0)

Fades the sound from it's current volume to 0.0 over the specified duration.

Notifications

SoundDidFinishPlayingNotification

This notification is fired (via NSNotificationCenter) whenever a sound finishes playing, either due to it ending naturally, or because the stop method was called. The notification object is an instance of the AudioPlayer class. You can access the AudioPlayer class's

name
property to find out which sound has finished.

What's next

  • AudioPlayerManager
  • Your features!

Contribution

  • If you found a bug, open an issue
  • If you have a feature request, open an issue
  • If you want to contribute, submit a pull request

Licence

AudioPlayerSwift is available under the MIT license. See the LICENSE file for more info.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.