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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.