Mac OS X Reference Library Apple Developer
Search

QTCaptureDecompressedAudioOutput Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/QTKit.framework
Availability
Available in QuickTime 7.6.3 and later.
Declared in
QTCaptureDecompressedAudioOutput.h

Overview

This class represents an output destination for a QTCaptureSession object that can be used to process audio sample buffers from the audio being captured. Instances of QTCaptureDecompressedAudioOutput produce audio sample buffers suitable for custom high-quality realtime processing. Applications can access the audio sample buffers via the captureOutput:didOutputAudioSampleBuffer:fromConnection: delegate method. Clients can also create subclasses of QTCaptureDecompressedAudioOutput to add custom capturing behavior.

Tasks

Decompressing Audio Output

Instance Methods

delegate

Returns the receiver’s delegate.

- (id)delegate

Availability
  • Mac OS X v10.5 and later; QuickTime 7.6.3.
Declared In
QTCaptureDecompressedAudioOutput.h

outputAudioSampleBuffer:fromConnection:

Called whenever the receiver outputs a new audio sample buffer.

- (void)outputAudioSampleBuffer:(QTSampleBuffer *)sampleBuffer fromConnection:(QTCaptureConnection *)connection

Parameters
sampleBuffer

A sample buffer containing the audio data and additional information about the buffer, such as its presentation time.

connection

The connection from which the audio was received.

Discussion

This method should not be invoked directly. Subclasses can override this method to provide custom processing behavior for each sample buffer. The default implementation calls the delegate’s captureOutput:didOutputAudioSampleBuffer:fromConnection: method.

Subclasses should not assume that this method will be called on the main thread. In addition, this method is called periodically, so it must be efficient to prevent capture performance problems.

Availability
  • Mac OS X v10.5 and later; QuickTime 7.6.3.
Declared In
QTCaptureDecompressedAudioOutput.h

setDelegate:

Sets the receiver’s delegate.

- (void)setDelegate:(id)delegate

Availability
  • Mac OS X v10.5 and later; QuickTime 7.6.3.
Declared In
QTCaptureDecompressedAudioOutput.h

Delegate Methods

captureOutput:didOutputAudioSampleBuffer:fromConnection:

Called whenever the audio data output outputs a new audio sample buffer.

- (void)captureOutput:(QTCaptureOutput *)captureOutput didOutputAudioSampleBuffer:(QTSampleBuffer *)sampleBuffer fromConnection:(QTCaptureConnection *)connection

Parameters
captureOutput

The QTCaptureDecompressedAudioOutput instance that output the frame.

sampleBuffer

A sample buffer containing the audio data and additional information about the buffer, such as its presentation time.

connection

The connection from which the audio was received.

Discussion

Delegates receive this message whenever the output produces a new audio sample buffer. Delegates can use the provided sample buffer for custom processing of captured audio.

Delegates should not assume that this method will be called on the main thread. In addition, this method is called periodically, so it must be efficient to prevent capture performance problems.

Availability
  • Mac OS X v10.5 and later; QuickTime 7.6.3.
Declared In
QTCaptureDecompressedAudioOutput.h



Last updated: 2009-05-20

Did this document help you? Yes It's good, but... Not helpful...