Platforms to show: All Mac Windows Linux Cross-Platform

Back to AVCaptureDeviceMBS class.

AVCaptureDeviceMBS.authorizationStatusForMediaType(mediaType as string) as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 18.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Returns the client's authorization status for accessing the underlying hardware that supports a given media type.

Mediatype: The media type, either AVMediaTypeVideo or AVMediaTypeAudio.
Returns the authorization status of the client

This method returns the AVAuthorizationStatus of the client for accessing the underlying hardware supporting the media type. Media type constants are defined in AVFoundationMBS. If any media type other than AVMediaTypeVideo or AVMediaTypeAudio is supplied, an NSInvalidArgumentException will be thrown. If the status is AVAuthorizationStatusNotDetermined, you may use the requestAccessForMediaType method to request access by prompting the user.

see
https://developer.apple.com/documentation/avfoundation/cameras_and_media_capture/requesting_authorization_for_media_capture_on_macos?language=objc

Some examples using this method:

AVCaptureDeviceMBS.available as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 13.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Whether this class is available.

Returns true on Mac OS X 10.7 and newer.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInDualCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A device that consists of two fixed focal length cameras, one wide and one telephoto. Note that devices of this type may only be discovered using the discoverDevices function.

A device of this device type supports the following features:

  • Auto switching from one camera to the other when zoom factor, light level, and focus position allow this.
  • Higher quality zoom for still captures by fusing images from both cameras.
  • Depth data delivery by measuring the disparity of matched features between the wide and telephoto cameras.
  • Delivery of photos from constituent devices (wide and telephoto cameras) via a single photo capture request.

A device of this device type does not support the following features:
  • AVCaptureExposureModeCustom and manual exposure bracketing.
  • Locking focus with a lens position other than AVCaptureLensPositionCurrent.
  • Locking auto white balance with device white balance gains other than AVCaptureWhiteBalanceGainsCurrent.

Even when locked, exposure duration, ISO, aperture, white balance gains, or lens position may change when the device switches from one camera to the other. The overall exposure, white balance, and focus position however should be consistent.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInDualWideCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A device that consists of two fixed focal length cameras, one ultra wide and one wide angle. Note that devices of this type may only be discovered using an AVCaptureDeviceDiscoverySession or -[AVCaptureDevice defaultDeviceWithDeviceType:mediaType:position:].

A device of this device type supports the following features:

  • Auto switching from one camera to the other when zoom factor, light level, and focus position allow this.
  • Depth data delivery by measuring the disparity of matched features between the ultra wide and wide cameras.
  • Delivery of photos from constituent devices (ultra wide and wide) via a single photo capture request.

A device of this device type does not support the following features:
  • AVCaptureExposureModeCustom and manual exposure bracketing.
  • Locking focus with a lens position other than AVCaptureLensPositionCurrent.
  • Locking auto white balance with device white balance gains other than AVCaptureWhiteBalanceGainsCurrent.

Even when locked, exposure duration, ISO, aperture, white balance gains, or lens position may change when the device switches from one camera to the other. The overall exposure, white balance, and focus position however should be consistent.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInLiDARDepthCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A device that consists of two cameras, one YUV and one LiDAR. The LiDAR camera provides high quality, high accuracy depth information by measuring the round trip of an artificial light signal emitted by a laser. The depth is synchronized and perspective corrected to frames produced by the paired YUV camera. While the resolution of the depth data and YUV frames may differ, their field of view and aspect ratio always match. Note that devices of this type may only be discovered using the discoverDevices function.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInTelephotoCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A built-in camera device with a longer focal length than a wide angle camera. Note that devices of this type may only be discovered using an AVCaptureDeviceDiscoverySession.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInTripleCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A device that consists of three fixed focal length cameras, one ultra wide, one wide angle, and one telephoto. Note that devices of this type may only be discovered using an AVCaptureDeviceDiscoverySession or -[AVCaptureDevice defaultDeviceWithDeviceType:mediaType:position:].

A device of this device type supports the following features:

  • Auto switching from one camera to the other when zoom factor, light level, and focus position allow this.
  • Delivery of photos from constituent devices (ultra wide, wide and telephoto cameras) via a single photo capture request.

A device of this device type does not support the following features:
  • AVCaptureExposureModeCustom and manual exposure bracketing.
  • Locking focus with a lens position other than AVCaptureLensPositionCurrent.
  • Locking auto white balance with device white balance gains other than AVCaptureWhiteBalanceGainsCurrent.

Even when locked, exposure duration, ISO, aperture, white balance gains, or lens position may change when the device switches from one camera to the other. The overall exposure, white balance, and focus position however should be consistent.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInTrueDepthCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A device that consists of two cameras, one YUV and one Infrared. The infrared camera provides high quality depth information that is synchronized and perspective corrected to frames produced by the YUV camera. While the resolution of the depth data and YUV frames may differ, their field of view and aspect ratio always match. Note that devices of this type may only be discovered using the discoverDevices function.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInUltraWideCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A built-in camera device with a shorter focal length than a wide angle camera. Note that devices of this type may only be discovered using an AVCaptureDeviceDiscoverySession.

AVCaptureDeviceMBS.AVCaptureDeviceTypeBuiltInWideAngleCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A built-in wide angle camera device. These devices are suitable for general purpose use.

AVCaptureDeviceMBS.AVCaptureDeviceTypeContinuityCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A continuity camera device. These devices are suitable for general purpose use. Note that devices of this type may only be discovered using the discoverDevices function.

AVCaptureDeviceMBS.AVCaptureDeviceTypeDeskViewCamera as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A distortion corrected cut out from an ultra wide camera, made to approximate an overhead camera pointing at a desk. Supports multicam operation.

AVCaptureDeviceMBS.AVCaptureDeviceTypeExternal as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

An external device type. On iPad, external devices are those that conform to the UVC (USB Video Class) specification.

AVCaptureDeviceMBS.AVCaptureDeviceTypeMicrophone as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 25.1 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the device type constants.

A microphone. On iOS and tvOS, only one AVCaptureDevice of type AVCaptureDeviceTypeMicrophone is exposed to the system. The audio routing subsystem decides which physical microphone to use, be it a built in microphone, a wired headset, an external microphone, etc. The microphone device's `localizedName` will change as the audio subsystem switches to a different physical device.

AVCaptureDeviceMBS.AVCaptureMaxAvailableTorchLevel as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method AVFoundation MBS AVFoundation Plugin 14.0 ✅ Yes ❌ No ❌ No ✅ Yes All
The maximum torch level.

This constant always represents the maximum available torch level, independent of the actual maximum value currently supported by the device. Thus, pass this constant to the setTorchModeOnWithLevel:error: in situations where you want to specify the maximum torch level without having to worry about whether the device is overheating and might not accept a value of 1.0 as the maximum.
Available in OS X v10.9 and later.

The items on this page are in the following plugins: MBS AVFoundation Plugin.


The biggest plugin in space...