When used as a camera filter, via CameraConfigFilter.setStereoCameraUsage(EnumSet),
indicates that ARCore will not attempt to use a stereo multi-camera , even if one
is present. Can be used to limit power consumption. Available on all ARCore supported
devices.
When returned by CameraConfig.getStereoCameraUsage(), indicates that the camera config will
not use a stereo camera, even if one is present on the device.
public
static
final
CameraConfig.StereoCameraUsage
REQUIRE_AND_USE
When used as a camera filter, via CameraConfigFilter.setStereoCameraUsage(EnumSet),
indicates that a stereo multi-camera must be
present on the device, and the stereo camera must be used by ARCore. Increases CPU and device
power consumption. Not supported on all devices.
Currently not supported when SharedCamera API is used to share
control of the camera with ARCore.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eCameraConfig.StereoCameraUsage\u003c/code\u003e is an enum defining how ARCore utilizes stereo cameras on a device.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDO_NOT_USE\u003c/code\u003e signifies that ARCore will not utilize a stereo camera, even if available, potentially reducing power consumption.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eREQUIRE_AND_USE\u003c/code\u003e indicates that a stereo camera must be present and used by ARCore, potentially increasing performance but also power consumption.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003eDO_NOT_USE\u003c/code\u003e is supported on all ARCore devices, \u003ccode\u003eREQUIRE_AND_USE\u003c/code\u003e has limited device compatibility and is currently incompatible with the \u003ccode\u003eSharedCamera\u003c/code\u003e API.\u003c/p\u003e\n"]]],[],null,["# CameraConfig.StereoCameraUsage\n\n`\npublic static final enum\n`**CameraConfig.StereoCameraUsage**`\n` \nStereo camera usage. \n\nInherited Methods\n-----------------\n\nFrom `class\njava.lang.Enum` \n\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` final `[Object](https://developer.android.com/reference/java/lang/Object)` ` | clone`()` |\n| ` final int ` | compareTo`(`[CameraConfig.StereoCameraUsage](/ar/reference/java/com/google/ar/core/CameraConfig.StereoCameraUsage)` arg0)` |\n| ` int ` | compareTo`(`[Object](https://developer.android.com/reference/java/lang/Object)` arg0)` |\n| ` final Optional\u003cEnumDesc\u003c`[CameraConfig.StereoCameraUsage](/ar/reference/java/com/google/ar/core/CameraConfig.StereoCameraUsage)`\u003e\u003e ` | describeConstable`()` |\n| ` final boolean ` | equals`(`[Object](https://developer.android.com/reference/java/lang/Object)` arg0)` |\n| ` final void ` | finalize`()` |\n| ` final `[Class](https://developer.android.com/reference/java/lang/Class)`\u003c`[CameraConfig.StereoCameraUsage](/ar/reference/java/com/google/ar/core/CameraConfig.StereoCameraUsage)`\u003e ` | getDeclaringClass`()` |\n| ` final int ` | hashCode`()` |\n| ` final `[String](https://developer.android.com/reference/java/lang/String)` ` | name`()` |\n| ` final int ` | ordinal`()` |\n| ` `[String](https://developer.android.com/reference/java/lang/String)` ` | toString`()` |\n| ` static \u003cT extends `[Enum](https://developer.android.com/reference/java/lang/Enum)`\u003cT\u003e\u003e T ` | valueOf`(`[Class](https://developer.android.com/reference/java/lang/Class)`\u003cT\u003e arg0, `[String](https://developer.android.com/reference/java/lang/String)` arg1)` |\n\nFrom `class\njava.lang.Object` \n\n|---------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|\n| ` `[Object](https://developer.android.com/reference/java/lang/Object)` ` | clone`()` |\n| ` boolean ` | equals`(`[Object](https://developer.android.com/reference/java/lang/Object)` arg0)` |\n| ` void ` | finalize`()` |\n| ` final `[Class](https://developer.android.com/reference/java/lang/Class)`\u003c?\u003e ` | getClass`()` |\n| ` int ` | hashCode`()` |\n| ` final void ` | notify`()` |\n| ` final void ` | notifyAll`()` |\n| ` `[String](https://developer.android.com/reference/java/lang/String)` ` | toString`()` |\n| ` final void ` | wait`(long arg0, int arg1)` |\n| ` final void ` | wait`(long arg0)` |\n| ` final void ` | wait`()` |\n\nFrom `interface\njava.lang.constant.Constable` \n\n|-----------------------------------------------|-----------------------|\n| ` abstract Optional\u003c? extends ConstantDesc\u003e ` | describeConstable`()` |\n\nFrom `interface\njava.lang.Comparable` \n\n|------------------|----------------------------------------------------------------------------------------------------------------------------|\n| ` abstract int ` | compareTo`(`[CameraConfig.StereoCameraUsage](/ar/reference/java/com/google/ar/core/CameraConfig.StereoCameraUsage)` arg0)` |\n\nEnum Values\n-----------\n\n#### public\nstatic\nfinal\nCameraConfig.StereoCameraUsage\nDO_NOT_USE\n\n### DO_NOT_USE\n\n```java\npublic static final CameraConfig.StereoCameraUsage DO_NOT_USE\n``` \nWhen used as a camera filter, via [CameraConfigFilter.setStereoCameraUsage(EnumSet)](/ar/reference/java/com/google/ar/core/CameraConfigFilter#setStereoCameraUsage(java.util.EnumSet\u003ccom.google.ar.core.CameraConfig.StereoCameraUsage\u003e)),\nindicates that ARCore will not attempt to use a stereo [multi-camera](https://source.android.com/devices/camera/multi-camera) , even if one\nis present. Can be used to limit power consumption. Available on all ARCore supported\ndevices.\n\nWhen returned by [CameraConfig.getStereoCameraUsage()](/ar/reference/java/com/google/ar/core/CameraConfig#getStereoCameraUsage()), indicates that the camera config will\nnot use a stereo camera, even if one is present on the device.\n\n#### public\nstatic\nfinal\nCameraConfig.StereoCameraUsage\nREQUIRE_AND_USE\n\n### REQUIRE_AND_USE\n\n```java\npublic static final CameraConfig.StereoCameraUsage REQUIRE_AND_USE\n``` \nWhen used as a camera filter, via [CameraConfigFilter.setStereoCameraUsage(EnumSet)](/ar/reference/java/com/google/ar/core/CameraConfigFilter#setStereoCameraUsage(java.util.EnumSet\u003ccom.google.ar.core.CameraConfig.StereoCameraUsage\u003e)),\nindicates that a stereo [multi-camera](https://source.android.com/devices/camera/multi-camera) must be\npresent on the device, and the stereo camera must be used by ARCore. Increases CPU and device\npower consumption. Not supported on all devices.\n\nCurrently not supported when [SharedCamera](/ar/reference/java/com/google/ar/core/SharedCamera) API is used to share\ncontrol of the camera with ARCore.\n\nWhen returned by [CameraConfig.getStereoCameraUsage()](/ar/reference/java/com/google/ar/core/CameraConfig#getStereoCameraUsage()), indicates that a stereo camera is\npresent on the device and will be used by ARCore."]]