Platforms to show: All Mac Windows Linux Cross-Platform
Back to AVCaptureDeviceMBS class.
AVCaptureDeviceMBS.activeFormat as AVCaptureDeviceFormatMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You use this property to get or set the currently active device format.
To set the format, you must first obtain exclusive access to the receiver using focusMode. If you do not obtain exclusive access, setActiveFormat throws an NSGenericException.
The set method, setActiveFormat, throws an NSInvalidArgumentException if you pass a format not present in the supportsAVCaptureSessionPreset array.
You can observe changes to the value of this property using key-value observing.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.activeInputSource as AVCaptureDeviceInputSourceMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
You use this property to get or set the currently active input source.
To set the format, you must first obtain exclusive access to the receiver using focusMode. If you do not obtain exclusive access, setActiveInputSource throws an NSGenericException.
The set method, setActiveInputSource, throws an NSInvalidArgumentException if you pass a format not present in the activeInputSource array.
You can observe changes to the value of this property using key-value observing.
(Read and Write property)
AVCaptureDeviceMBS.activeVideoMaxFrameDuration as CMTimeMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 14.0 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
A device's maximum frame duration is the reciprocal of its minimum frame rate. You can set the value of this property to limit the minimum frame rate during a capture session. The capture device automatically chooses a default maximum frame duration based on its active format. After changing the value of this property, you can return to the default maximum frame duration by setting this property's value to kCMTimeInvalid. Choosing a new preset for the capture session also resets this property to its default value.
Attempting to set this property to a value not found in the active format's videoSupportedFrameRateRanges array raises an exception (NSInvalidArgumentException).
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. Otherwise, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
You can observe changes to the value of this property using Key-value observing.
Available in OS X v10.9 and later.
(Read and Write property)
AVCaptureDeviceMBS.activeVideoMinFrameDuration as CMTimeMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You use this property to get or set the currently active minimum frame duration.
The value of this property is the reciprocal of its maximum frame rate. To limit the maximum frame rate, you can set the value of this property to a value supported by the receiver's modelID (see videoSupportedFrameRateRanges).
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
The device object throws NSInvalidArgumentException if you try to assign an unsupported value to this property.
You can observe changes to the value of this property using key-value observing.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.AutoVideoFrameRateEnabled as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
When enabled the receiver automatically adjusts the active frame rate, depending on light level. Under low light conditions, frame rate is decreased to properly expose the scene. For formats with a maximum frame rate of 30 fps, the frame rate switches between 30 - 24. For formats with a maximum frame rate of 60 fps, the frame rate switches between 60 - 30 - 24.
Setting this property throws an NSInvalidArgumentException if the active format's AutoVideoFrameRateSupported returns false. Changing the device's active format resets AutoVideoFrameRateEnabled to its default value of false.
When autoVideoFrameRateEnabled is true, setting activeVideoMinFrameDuration or activeVideoMaxFrameDuration throws an NSInvalidArgumentException.
(Read and Write property)
AVCaptureDeviceMBS.BackgroundReplacementActive as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
(Read only property)
AVCaptureDeviceMBS.canPerformReactionEffects as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 23.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This requires reactionEffectsEnabled to be true, as well as using a AVCaptureDeviceFormat with reactionEffectsSupported.
This readonly property returns YES when resources for reactions are available on the device instance. When true, calls to performEffectForReaction: will render on the video feed, otherwise those calls are ignored. It is key-value observable.
Requires macOS 14.0 or iOS 17.0.
You may check AVCaptureReactionEffectStateMBS.available for whether this is available.
(Read only property)
AVCaptureDeviceMBS.centerStageRectOfInterest as CGRectMBS New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Applications that wish to apply additional processing (such as cropping) on top of Center Stage's output can use this property to guide Center Stage's framing.
The rectangle's origin is top left and is relative to the coordinate space of the output pixel buffer. The default value of this property is the value CGRectMake(0, 0, 1, 1), where {0,0} represents the top left of the picture area, and {1,1} represents the bottom right on an unrotated picture. This rectangle of interest is applied prior to rotation, mirroring or scaling.
Pixels outside of this rectangle of interest will be blackened out.
Setting this property has no impact on objects specified in the metadata output.
Setting this throws an NSGenericException if called without first obtaining exclusive access to the receiver using lockForConfiguration. Set CenterStageRectOfInterest throws an NSInvalidArgumentException if none of the AVCaptureDeviceFormats supported by the receiver support CenterStage. Set CenterStageRectOfInterest throws an NSInvalidArgumentException if centerStageEnabled is false on the AVCaptureDevice class. set CenterStageRectOfInterest throws an NSInvalidArgumentException if the provided rectOfInterest goes outside the normalized (0-1) coordinate space.
(Read and Write property)
AVCaptureDeviceMBS.companionDeskViewCamera as AVCaptureDeviceMBS New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The companionDeskViewCamera property allows you to discover if the receiver has a paired Desk View Camera which derives its desk framing from the receiver's ultra wide frame. In the presence of multiple Continuity Cameras, this property allows you to pair a particular Continuity Camera with its associated Desk View Camera.
(Read only property)
AVCaptureDeviceMBS.continuityCamera as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Access this property to discover if the receiver is a Continuity Camera (external iPhone webcam).
(Read only property)
AVCaptureDeviceMBS.deviceType as String New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
A capture device's type never changes.
(Read only property)
AVCaptureDeviceMBS.displayVideoZoomFactorMultiplier as Double New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
In some system user interfaces, like the macOS Video Effects Menu, the video zoom factor value is displayed in a way most appropriate for visual representation and might differ from the videoZoomFactor property value on the receiver by a fixed ratio. For example, if the videoZoomFactor property value is 1.0 and the displayVideoZoomFactorMultiplier property value is 0.5, then multiplying 1.0 and 0.5 produces 0.5 which can be displayed in the UI. Client applications can key value observe this property to update the display video zoom factor values in their UI to stay consistent with Apple's system UIs.
(Read only property)
AVCaptureDeviceMBS.exposureMode as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Before changing the value of this property, you must call lockForConfiguration: to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
You can observe changes to the value of this property using key-value observing.
See "AVCaptureExposureMode" for possible values.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.exposurePointOfInterest as CGPointMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.flashMode as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Before changing the value of this property, you must call lockForConfiguration: to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
You can observe changes to the value of this property using key-value observing.
See "AVCaptureFlashMode" for possible values.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.focusMode as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
You can observe changes to the value of this property using key-value observing.
See "AVCaptureFocusMode" for possible values.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.focusPointOfInterest as CGPointMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This property represents a CGPoint where {0,0} corresponds to the top left of the picture area, and {1,1} corresponds to the bottom right in landscape mode with the home button on the right—this applies even if the device is in portrait mode.
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
(Read and Write property)
Some examples using this property:
AVCaptureDeviceMBS.Handle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
(Read and Write property)
AVCaptureDeviceMBS.hasFlash as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.hasTorch as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
A torch is a light source, such as an LED flash, that is available on the device and used for illuminating captured content or providing general illumination. This property reflects whether the current device has such illumination hardware built-in.
Even if the device has a torch, that torch might not be available for use. Thus, you should also check the value of the torchAvailable property before using it.
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isAdjustingExposure as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The value of this property represents the transport type of the device (USB, PCI, etc). Transport types are defined in <IOKit/audio/IOAudioTypes.h> as kIOAudioDeviceTransportType*.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isAdjustingFocus as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isAdjustingWhiteBalance as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isCenterStageActive as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This readonly property returns true when Center Stage is currently active on the receiver. When active, the camera automatically adjusts to keep people optimally framed within the field of view. The field of view may pan, tighten or widen as needed. Certain restrictions come into play when Center Stage is active:
- The device's minAvailableVideoZoomFactor and maxAvailableVideoZoomFactor become restricted (see AVCaptureDeviceFormat's videoMinZoomFactorForCenterStage and videoMaxZoomFactorForCenterStage).
- The device's activeVideoMinFrameDuration and activeVideoMaxFrameDuration are limited (see AVCaptureDeviceFormat's videoFrameRateRangeForCenterStage).
Center Stage may be enabled via user control or application control, depending on the current +AVCaptureDevice.centerStageControlMode. When +AVCaptureDevice.centerStageEnabled is true, a particular AVCaptureDevice instance may return true for this property, depending whether it supports the feature in its current configuration. Some device features are mutually exclusive to Center Stage:
- If depth data delivery is enabled on any output, such as AVCaptureDepthDataOutput, or AVCapturePhotoOutput.depthDataDeliveryEnabled, Center Stage is deactivated.
- If geometricDistortionCorrectionSupported is true, geometricDistortionCorrectionEnabled must also be true, or Center Stage is deactivated.
AVCaptureDeviceMBS.isCenterStageRectOfInterestSupported as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This property returns true if the device supports Center Stage Rect of Interest.
(Read only property)
AVCaptureDeviceMBS.isConnected as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The value of this property indicates whether the device represented by the receiver is connected and available for use as a capture device. When the value of this property becomes false for a given instance, however, it will not become true again. If the same physical device again becomes available to the system, it will be represented using a new instance of AVCaptureDevice.
You can observe the value of this property using key-value observing to be notified when a device is no longer available.
(Read only property)
AVCaptureDeviceMBS.isExposurePointOfInterestSupported as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isFocusPointOfInterestSupported as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isInUseByAnotherApplication as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.isRampingVideoZoom as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 22.2 | ❌ No | ❌ No | ❌ No | ✅ Yes | iOS only |
(Read only property)
AVCaptureDeviceMBS.isSuspended as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Some devices disallow data capture due to a feature on the device.
For example, isSuspended returns true for an external iSight camera when its privacy iris is closed, or for the internal iSight camera on a notebook when the notebook's display is closed.
You can observe changes to the value of this property using key-value observing.
(Read only property)
AVCaptureDeviceMBS.isVirtualDevice as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ❌ No | ❌ No | ❌ No | ✅ Yes | All |
Two examples of virtual devices are:
The Dual Camera, which supports seamlessly switching between a wide and telephoto camera while zooming and generating depth data from the disparities between the different points of view of the physical cameras.
The TrueDepth Camera, which generates depth data from disparities between a YUV camera and an Infrared camera pointed in the same direction.
(Read only property)
AVCaptureDeviceMBS.localizedName as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can use this property to display the name of a capture device in a user interface.
(Read only property)
AVCaptureDeviceMBS.manufacturer as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 14.0 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This property can be used to identify capture devices from a particular manufacturer. All Apple devices return "Apple Inc.". Devices from third party manufacturers may return an empty string.
Available on Mac OS X 10.9 or later.
(Read only property)
AVCaptureDeviceMBS.maxAvailableVideoZoomFactor as Double
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 22.2 | ❌ No | ❌ No | ❌ No | ✅ Yes | iOS only |
On single-camera devices, this value is always equal to the device format’s videoMaxZoomFactor value. On a dual-camera device, the allowed range of video zoom factors can change if the device is delivering depth data to one or more capture outputs.
Setting the videoZoomFactor property to (or calling the rampToVideoZoomFactor:withRate method with) a value greater than the device format’s videoMaxZoomFactor value always raises an exception. Setting the video zoom factor to a value between the maximum available zoom factor and the device format’s maximum clamps the zoom setting to the maximum available value.
(Read only property)
AVCaptureDeviceMBS.minAvailableVideoZoomFactor as Double
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 22.2 | ❌ No | ❌ No | ❌ No | ✅ Yes | iOS only |
On single-camera devices, this value is always 1.0. On a dual-camera device, the allowed range of video zoom factors can change if the device is delivering depth data to one or more capture outputs.
Setting the videoZoomFactor property to (or calling the rampToVideoZoomFactor method with) a value less than 1.0 always raises an exception. Setting the video zoom factor to a value between 1.0 and the minimum available zoom factor clamps the zoom setting to the minimum.
(Read only property)
AVCaptureDeviceMBS.modelID as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
The value of this property is an identifier unique to all devices of the same model. The value is persistent across device connections and disconnections, and across different systems. For example, the model ID of the camera built in to two identical iPhone models will be the same even though they are different physical devices.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.position as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
You can observe changes to the value of this property using key-value observing.
See "AVCaptureDevicePosition" for possible values.
(Read only property)
AVCaptureDeviceMBS.StudioLightActive as Boolean New in 25.1
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 25.1 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This readonly property returns true when Studio Light is currently active on the receiver. When active, the subject's face is artificially lit to simulate the presence of a studio light near the camera.
(Read only property)
AVCaptureDeviceMBS.torchMode as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Setting the value of this property also sets the torch level to its maximum current value.
Before setting the value of this property, call the isTorchModeSupported method to make sure the device supports the desired mode. Setting the device to an unsupported torch mode results in the raising of an exception. For a list of possible values for this property, see "AVCaptureTorchMode."
Before changing the value of this property, you must call lockForConfiguration to acquire exclusive access to the device's configuration properties. If you do not, setting the value of this property raises an exception. When you are done configuring the device, call unlockForConfiguration to release the lock and allow other devices to configure the settings.
You can observe changes to the value of this property using key-value observing.
(Read and Write property)
AVCaptureDeviceMBS.transportControlsPlaybackMode as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
This property is only valid for devices that support transport control.
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.transportControlsSpeed as Double
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
For devices that support transport control, the value of this property indicates the current playback speed of the deck. The following table gives examples of the meaning of values:
Value | Meaning |
0.0 | Stopped |
1.0 | Forward at normal speed. |
-1.0 | Reverse at normal speed. |
2.0 | Forward at 2x normal speed. |
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.transportControlsSupported as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
For devices with transport controls, such as AVC tape-based camcorders or pro capture devices with RS422 deck control, the value of this property is true. If transport controls are not supported, none of the associated transport control methods and properties are available on the receiver.
You can observe changes to the value of this property using key-value observing.
(Read only property)
Some examples using this property:
AVCaptureDeviceMBS.transportType as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop, Console & Web |
The value of this property represents the transport type of the device (USB, PCI, etc). Transport types are defined in <IOKit/audio/IOAudioTypes.h> as kIOAudioDeviceTransportType*.
(Read only property)
AVCaptureDeviceMBS.uniqueID as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | AVFoundation | MBS AVFoundation Plugin | 13.2 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | All |
Every available capture device has a unique ID that persists on one system across device connections and disconnections, application restarts, and reboots of the system itself. You can store the value returned by this property to recall or track the status of a specific device in the future.
(Read only property)
The items on this page are in the following plugins: MBS AVFoundation Plugin.
