---

QTCaptureDeviceInput Class Reference

Overview

This class represents the input source for media devices, such as cameras and microphones. Instances of QTCaptureDeviceInput are input sources for QTCaptureSession that provide media data from devices connected to the computer. Devices used with QTCaptureDeviceInput can be found using the QTCaptureDevice class. A QTCaptureDevice must be successfully opened using the open: method before being used in a QTCaptureDeviceInput.

Tasks

Capturing Device Input

• – device
• – initWithDevice:
• + deviceInputWithDevice:

Class Methods

deviceInputWithDevice:

Returns an autoreleased instance of QTCaptureDeviceInput associated with the given device.

+ (id)deviceInputWithDevice:(QTCaptureDevice *)device

Parameters

device

A QTCaptureDevice for the device to be associated with the receiver. The device must have been previously opened using the open: method or this method will throw an NSInvalidArgumentException.

Return Value

A QTCaptureDeviceInput instance associated with the device.

Availability

• Mac OS X v10.5 and later.

Related Sample Code

• LiveVideoMixer3

Declared In

QTCaptureDeviceInput.h

Instance Methods

device

Returns the device associated with the receiver.

- (QTCaptureDevice *)device

Return Value

If there is a device associated with the receiver, returns a corresponding instance of QTCaptureDevice. Otherwise returns NIL.

Availability

• Mac OS X v10.5 and later.

Declared In

QTCaptureDeviceInput.h

initWithDevice:

Returns an instance of QTCaptureDeviceInput associated with the given device.

- (id)initWithDevice:(QTCaptureDevice *)device

Parameters

device

A QTCaptureDevice object for the device to be associated with the receiver. The device must have been previously opened using the open: method, or else this method will throw an NSInvalidArgumentException.

Return Value

A QTCaptureDeviceInput instance associated with the device.

Availability

• Mac OS X v10.5 and later.

Declared In

QTCaptureDeviceInput.h

---