AudioToolbox Namespace
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The AudioToolbox namespace provides medium-level classes for recording and playing audio.
Classes
_MidiData |
An abstract base class for MidiMetaEvent and MidiRawData. |
AccessoryInfo |
USB Accessory Information |
AudioBalanceFade |
Holds left/right balance and front/back fade values. |
AudioBuffers |
Encapsulated a series of AudioBuffers. |
AudioChannelLabelExtensions | |
AudioChannelLayout |
Specifies the file or hardware audio channel layout. |
AudioChannelLayoutTagExtensions |
An extension class that provides a ToAudioChannel(AudioChannelLayoutTag) extension method to the AudioChannelLayoutTag class. |
AudioConverter |
The linear PCM audio formats converter. |
AudioFile |
Class used to create audio files or read audio files. |
AudioFileGlobalInfo |
Encapsulates global audio-file information. |
AudioFileInfoDictionary |
Metadata-like information relating to a particular audio file. |
AudioFileMarkerList |
A collection of AudioFileMarkers. |
AudioFileRegionList |
A list of AudioFileRegions. |
AudioFileStream |
Process partial audio files. |
AudioFormatAvailability |
The application developer can use this class to retrieve the properties of available encoders and decoders. |
AudioPanningInfo |
Information on audio panning. |
AudioQueue |
Base class for Input and Output audio queues. |
AudioQueueException |
An exception thrown by the AudioQueue class if there is a problem with the configuration parameters. |
AudioQueueProcessingTap |
Holds the state for an AudioQueue processing tap. |
AudioQueueTimeline |
Objects used to track audio queue timelines |
AudioSession |
Interface to to control the audio context of your application |
AudioSessionException |
Exception thrown by AudioSession's methods if invalid data is passed to AudioSession, or if the session is not properly configured. |
AudioSessionPropertyEventArgs |
Provides data for the event. |
AudioSessionRouteChangeEventArgs |
Provides data for the AudioRouteChanged event. |
AudioSource |
A derived class from AudioFile that exposes virtual methods that can be hooked into (for reading and writing) |
BufferCompletedEventArgs |
Provides data for the BufferCompleted event. |
InputAudioQueue |
An Input Audio Queue, used for audio capturing and recording. |
InputCompletedEventArgs |
Provides data for the InputCompleted event. |
InputSourceInfo |
Input accessory information. |
InstrumentInfo |
Information on an instrument. Returned by GetInstrumentInfo(NSUrl). |
MidiMetaEvent |
Encapsulates a MIDI meta-event such as a time signature, lyrics, etc. |
MidiRawData |
Encapsulates a MIDI System-Exclusive (SysEx) message. |
MusicEventUserData |
A subclass of MidiRawData that describes a user-defined event. |
MusicPlayer |
An object that plays a MusicSequence. |
MusicSequence |
A music sequence. |
MusicTrack |
A music track is a series of time-stamped music events and is a component of a MusicSequence. |
OutputAudioQueue |
The output AudioQueue. |
PacketReceivedEventArgs |
Provides data for the E:AudioToolbox.PacketReceivedEventArgs.PacketDecoded event. |
PropertyFoundEventArgs |
Provides data for the E:AudioToolbox.PropertyFoundEventArgs.PropertyFound event. |
SoundBank |
A MIDI sound bank. |
SystemSound |
Provides methods for producing simple sounds. |
Structs
AudioBuffer |
Represents a collection of audio samples. |
AudioChannelDescription |
Describes an Audio Channel. |
AudioClassDescription |
A class that describes an installed codec. |
AudioConverterPrimeInfo |
The priming information for an audio converter. |
AudioFileMarker |
A class that represents a specific named position within an audio file. |
AudioFilePacketTableInfo |
Represents the number of valid frames in a file and where they begin or end. |
AudioFileRegion |
Represents a named region within an audio file. |
AudioFileSmpteTime |
A struct that encapsulates a Society of Motion Picture and Television Engineers time. |
AudioFormat |
Tuple structure that encapsulates both an AudioChannelLayoutTag and an AudioStreamBasicDescription. |
AudioQueueBuffer |
Represents an audio queue buffer. |
AudioQueueChannelAssignment |
Channel assignments used as a parameter to the SetChannelAssignments(AudioQueueChannelAssignment[]) method. |
AudioQueueLevelMeterState |
Represents the level meter information on an audio channel. |
AudioQueueParameterEvent |
A class that encapsulates values used as |
AudioStreamBasicDescription |
Audio packet stream description. |
AudioStreamPacketDescription |
Describes audio packets that do not have a standard size and packets that are interleaved with non-audio data. |
AudioTimeStamp |
Represents an audio time stamp in various formats. |
AudioValueRange |
A struct that holds minimum and maximum float values, indicating a range. |
CABarBeatTime |
Struct defining bar beat time, for use with MusicSequence methods such as BarBeatTimeToBeats(CABarBeatTime, Double). |
ExtendedNoteOnEvent |
A struct that describes a note-on event with extended parameters. |
MidiChannelMessage |
A struct describing a MIDI channel message. Used by the AddMidiChannelEvent(Double, MidiChannelMessage) method. |
MidiNoteMessage |
Encapsulates a MIDI musical note. |
SmpteTime |
SMPTE-based time representation. SMPTE times are used to synchronize an point in the audio stream with some external event. |
Enums
AudioBalanceFadeType |
An enumeration whose values specify whether balance/fade manipulation should always have a gain of less than 1.0. |
AudioChannelBit |
An enumeration whose values specify constants in the Bitmap property. |
AudioChannelFlags |
Flags for the Flags property. |
AudioChannelLabel |
An enumeration whose values specify the Label property. |
AudioChannelLayoutTag |
An enumeration whose values are valid for channel layout tags. |
AudioCodecComponentType |
Enumeration of values used to specify linear PCM conversions. |
AudioConverterError |
An enumeration whose values specify various types of errors relating to the AudioConverter. |
AudioConverterPrimeMethod |
The prime method constants. |
AudioConverterQuality |
Constants for the rendering quality of the sample rate converter. |
AudioConverterSampleRateConverterComplexity |
Constants for the sample rate conversion algorithm. |
AudioFileChunkType |
An enumeration whose values specify different types of chunks appropriate to audio files. |
AudioFileError |
The error codes returned by AudioFile. |
AudioFileFlags |
An enumeration whose values are valid flags for the M:AudioToolbox.AudioFile.Create* method. |
AudioFileLoopDirection |
An enumeration whose values specify an audio-loop's direction. |
AudioFileMarkerType |
An enumeration whose values specify the P:AudioFileMark.Type property. |
AudioFilePermission |
An enumeration whose values specify the |
AudioFileProperty |
An enumeration whose values represent information about a AudioFile. See the GetProperty(AudioFileStreamProperty, Int32, IntPtr) and SetProperty(AudioFileProperty, Int32, IntPtr) methods. |
AudioFileRegionFlags |
A flagging enumeration whose values are used in the Flags property. |
AudioFileStreamProperty |
An enumeration whose values represent properties of AudioFileStream. |
AudioFileStreamPropertyFlag |
An enumeration whose values flag whether a AudioFileStreamProperty is cached. |
AudioFileStreamStatus |
An enumeration whose values indicate the status following calls to the Seek(Int64, Int64, Boolean) or ParseBytes(Byte[], Int32, Int32, Boolean) methods. |
AudioFileType |
Known audio file types. Used to specify the kind of audio file to create, or as a hint to the audio parser about the contents of the file. |
AudioFormatError |
An enumeration whose values specify various errors relating to audio formats. |
AudioFormatFlags |
Flags describing the stream in the AudioStreamBasicDescription. |
AudioFormatType |
Audio format identifiers used by AudioStreamBasicDescription. |
AudioQueueDeviceProperty |
An enumeration whose values specify properties of an audio queue device (number of channels and sample rate). |
AudioQueueHardwareCodecPolicy |
An enumeration whose values are used for the HardwareCodecPolicy property. |
AudioQueueParameter |
An enumeration whose values specify various parameters of an audio queue. |
AudioQueueProcessingTapFlags |
Flags used when an AudioQueue tap is created, and used by the tap processor callback. |
AudioQueueProperty |
An enumeration whose values specify properties of audio queues. |
AudioQueueStatus |
An enumeration whose values specify the status of an audio queue. |
AudioQueueTimePitchAlgorithm |
An enumeration whose values specify the Time Pitch algorithm. Used with TimePitchAlgorithm. |
AudioServicesError |
An enumeration of values that can be returned by the AddSystemSoundCompletion(Action, CFRunLoop) method. |
AudioSessionActiveFlags |
Flags passed to AudioSession's SetActive method. |
AudioSessionCategory |
Categories for your audio session. |
AudioSessionErrors |
An enumeration whose values can be returned by the SetActive(Boolean, AudioSessionActiveFlags) method or the ErrorCode property. |
AudioSessionInputRouteKind |
The available audio input sources on the device. |
AudioSessionInterruptionState |
An enumeration whose values represent the beginning and end of an audio session interruption. |
AudioSessionInterruptionType |
An enumeration whose values indicate whether the application should resume after an interruption. Returned by the InterruptionType property. |
AudioSessionMode |
The fine detail over the audio mode, an extension to the AudioSession Category |
AudioSessionOutputRouteKind |
An enumeration whose values specify different kinds of output routes. |
AudioSessionProperty |
An enumeration whose values specify properties for audio sessions. |
AudioSessionRouteChangeReason |
The reason for AudioSession route change event to be raised. |
AudioSessionRoutingOverride |
Possible values to override the audio route |
AudioTimeStamp.AtsFlags |
Represents the valid elements in an AudioTimeStamp structure. |
MPEG4ObjectID |
Enumerates MPEG-4 audio data types. |
MusicEventType |
An enumeration whose values describe various music event types. |
MusicPlayerStatus |
An enumeration whose values describe the status of a MusicPlayer. |
MusicSequenceFileFlags |
Can be used to specify that an existing file should be erased when creating a new file. Used with the CreateFile(NSUrl, MusicSequenceFileTypeID, MusicSequenceFileFlags, UInt16) method. |
MusicSequenceFileTypeID |
An enumeration that specifies the type of a music sequence file. |
MusicSequenceLoadFlags |
An enumeration that specifies the |
MusicSequenceType |
An enumeration whose values specify the SequenceType property of a MusicSequence. |
PanningMode |
An enumeration whose values specify the panning mode (sound-field vs. vector-based). |
SmpteTimeFlags |
Enumerates SMTPE time states. |
SmpteTimeType |
An enumeration whose values specify the version of SMPTE time used by a SmpteTime. |
Delegates
AudioConverterComplexInputData |
Delegate associated with the E:AudioToolbox.AudioConverter.AudioConverterComplexInputData event. |
AudioQueue.AudioQueuePropertyChanged |
The delegate to be used with the AddListener(AudioQueueProperty, AudioQueue+AudioQueuePropertyChanged) and RemoveListener(AudioQueueProperty, AudioQueue+AudioQueuePropertyChanged) methods. |
AudioQueueProcessingTapDelegate |
Signature for AudioQueue's Tap callback handlers. |
AudioSession.PropertyListener |
The delegate used with the AddListener(AudioSessionProperty, AudioSession+PropertyListener) and RemoveListener(AudioSessionProperty, AudioSession+PropertyListener) properties. |
MusicSequenceUserCallback |
Remarks
Use AudioToolbox to create your own audio processing applications from the basic building blocks: AudioFile to read and write audio files, AudioFileStream to parse audio files progressively; And use the InputAudioQueue to record as well as OutputAudioQueue to play audio.
In addition to the low-level toolkit to create your own audio processing, the SystemSound can be used to play short audio clips.