The Amazing Audio Engine

The Amazing Audio Engine is a sophisticated framework for iOS audio applications, built so you don't have to.

It is designed to be very easy to work with, and handles all of the intricacies of iOS audio on your behalf.

Built upon the efficient and low-latency Core Audio Remote IO system, and written by developer of Audiobus and Loopy Michael Tyson, The Amazing Audio Engine lets you get to work on making your app great instead of reinventing the wheel.

See http://theamazingaudioengine.com for details and http://theamazingaudioengine.com/doc for documentation.

License

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
This notice may not be removed or altered from any source distribution.

Changelog

1.5.7

Added Realtime Watchdog
Fixed a spurious audio system restart issue

1.5.6

Replaced internal use of synchronous cross-thread messaging with async messaging, to avoid risk of deadlocks and other timing issues
Fixed a crash that can occur when input format is changing
Watch for audio unit stream format changes in order to better react to sample rate changes
Implemented AEMessageQueue message exchange blocks

1.5.5

Added AEAudioBufferManager class, to enable management of AudioBufferList structures using normal ARC/retain-release memory management techniques
Addressed a problem introduced in 1.5.3 that could cause a 30s hang when restarting audio system
Revised timestamp management with Audiobus/IAA: now, TAAE will pass uncompensated timestamps to ABReceiverPortReceive, and will assume incoming timestamps, when hosted via IAA or Audiobus, are uncompensated.

1.5.4

Fixed an output latency compensation issue when hosted via Inter-App Audio
Deprecated "audiobusSenderPort" facility (use ABSenderPort's audioUnit initializer instead, with AEAudioController's audioUnit property)
Improved performance reports (made these less verbose, added percentage of render budget)
Fixed a crash when using AEPlaythroughChannel and changing the sample rate

1.5.3

Added AEAudioBufferListCreateOnStack utility
Enable automaticLatencyManagement by default
Fixed a race condition when using setAudiobusSenderPort*
Added tvOS support (thanks to Florian Doyon)
Added playAtTime: facility to AEMemoryBufferPlayer (thanks to Anton Holmberg)
Added setup/teardown methods to AEInputReceiver
Fixed missing setup/teardown calls to input filters
Replaced AEPlaythroughChannel initializer

1.5.2

Added composite setAudioDescription:inputEnabled:outputEnabled: update method
Added new initializer with AEAudioControllerOptions bitmask (thanks to Jonatan Liljedahl)
Added setting to always use the hardware sample rate (thanks to Jonatan Liljedahl)
Added missing teardown procedure for channels and filters
Fixed incorrect audio input conversion for interleaved formats
Fixed conversion issue with AEAudioUnitFilter
Fixed OS X build issue by removing AEReverbFilter for OS X (not supported on that platform)
Added 'audioGraphNode' properties to ABAudioUnitFilter/Channel
Updated TPCircularBuffer with added safety measures that will refuse to compile or crash early when a version mismatch is detected with other instances in your project
Address Audiobus issues for apps with both receiver and filter ports

1.5.1

Important fixes for the iPhone 6S
Added some AudioStreamBasicDescription utilities
Added extra AudioBufferList utilities and renamed existing ones for consistent naming
Added wrapper classes for Apple's effect audio units (thanks to Dream Engine's Jeremy Flores!)
Added Audio Unit parameter facilities (setParameterValue:forId: and getParameterValue:forId:)
Added AEMemoryBufferPlayer (a reincarnation of the previous in-memory AEAudioFilePlayer class)
Implemented 'playAtTime:' synchronisation method on AEAudioFilePlayer
Refactored out cross-thread messaging system into AEMessageQueue (thanks Jonatan Liljedahl!)
Replaced 'updateWithAudioDescription:...' mechanism with separate 'setAudioDescription', 'setInputEnabled' and 'setOutputEnabled' methods
Bunch of other little improvements; see git log for details.

1.5

OS X support! Many, many thanks to Steve Rubin!
Replaced in-memory version of AEAudioFilePlayer with an audio unit version which streams from disk (thanks to Ryan King and Jeremy Huff of Hello World Engineering, and Ryan Holmes for their contributions to this great enhancement).
Bunch of other little improvements; see git log for details.

bsneed/TheAmazingAudioEngine