Introduction

This document describes audio units and how to create them. Audio units are digital audio plug-ins based on Apple’s world class Core Audio technology for OS X.

As a hobbyist or a computer science student, you can design and build your own audio units to make applications like GarageBand do new things with sound.

As a commercial developer, you can create professional quality software components that provide features like filtering, reverb, dynamics processing, and sample-based looping. You can also create simple or elaborate MIDI-based music synthesizers, as well as more technical audio units such as time and pitch shifters and data format converters.

As part of Core Audio and being integral to OS X, audio units offer a development approach for audio plug-ins that excels in terms of performance, robustness, and ease of deployment. With audio units, you also gain by providing a consistent, simple experience for end-users.

Your target market is wide, including performers, DJs, recording and mastering engineers, and anyone who likes to play with sound on their iMac.

Who Should Read This Document?

To use this document, you should already be familiar with the C programming language. You should be comfortable with using Xcode to create an OS X plug-in as described in the Xcode Overview. For example, you should know about Xcode’s various build options, such as ZeroLink, and when to use them. You should also know how and why to include frameworks and files in the linking phase of an Xcode build.

It’s very helpful in using this document to have enough familiarity with the C++ programming language to read header and implementation files. It’s also helpful to have a basic understanding of the OS X Component Manager as described in Component Manager for QuickTime, as well as a grounding in digital audio coding and audio DSP (digital signal processing).

This document does not address the needs of audio unit host application developers, whose code opens, connects, and uses audio units. Nor is this document an audio unit cookbook. It devotes very few pages to DSP or music synthesis techniques, which work essentially the same way in audio units as in other audio software technologies

Organization of This Document

Depending on your needs and your learning style, you can use this document in the following ways.

• If you want to get your hands on building an audio unit right away, go straight to Tutorial: Building a Simple Effect Unit with a Generic View. As you build the audio unit, you can refer to other sections in this document for conceptual information related to what you’re doing.

• If you prefer to build your knowledge incrementally, starting with a solid conceptual foundation before seeing the technology in action, read the chapters in order.

• If you already have some familiarity with building your own audio units, you may want to go straight to The Audio Unit and Appendix: Audio Unit Class Hierarchy. You might also want to review A Quick Tour of the Core Audio SDK to see if the SDK contains some treasures you haven’t been using until now.

This document contains the following chapters:

• Audio Unit Development Fundamentals, a bird's eye view of audio unit development, covering Xcode, the Core Audio SDK, design, development, testing, and deployment

• The Audio Unit, design and programming considerations for the part of an audio unit that performs the audio work

• The Audio Unit View, a description of the two audio unit view types—generic and custom—as well as an explanation of parameter automation

• A Quick Tour of the Core Audio SDK: Taking advantage of the code in the Core Audio SDK is the fastest route to audio unit development

• Tutorial: Building a Simple Effect Unit with a Generic View, a tutorial that takes you from zero to a fully functioning effect unit

• Appendix: Audio Unit Class Hierarchy, a tour of the audio unit class hierarchy provided by the Core Audio SDK