Represents a type of audio driver, such as DirectSound, ASIO, CoreAudio, etc. More...

#include <juce_AudioIODeviceType.h>

Collaboration diagram for AudioIODeviceType:

[legend]

Classes
class	Listener
	A class for receiving events when audio devices are inserted or removed. More...

Public Member Functions
virtual	~AudioIODeviceType ()
	Destructor. More...

void	addListener (Listener *listener)
	Adds a listener that will be called when this type of device is added or removed from the system. More...

virtual AudioIODevice *	createDevice (const String &outputDeviceName, const String &inputDeviceName)=0
	Creates one of the devices of this type. More...

virtual int	getDefaultDeviceIndex (bool forInput) const =0
	Returns the name of the default device. More...

virtual StringArray	getDeviceNames (bool wantInputNames=false) const =0
	Returns the list of available devices of this type. More...

virtual int	getIndexOfDevice (AudioIODevice *device, bool asInput) const =0
	Returns the index of a given device in the list of device names. More...

const String &	getTypeName () const noexcept
	Returns the name of this type of driver that this object manages. More...

virtual bool	hasSeparateInputsAndOutputs () const =0
	Returns true if two different devices can be used for the input and output. More...

void	removeListener (Listener *listener)
	Removes a listener that was previously added with addListener(). More...

virtual void	scanForDevices ()=0
	Refreshes the object's cached list of known devices. More...

Static Public Member Functions
static AudioIODeviceType *	createAudioIODeviceType_ALSA ()
	Creates an ALSA device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_Android ()
	Creates an Android device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_ASIO ()
	Creates an ASIO device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_CoreAudio ()
	Creates a CoreAudio device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_DirectSound ()
	Creates a DirectSound device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_iOSAudio ()
	Creates an iOS device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_JACK ()
	Creates a JACK device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_OpenSLES ()
	Creates an Android OpenSLES device type if it's available on this platform, or returns null. More...

static AudioIODeviceType *	createAudioIODeviceType_WASAPI (bool exclusiveMode)
	Creates a WASAPI device type if it's available on this platform, or returns null. More...

Protected Member Functions
	AudioIODeviceType (const String &typeName)

void	callDeviceChangeListeners ()
	Synchronously calls all the registered device list change listeners. More...

Private Attributes
ListenerList< Listener >	listeners

String	typeName

Detailed Description

Represents a type of audio driver, such as DirectSound, ASIO, CoreAudio, etc.

To get a list of available audio driver types, use the AudioDeviceManager::createAudioDeviceTypes() method. Each of the objects returned can then be used to list the available devices of that type. E.g.

OwnedArray<AudioIODeviceType> types;
myAudioDeviceManager.createAudioDeviceTypes (types);
for (int i = 0; i < types.size(); ++i)
{
    String typeName (types[i]->getTypeName());  // This will be things like "DirectSound", "CoreAudio", etc.
    types[i]->scanForDevices();                 // This must be called before getting the list of devices
    StringArray deviceNames (types[i]->getDeviceNames());  // This will now return a list of available devices of this type
    for (int j = 0; j < deviceNames.size(); ++j)
    {
        AudioIODevice* device = types[i]->createDevice (deviceNames [j]);
        ...
    }
}

For an easier way of managing audio devices and their settings, have a look at the AudioDeviceManager class.

See also: AudioIODevice, AudioDeviceManager

Constructor & Destructor Documentation

◆ ~AudioIODeviceType()

virtual AudioIODeviceType::~AudioIODeviceType ( )

virtual

Destructor.

◆ AudioIODeviceType()

AudioIODeviceType::AudioIODeviceType ( const String & typeName )

explicitprotected

Member Function Documentation

◆ addListener()

void AudioIODeviceType::addListener ( Listener * listener )

Adds a listener that will be called when this type of device is added or removed from the system.

◆ callDeviceChangeListeners()

void AudioIODeviceType::callDeviceChangeListeners ( )

protected

Synchronously calls all the registered device list change listeners.

◆ createAudioIODeviceType_ALSA()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_ALSA ( )

static

Creates an ALSA device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_Android()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_Android ( )

static

Creates an Android device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_ASIO()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_ASIO ( )

static

Creates an ASIO device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_CoreAudio()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_CoreAudio ( )

static

Creates a CoreAudio device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_DirectSound()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_DirectSound ( )

static

Creates a DirectSound device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_iOSAudio()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_iOSAudio ( )

static

Creates an iOS device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_JACK()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_JACK ( )

static

Creates a JACK device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_OpenSLES()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_OpenSLES ( )

static

Creates an Android OpenSLES device type if it's available on this platform, or returns null.

◆ createAudioIODeviceType_WASAPI()

static AudioIODeviceType* AudioIODeviceType::createAudioIODeviceType_WASAPI ( bool exclusiveMode )

static

Creates a WASAPI device type if it's available on this platform, or returns null.

◆ createDevice()

virtual AudioIODevice* AudioIODeviceType::createDevice	(	const String &	outputDeviceName,
		const String &	inputDeviceName
	)

pure virtual

Creates one of the devices of this type.

The deviceName must be one of the strings returned by getDeviceNames(), and scanForDevices() must have been called before this method is used.

◆ getDefaultDeviceIndex()

virtual int AudioIODeviceType::getDefaultDeviceIndex ( bool forInput ) const

pure virtual

Returns the name of the default device.

This will be one of the names from the getDeviceNames() list.

Parameters

forInput if true, this means that a default input device should be returned; if false, it should return the default output

◆ getDeviceNames()

virtual StringArray AudioIODeviceType::getDeviceNames ( bool wantInputNames = false ) const

pure virtual

Returns the list of available devices of this type.

The scanForDevices() method must have been called to create this list.

Parameters

wantInputNames only really used by DirectSound where devices are split up into inputs and outputs, this indicates whether to use the input or output name to refer to a pair of devices.

◆ getIndexOfDevice()

virtual int AudioIODeviceType::getIndexOfDevice	(	AudioIODevice *	device,
		bool	asInput
	)		const

pure virtual

Returns the index of a given device in the list of device names.

If asInput is true, it shows the index in the inputs list, otherwise it looks for it in the outputs list.

◆ getTypeName()

const String& AudioIODeviceType::getTypeName ( ) const

inlinenoexcept

Returns the name of this type of driver that this object manages.

This will be something like "DirectSound", "ASIO", "CoreAudio", "ALSA", etc.

◆ hasSeparateInputsAndOutputs()

virtual bool AudioIODeviceType::hasSeparateInputsAndOutputs ( ) const

pure virtual

Returns true if two different devices can be used for the input and output.

◆ removeListener()

void AudioIODeviceType::removeListener ( Listener * listener )

Removes a listener that was previously added with addListener().

◆ scanForDevices()

virtual void AudioIODeviceType::scanForDevices ( )

pure virtual

Refreshes the object's cached list of known devices.

This must be called at least once before calling getDeviceNames() or any of the other device creation methods.

Member Data Documentation

◆ listeners

ListenerList<Listener> AudioIODeviceType::listeners

private

◆ typeName

String AudioIODeviceType::typeName

private

The documentation for this class was generated from the following file:

juce_AudioIODeviceType.h

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~AudioIODeviceType()

◆ AudioIODeviceType()

Member Function Documentation

◆ addListener()

◆ callDeviceChangeListeners()

◆ createAudioIODeviceType_ALSA()

◆ createAudioIODeviceType_Android()

◆ createAudioIODeviceType_ASIO()

◆ createAudioIODeviceType_CoreAudio()

◆ createAudioIODeviceType_DirectSound()

◆ createAudioIODeviceType_iOSAudio()

◆ createAudioIODeviceType_JACK()

◆ createAudioIODeviceType_OpenSLES()

◆ createAudioIODeviceType_WASAPI()

◆ createDevice()

◆ getDefaultDeviceIndex()

◆ getDeviceNames()

◆ getIndexOfDevice()

◆ getTypeName()

◆ hasSeparateInputsAndOutputs()

◆ removeListener()

◆ scanForDevices()

Member Data Documentation

◆ listeners

◆ typeName