JUCE  v5.1.1-3-g1a0b28c73
JUCE API
iOSAudioIODevice Class Reference

#include <juce_ios_Audio.h>

Inheritance diagram for iOSAudioIODevice:
Collaboration diagram for iOSAudioIODevice:

Public Member Functions

void close () override
 Closes and releases the device if it's open. More...
 
BigInteger getActiveInputChannels () const override
 Returns a mask showing which of the available input channels are currently enabled. More...
 
BigInteger getActiveOutputChannels () const override
 Returns a mask showing which of the available output channels are currently enabled. More...
 
AudioPlayHeadgetAudioPlayHead () const
 
Array< intgetAvailableBufferSizes () override
 Returns the set of buffer sizes that are available. More...
 
Array< double > getAvailableSampleRates () override
 Returns the set of sample-rates this device supports. More...
 
int getCurrentBitDepth () override
 Returns the device's current physical bit-depth. More...
 
int getCurrentBufferSizeSamples () override
 Returns the buffer size that the device is currently using. More...
 
double getCurrentSampleRate () override
 Returns the sample rate that the device is currently using. More...
 
int getDefaultBufferSize () override
 Returns the default buffer-size to use. More...
 
StringArray getInputChannelNames () override
 Returns the names of all the available input channels on this device. More...
 
int getInputLatencyInSamples () override
 Returns the device's input latency. More...
 
String getLastError () override
 Returns the last error that happened if anything went wrong. More...
 
const StringgetName () const noexcept
 Returns the device's name, (as set in the constructor). More...
 
StringArray getOutputChannelNames () override
 Returns the names of all the available output channels on this device. More...
 
int getOutputLatencyInSamples () override
 Returns the device's output latency. More...
 
const StringgetTypeName () const noexcept
 Returns the type of the device. More...
 
virtual bool hasControlPanel () const
 True if this device can show a pop-up control panel for editing its settings. More...
 
bool isInterAppAudioConnected () const
 
bool isOpen () override
 Returns true if the device is still open. More...
 
bool isPlaying () override
 Returns true if the device is still calling back. More...
 
String open (const BigInteger &, const BigInteger &, double, int) override
 Tries to open the device ready to play. More...
 
bool setAudioPreprocessingEnabled (bool) override
 On devices which support it, this allows automatic gain control or other mic processing to be disabled. More...
 
void setMidiMessageCollector (MidiMessageCollector *)
 
virtual bool showControlPanel ()
 Shows a device-specific control panel if there is one. More...
 
void start (AudioIODeviceCallback *) override
 Starts the device actually playing. More...
 
void stop () override
 Stops the device playing. More...
 
void switchApplication ()
 

Protected Attributes

String name
 
String typeName
 

Private Member Functions

 iOSAudioIODevice (const String &)
 

Private Attributes

ScopedPointer< Pimplpimpl
 

Friends

struct AudioSessionHolder
 
struct iOSAudioIODeviceType
 
struct Pimpl
 

Constructor & Destructor Documentation

◆ iOSAudioIODevice()

iOSAudioIODevice::iOSAudioIODevice ( const String )
private

Member Function Documentation

◆ close()

void iOSAudioIODevice::close ( )
overridevirtual

Closes and releases the device if it's open.

Implements AudioIODevice.

◆ getActiveInputChannels()

BigInteger iOSAudioIODevice::getActiveInputChannels ( ) const
overridevirtual

Returns a mask showing which of the available input channels are currently enabled.

See also
getInputChannelNames

Implements AudioIODevice.

◆ getActiveOutputChannels()

BigInteger iOSAudioIODevice::getActiveOutputChannels ( ) const
overridevirtual

Returns a mask showing which of the available output channels are currently enabled.

See also
getOutputChannelNames

Implements AudioIODevice.

◆ getAudioPlayHead()

AudioPlayHead* iOSAudioIODevice::getAudioPlayHead ( ) const

◆ getAvailableBufferSizes()

Array<int> iOSAudioIODevice::getAvailableBufferSizes ( )
overridevirtual

Returns the set of buffer sizes that are available.

See also
getCurrentBufferSizeSamples, getDefaultBufferSize

Implements AudioIODevice.

◆ getAvailableSampleRates()

Array<double> iOSAudioIODevice::getAvailableSampleRates ( )
overridevirtual

Returns the set of sample-rates this device supports.

See also
getCurrentSampleRate

Implements AudioIODevice.

◆ getCurrentBitDepth()

int iOSAudioIODevice::getCurrentBitDepth ( )
overridevirtual

Returns the device's current physical bit-depth.

If the device isn't actually open, this value doesn't really mean much.

Implements AudioIODevice.

◆ getCurrentBufferSizeSamples()

int iOSAudioIODevice::getCurrentBufferSizeSamples ( )
overridevirtual

Returns the buffer size that the device is currently using.

If the device isn't actually open, this value doesn't really mean much.

Implements AudioIODevice.

◆ getCurrentSampleRate()

double iOSAudioIODevice::getCurrentSampleRate ( )
overridevirtual

Returns the sample rate that the device is currently using.

If the device isn't actually open, this value doesn't really mean much.

Implements AudioIODevice.

◆ getDefaultBufferSize()

int iOSAudioIODevice::getDefaultBufferSize ( )
overridevirtual

Returns the default buffer-size to use.

Returns
a number of samples
See also
getAvailableBufferSizes

Implements AudioIODevice.

◆ getInputChannelNames()

StringArray iOSAudioIODevice::getInputChannelNames ( )
overridevirtual

Returns the names of all the available input channels on this device.

To find out which of these are currently in use, call getActiveInputChannels().

Implements AudioIODevice.

◆ getInputLatencyInSamples()

int iOSAudioIODevice::getInputLatencyInSamples ( )
overridevirtual

Returns the device's input latency.

This is the delay in samples between some audio actually arriving at the soundcard, and the callback getting passed this block of data.

Implements AudioIODevice.

◆ getLastError()

String iOSAudioIODevice::getLastError ( )
overridevirtual

Returns the last error that happened if anything went wrong.

Implements AudioIODevice.

◆ getName()

const String& AudioIODevice::getName ( ) const
inlinenoexceptinherited

Returns the device's name, (as set in the constructor).

◆ getOutputChannelNames()

StringArray iOSAudioIODevice::getOutputChannelNames ( )
overridevirtual

Returns the names of all the available output channels on this device.

To find out which of these are currently in use, call getActiveOutputChannels().

Implements AudioIODevice.

◆ getOutputLatencyInSamples()

int iOSAudioIODevice::getOutputLatencyInSamples ( )
overridevirtual

Returns the device's output latency.

This is the delay in samples between a callback getting a block of data, and that data actually getting played.

Implements AudioIODevice.

◆ getTypeName()

const String& AudioIODevice::getTypeName ( ) const
inlinenoexceptinherited

Returns the type of the device.

E.g. "CoreAudio", "ASIO", etc. - this comes from the AudioIODeviceType that created it.

◆ hasControlPanel()

virtual bool AudioIODevice::hasControlPanel ( ) const
virtualinherited

True if this device can show a pop-up control panel for editing its settings.

This is generally just true of ASIO devices. If true, you can call showControlPanel() to display it.

◆ isInterAppAudioConnected()

bool iOSAudioIODevice::isInterAppAudioConnected ( ) const

◆ isOpen()

bool iOSAudioIODevice::isOpen ( )
overridevirtual

Returns true if the device is still open.

A device might spontaneously close itself if something goes wrong, so this checks if it's still open.

Implements AudioIODevice.

◆ isPlaying()

bool iOSAudioIODevice::isPlaying ( )
overridevirtual

Returns true if the device is still calling back.

The device might mysteriously stop, so this checks whether it's still playing.

Implements AudioIODevice.

◆ open()

String iOSAudioIODevice::open ( const BigInteger inputChannels,
const BigInteger outputChannels,
double  sampleRate,
int  bufferSizeSamples 
)
overridevirtual

Tries to open the device ready to play.

Parameters
inputChannelsa BigInteger in which a set bit indicates that the corresponding input channel should be enabled
outputChannelsa BigInteger in which a set bit indicates that the corresponding output channel should be enabled
sampleRatethe sample rate to try to use - to find out which rates are available, see getAvailableSampleRates()
bufferSizeSamplesthe size of i/o buffer to use - to find out the available buffer sizes, see getAvailableBufferSizes()
Returns
an error description if there's a problem, or an empty string if it succeeds in opening the device
See also
close

Implements AudioIODevice.

◆ setAudioPreprocessingEnabled()

bool iOSAudioIODevice::setAudioPreprocessingEnabled ( bool  shouldBeEnabled)
overridevirtual

On devices which support it, this allows automatic gain control or other mic processing to be disabled.

If the device doesn't support this operation, it'll return false.

Reimplemented from AudioIODevice.

◆ setMidiMessageCollector()

void iOSAudioIODevice::setMidiMessageCollector ( MidiMessageCollector )

◆ showControlPanel()

virtual bool AudioIODevice::showControlPanel ( )
virtualinherited

Shows a device-specific control panel if there is one.

This should only be called for devices which return true from hasControlPanel().

◆ start()

void iOSAudioIODevice::start ( AudioIODeviceCallback callback)
overridevirtual

Starts the device actually playing.

This must be called after the device has been opened.

Parameters
callbackthe callback to use for streaming the data.
See also
AudioIODeviceCallback, open

Implements AudioIODevice.

◆ stop()

void iOSAudioIODevice::stop ( )
overridevirtual

Stops the device playing.

Once a device has been started, this will stop it. Any pending calls to the callback class will be flushed before this method returns.

Implements AudioIODevice.

◆ switchApplication()

void iOSAudioIODevice::switchApplication ( )

Friends And Related Function Documentation

◆ AudioSessionHolder

friend struct AudioSessionHolder
friend

◆ iOSAudioIODeviceType

friend struct iOSAudioIODeviceType
friend

◆ Pimpl

friend struct Pimpl
friend

Member Data Documentation

◆ name

String AudioIODevice::name
protectedinherited

◆ pimpl

ScopedPointer<Pimpl> iOSAudioIODevice::pimpl
private

◆ typeName

String AudioIODevice::typeName
protectedinherited

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