Audio Unit V3

Detailed Description

Experimental support for Audio Unit v3 (App Extension)

Classes

protocol  <ARAAudioUnit>
 Protocol to be implemented by ARA-compatible subclasses AUAudioUnit. This protocol may or may not be replaced with the AUMessageChannel based communication defined below. More...
 

Macros

#define kARAAudioComponentTag   "ARA"
 Integration with the system-wide Audio Unit cache. To allow hosts to defer opening any Audio Unit v3 App Extensions until the user explicitly requests it, the system caches various information about the Audio Unit. To support this optimization also when ARA is used, plug-ins must be marked as ARA-compatible at the Audio Component level inside its NSExtensionAttributes by including the tag "ARA" in its Info.plist file, like in this example: More...
 
#define ARA_AUDIOUNIT_FACTORY_CUSTOM_MESSAGES_UTI   /*ARA_DRAFT*/ @"org.ara-audio.audiounitmessages.factory"
 UTIs for ARA message protocols used for [AUAudioUnit messageChannelFor:] (added in macOS 13) The message channel for ARA_AUDIOUNIT_DOCUMENTCONTROLLER_CUSTOM_MESSAGES_UTI should only be obtained and configured once, it will also be used for all document controller communications based on the factories. The message channel for ARA_AUDIOUNIT_PLUGINEXTENSION_CUSTOM_MESSAGES_UTI on the other hand should be managed per ARA-enabled Audio Unit plug-in instance. This API may eventually replace the above ARAAudioUnit <NSObject> draft.
 

Class Documentation

◆ ARAAudioUnit-p

protocol ARAAudioUnit-p

Protocol to be implemented by ARA-compatible subclasses AUAudioUnit. This protocol may or may not be replaced with the AUMessageChannel based communication defined below.

Inherits <NSObject>.

Macro Definition Documentation

◆ kARAAudioComponentTag

#define kARAAudioComponentTag   "ARA"

Integration with the system-wide Audio Unit cache. To allow hosts to defer opening any Audio Unit v3 App Extensions until the user explicitly requests it, the system caches various information about the Audio Unit. To support this optimization also when ARA is used, plug-ins must be marked as ARA-compatible at the Audio Component level inside its NSExtensionAttributes by including the tag "ARA" in its Info.plist file, like in this example:

<key>NSExtension</key>
<dict>
<key>NSExtensionAttributes</key>
<dict>
<key>AudioComponentBundle</key>
<string>your.identifier.goes.here</string>
<key>AudioComponents</key>
<array>
<dict>
...
<key>manufacturer</key>
<string>Demo</string>
<key>subtype</key>
<string>Test</string>
<key>type</key>
<string>aufx</string>
...
<key>tags</key>
<array>
<string>Effects</string>
...
<string>ARA</string>
</array>
</dict>
...