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 and ArSession_resolveAndAcquireNewCloudAnchor will always have the state AR_CLOUD_ANCHOR_STATE_ERROR_INTERNAL.
• Java: Cloud Anchors returned by Session#hostCloudAnchor(Anchor) and Session#resolveCloudAnchor(java.lang.String) will always have the state Anchor.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 an x86 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().
• Added new APIs for Stereo Camera usage in CameraConfigFilter and CameraConfig:
  • 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.

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.