A fancy Obj-C wrapper for Cocoa System Sound Services, for iOS and OS X.
This library is a light-weight component to play sound effects in your app. To determine your audio needs, see Best Practices for iOS Audio.
tl;dr
When your sole audio need is to play alerts and user-interface sound effects, use Core Audio’s System Sound Services.
Your sound files must be:
- No longer than 30 seconds in duration
- In linear PCM or IMA4 (IMA/ADPCM) format
- Packaged in a
.caf,.aif, or.wavfile
If this does not fit your needs, then this library is not for you! See AVAudioPlayer, instead.
- Play sound effects and alert sounds with a single line of code
- "Play" vibration (if available on device)
- Block-based completion handlers
- Integration with
NSUserDefaultsto globally toggle sound effects in your app - Efficient memory management
- Caches sounds (
SystemSoundIDinstances) and purges on memory warning - Works with Swift!
- Xcode 9+
- iOS 9.0+
- tvOS 9.0+
- macOS 10.10+
CocoaPods (recommended)
pod 'JSQSystemSoundPlayer'github "jessesquires/JSQSystemSoundPlayer"Read the docs. Generated with jazzy. Hosted by GitHub Pages.
$ ./build_docs.sh$ open index.html -a SafariPlease follow these sweet contribution guidelines.
Created and maintained by @jesse_squires.
JSQSystemSoundPlayer is released under an MIT License. See LICENSE for details.
Copyright © 2013-present Jesse Squires.
Please provide attribution, it is greatly appreciated.