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:
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