ARCore SDK for Android v1.21.0
Upcoming breaking change affecting Cloud Anchors apps built using ARCore SDK 1.11.0 or earlier
Beginning in December 2020, AR-enabled apps built using ARCore SDK 1.11.0 or earlier will no longer be able to host or resolve Cloud Anchors.
- C: Cloud Anchors returned by
ArSession_hostAndAcquireNewCloudAnchor
andArSession_resolveAndAcquireNewCloudAnchor
will always have the stateAR_CLOUD_ANCHOR_STATE_ERROR_INTERNAL
. - Java: Cloud Anchors returned by
Session#hostCloudAnchor(Anchor)
andSession#resolveCloudAnchor(java.lang.String)
will always have the stateAnchor.CloudAnchorState.ERROR_INTERNAL
.
Apps built with ARCore SDK 1.12.0 or later are unaffected. Their use of Cloud Anchors APIs is covered by the Cloud Anchors deprecation policy.
Known issues
- Issue 141500087: When using Android Emulator
x86_64
system images on macOS with ARCore SDK 1.16.0 or later, Google Play Services for AR will crash. As a workaround, use anx86
system image.
Breaking & behavioral changes
None.
New APIs and capabilities
- Added Recording and Playback of ARCore datasets. The Recording feature lets the app capture the data required to replay the AR session.
- C: Developer guide,
ArSession_startRecording()
,ArSession_stopRecording()
,ArRecordingConfig()
,ArSession_getRecordingStatus()
,ArSession_getPlaybackStatus()
,ArSession_setPlaybackDataset()
. - Java: Developer guide,
session.startRecording(recordingConfig)
,session.stopRecording()
,RecordingConfig()
,session.getRecordingStatus()
,session.setPlaybackDataset()
,session.getPlaybackStatus()
.
- C: Developer guide,
- Added new APIs for Stereo Camera usage in
CameraConfigFilter
andCameraConfig
:- C: Developer guide,
ArCameraConfigFilter_getStereoCameraUsage()
ArCameraConfigFilter_setStereoCameraUsage()
ArCameraConfig_getStereoCameraUsage()
. - Java: Developer guide,
CameraConfigFilter.getStereoCameraUsage()
,CameraConfigFilter.setStereoCameraUsage()
.CameraConfig.getStereoCameraUsage()
. - Support for stereo camera depth is expected to become available in ARCore SDK 1.22.0.
- C: Developer guide,
Deprecations
None.
Other changes
- C: Updated
ArCoreApk_requestInstall
to clarify runtime behavior, noting when and how ARCore device profile data is downloaded and updated. - Java: Updated hello_ar_java to use Environmental HDR Lighting Estimation mode.
Bug fixes
- Fixed memory leak in hello_ar_c, which now correctly releases acquired depth images.
- Fixed crash in hello_ar_java which occurred on certain GPUs.