Contents
Navigation
Home User Reference Other Resources


This class lets developer to retrieve and/or change settings of an audio device currently available to the system.

As the methods and properties implemented by this class rely on the CoreAudio framework, using this class requires QuickTime 7.0 or later and MacOS X 10.3 or later.

Note that the class property could be set with four char codes values instead of simple integer values. This being the case, you can use the class to obtain the string representation of these codes.

Since version 6.7 of the plugin this class can be used in Console Applications






The QTPlgAudioDevice class constructors are called when you create a new instance of the class, while the ˜QTPlgAudioDevice class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.

Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. You will obtain valid instances of this class only from the method of the module.


The class provides you with the following initializer methods:
(other as QTPlgAudioDevice)
This is the copy constructor. The properties of the object to be copied will be used to initialize the new class instance properties

specifies the id that identifies the audio device
specifies the human readable name of the audio device (suitable for GUI)
specifies the human readable name for the device manufacturer (suitable for GUI)
specifies a persistent identifier for the model of a device. The identifier is unique such that the identifier from two audio devices are equal if and only if the two devices are the exact same model from the same manufacturer. Further, the identifier has to be the same no matter on what machine the device appears
specifies a persistent identifier for the device. A device’s UID is persistent across boots. The content of the UID string is a black box and may contain information that is unique to a particular instance of an audio device’s hardware or unique to the CPU. Therefore they are not suitable for passing between CPUs or for identifying similar models of hardware
identifies the bundle ID for an application that provides a GUI for configuring the audio device. By default, the value of this property is the bundle ID for Audio MIDI Setup
determines if the audio device can be used as default input source. If true, the device is a possible selection for the method of the module
determines if the audio device can be used as default output source. If true, the device is a possible selection for the method of the module
determines if the audio device can be used as default output source. If true, the device is a possible selection for the method of the module
specifies if the audio device supports mixing; the result is false if the device doesn’t support mixing and all IO is performed in each AudioStream’s current physical format. This property is changed indirectly by changing to a format that doesn’t support mixing, such as AC-3
specifies the current nominal sample rate of the audio device. You can find about suitable nominal sample rates by using the class property
returns the Sound Output Component object corresponding to the Core Audio device if any
allows to get or set (if applicable) the parameters of the audio device input source
allows to get or set (if applicable) the parameters of the audio device output source
returns the valid ranges for the nominal sample rate of the audio device. The list returned contains objects with identical values for the and properties representing the sample rate