ARCore SDK for Android v1.12.0

Breaking & behavioral changes

• The data captured by hostCloudAnchor() (Java) and ArSession_hostAndAcquireNewCloudAnchor() (NDK), which is uploaded to the ARCore Cloud Anchor API service has changed. See https://developers.google.com/ar/develop/java/cloud-anchors/overview-android#how-hosted to learn more.

• resolveCloudAnchor() (Java) and ArSession_resolveAndAcquireNewCloudAnchor() (NDK) will no longer timeout or fail when the ARCore Cloud Anchor API service is unreachable, or the anchor cannot be immediately resolved. Instead, the API will continue to attempt to resolve the provided anchors until they are detached.

  • Java: ERROR_RESOLVING_LOCALIZATION_NO_MATCH and ERROR_SERVICE_UNAVAILABLE enums in CloudAnchorState are now deprecated and will no longer be returned.
  • NDK: AR_CLOUD_ANCHOR_STATE_ERROR_RESOLVING_LOCALIZATION_NO_MATCH and AR_CLOUD_ANCHOR_STATE_ERROR_SERVICE_UNAVAILABLE enums in the ArCloudAnchorState are now deprecated and will no longer be returned.

  These changes only affect apps built with ARCore SDK 1.12 or later. Apps built with older SDKs will not be affected by this change, and will continue to observe old behavior.

New APIs and capabilities

• There is a new enum value that can be set for a Cloud Anchor's state. The ERROR_HOSTING_SERVICE_UNAVAILABLE value will be set for a Cloud Anchor during the hosting process, if the ARCore Cloud Anchor service is unreachable.

Deprecations

• The following enum values in the CloudAnchorState are being deprecated:
  • Java: ERROR_RESOLVING_LOCALIZATION_NO_MATCH and ERROR_SERVICE_UNAVAILABLE enums in CloudAnchorState are now deprecated and will no longer be returned.
  • NDK: AR_CLOUD_ANCHOR_STATE_ERROR_RESOLVING_LOCALIZATION_NO_MATCH and AR_CLOUD_ANCHOR_STATE_ERROR_SERVICE_UNAVAILABLE enums in the ArCloudAnchorState are now deprecated and will no longer be returned.

Other changes

None.

Bug fixes

None.