Swiftpack.co - Swift Packages by google-ar

The markdown parsing is broken/disabled for release notes. Sorry about that, I'm chasing the source of a crash that's been bringing this website down for the last couple of days. ## Breaking & behavioral changes None. ## New APIs and capabilities None. ## Deprecations None. ## Other changes None. ## Bug fixes * Various bug fixes and performance improvements. ## Breaking & behavioral changes None. ## New APIs and capabilities None. ## Deprecations None. ## Other changes None. ## Bug fixes * Various bug fixes and performance improvements. ## New APIs and capabilities The new [ARCore Scene Semantics API](https://developers.google.com/ar/develop/scene-semantics) is now available on iOS. Scene Semantics runs an ML model on the camera image feed and provides a semantic image with each pixel corresponding to one of 11 labels of outdoor concepts. * [`GARFrame.semanticImage`](https://developers.google.com/ar/reference/ios/interface/GARFrame#semanticImage): Provides the semantic labelling image for the last camera image. * [`GARFrame.semanticConfidenceImage`](https://developers.google.com/ar/reference/ios/interface/GARFrame#semanticConfidenceImage): Provides the confidence values for each pixel in the semantic image. * [`GARSessionConfiguration.semanticMode`](https://developers.google.com/ar/reference/ios/interface/GARSessionConfiguration#semanticMode): Configuration option enabling semantics. * [`GARSemanticLabel`](https://developers.google.com/ar/reference/ios/interface/GARSemanticLabel): Enum for semantic label classes. ## Other changes * The SDK no longer supports deployment targets < 12.0. ## Bug fixes * [#139](https://github.com/google-ar/arcore-unity-extensions/issues/139): Fixed a crash caused by creating Rooftop or Terrain Anchors outside of supported areas. ## Known issues * None. ## Breaking & behavioral changes * None. ## New APIs and capabilities * None. ## Deprecations * None. ## Other changes * None. ## Bug fixes * Various bug fixes and performance improvements. ## Bug fixes * Various bug fixes and performance improvements. ## New APIs and capabilities ### Streetscape Geometry Streetscape Geometry is a new ARCore Geospatial API that provides the geometry of buildings and terrain in an area around the user when the Geospatial API is enabled. See [Streetscape Geometry Developer Guide (iOS)](https://developers.google.com/ar/develop/ios/geospatial/streetscape-geometry) for more information. Additionally, the [GeospatialExample app](https://github.com/google-ar/arcore-ios-sdk/tree/master/Examples/GeospatialExample) has been updated to include Streetscape Geometry. * [`GARStreetscapeGeometry`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry): * [`GARStreetscapeGeometry.mesh`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#mesh) provides 3D meshes. * [`GARStreetscapeGeometry.meshTransform`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#meshtransform) provides the origin transform of the geometry relative to the session's world space. * [`GARStreetscapeGeometry.trackingState`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#trackingstate) maintains the tracking state. * [`GARStreetscapeGeometry.type`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#type) indicates if it is terrain or building geometry. * [`GARStreetscapeGeometry.quality`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#quality) provides the quality of geometry. * [`GARStreetscapeGeometry.identifier`](https://developers.google.com/ar/reference/ios/interface/GARStreetscapeGeometry#identifier) provides the unique identifier for the geometry. * [`GARSession.createAnchorOnStreetscapeGeometry:transform:error:`](https://developers.google.com/ar/reference/ios/interface/GARSession#createanchoronstreetscapegeometry:transform:error:) creates an anchor at the specified location and orientation. * [`GARSession.raycastStreetscapeGeometry:direction:error:`](https://developers.google.com/ar/reference/ios/interface/GARSession#raycaststreetscapegeometry:direction:error:) performs a raycast against Streetscape Geometry loaded in the scene. ### Rooftop anchors Rooftop anchors are a new Geospatial anchor type that helps you anchor content to a rooftop. See [Geospatial anchors (iOS)](https://developers.google.com/ar/develop/ios/geospatial/anchors#rooftop-anchors) for more information. Additionally, the [GeospatialExample app](https://github.com/google-ar/arcore-ios-sdk/tree/master/Examples/GeospatialExample) has been updated to include Rooftop anchors. * [`GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:`](https://developers.google.com/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveRooftop:eastupsouthqanchor:completionHandler:error:) creates a Rooftop anchor at the specified location, altitude above the rooftop in meters and orientation relative to the Earth. * [`GARCreateAnchorOnRooftopFuture`](https://developers.google.com/ar/reference/ios/interface/GARCreateAnchorOnRooftopFuture) holds the asynchronous state of resolving a Rooftop anchor. * [`GARRooftopAnchorState`](https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState) describes the state of resolving a Rooftop anchor. ### ARCore async APIs This release introduces new ARCore async APIs to improve ergonomics when working with asynchronous operations, following the Future paradigm. * Resolving Terrain anchors: Use [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:`] to obtain a [`GARCreateAnchorOnTerrainFuture`]. The old symbol [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:`] has been deprecated and may be removed in a later version of ARCore. * Resolving Cloud anchors: Use [`GARSession.resolveCloudAnchorWithIdentifier:completionHandler:error:`] to obtain a [`GARResolveCloudAnchorFuture`]. The old symbol [`GARSession.resolveCloudAnchorWithIdentifier:error:`] has been deprecated and may be removed in a later version of ARCore. * Hosting Cloud anchors: Use [`GARSession.hostCloudAnchor:TTLDays:completionHandler:error:`] to obtain a [`GARHostCloudAnchorFuture`]. The old symbols [`GARSession.hostCloudAnchor:error:`] and [`GARSession.hostCloudAnchor:TTLDays:error:`] have been deprecated and may be removed in a later version of ARCore. [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveterrain:eastupsouthqanchor:completionhandler:error: [`GARCreateAnchorOnTerrainFuture`]: https://developers.google.com/ar/reference/ios/interface/GARCreateAnchorOnTerrainFuture [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveterrain:eastupsouthqanchor:error: [`GARSession.resolveCloudAnchorWithIdentifier:completionHandler:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#resolvecloudanchorwithidentifier:completionHandler:error: [`GARResolveCloudAnchorFuture`]: https://developers.google.com/ar/reference/ios/interface/GARResolveCloudAnchorFuture [`GARSession.resolveCloudAnchorWithIdentifier:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#resolvecloudanchorwithidentifier:error: [`GARSession.hostCloudAnchor:TTLDays:completionHandler:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#hostcloudanchor:ttldays:completionhandler:error: [`GARHostCloudAnchorFuture`]: https://developers.google.com/ar/reference/ios/interface/GARHostCloudAnchorFuture [`GARSession.hostCloudAnchor:TTLDays:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#hostcloudanchor:ttldays:error: [`GARSession.hostCloudAnchor:error:`]: https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#hostcloudanchor:error: ## Deprecations * With the addition of asynchronous Cloud Anchor and Terrain Anchor methods, the following are now obsolete and deprecated: * [`GARAnchor(Geospatial)`](https://developers.google.com/ar/reference/ios/category/GARAnchor(Geospatial)) * [`GARAnchor.terrainState`](https://developers.google.com/ar/reference/ios/category/GARAnchor(Geospatial)#terrainstate) * [`GARTerrainAnchorStateTaskInProgress`](https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstatetaskinprogress) * [`GARAnchor(CloudAnchors)`](https://developers.google.com/ar/reference/ios/category/GARAnchor(CloudAnchors)) * [`GARAnchor.cloudIdentifier`](https://developers.google.com/ar/reference/ios/category/GARAnchor(CloudAnchors)#cloudidentifier) * [`GARAnchor.cloudState`](https://developers.google.com/ar/reference/ios/category/GARAnchor(CloudAnchors)#cloudstate) * [`GARCloudAnchorStateTaskInProgress`](https://developers.google.com/ar/reference/ios/group/GARCloudAnchorState#garcloudanchorstatetaskinprogress) * [`GARSession.hostCloudAnchor:error:`](https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#hostcloudanchor:error:) * [`GARSession.hostCloudAnchor:TTLDays:error:`](https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#hostcloudanchor:ttldays:error:) * [`GARSession.resolveCloudAnchorWithIdentifier:error:`](https://developers.google.com/ar/reference/ios/category/GARSession(CloudAnchors)#resolvecloudanchorwithidentifier:error:) * [`GARSessionDelegate`](https://developers.google.com/ar/reference/ios/protocol/GARSessionDelegateP) * [`GARSessionDelegate.session:didFailToHostAnchor:`](https://developers.google.com/ar/reference/ios/protocol/GARSessionDelegateP#session:didfailtohostanchor:) * [`GARSessionDelegate.session:didHostAnchor:`](https://developers.google.com/ar/reference/ios/protocol/GARSessionDelegateP#session:didhostanchor:) * [`GARSessionDelegate.session:didFailToResolveAnchor:`](https://developers.google.com/ar/reference/ios/protocol/GARSessionDelegateP#session:didfailtoresolveanchor:) * [`GARSessionDelegate.session:didResolveAnchor:`](https://developers.google.com/ar/reference/ios/protocol/GARSessionDelegateP#session:didresolveanchor:) * [`GARSession.delegate`](https://developers.google.com/ar/reference/ios/interface/GARSession#delegate) * [`GARSession.delegateQueue`](https://developers.google.com/ar/reference/ios/interface/GARSession#delegatequeue) * [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:`](https://developers.google.com/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveterrain:eastupsouthqanchor:error:) ## Other changes * [`GARFuture`](https://developers.google.com/ar/reference/ios/interface/GARFuture) is a new base type for async operations with property [`GARFuture.state`](https://developers.google.com/ar/reference/ios/interface/GARFuture#state) and method [`GARFuture.cancel`](https://developers.google.com/ar/reference/ios/interface/GARFuture#state). [`GARVPSAvailabilityFuture`](https://developers.google.com/ar/reference/ios/interface/GARVPSAvailabilityFuture) now extends `GARFuture`. ## Other Changes * The ARCore iOS SDK now officially supports Swift Package Manager. See [Enable AR in your iOS app](https://developers.google.com/ar/develop/ios/enable-arcore) for instructions on how to integrate with ARCore using Swift Package Manager. * Adds copyright statements added to files that were inadvertently missing them previously. ## Bug fixes * Various bug fixes and performance improvements. ## New APIs and capabilities * All Geospatial transforms now expose their orientation accuracy of the Yaw rotation, replacing heading accuracy. * [`GARGeospatialTransform.orientationYawAccuracy`](https://developers.google.com/ar/reference/ios/interface/GARGeospatialTransform#orientationYawAccuracy) ## Deprecations * [`GARGeospatialTransform.heading`](https://developers.google.com/ar/reference/ios/interface/GARGeospatialTransform#heading) has been deprecated. Please use [`GARGeospatialTransform.eastUpSouthQTarget`](https://developers.google.com/ar/reference/ios/interface/GARGeospatialTransform#eastUpSouthQTarget) instead. * [`GARGeospatialTransform.headingAccuracy`](https://developers.google.com/ar/reference/ios/interface/GARGeospatialTransform#headingAccuracy) has been deprecated. Please use [`GARGeospatialTransform.orientationYawAccuracy`](https://developers.google.com/ar/reference/ios/interface/GARGeospatialTransform#orientationYawAccuracy) instead. ## Other changes * ARCore Geospatial API [`checkVPSAvailabilityAtCoordinate:completionHandler`](https://developers.google.com/ar/reference/ios/interface/GARSession#checkvpsavailabilityatcoordinate:completionhandler:) will continue to retry silently in the background if it is unable to establish a connection to the ARCore service for 5 seconds. ## New APIs and capabilities * A new ARCore Geospatial API has been added to check for Visual Positioning System (VPS) availability at a specified horizontal position at runtime. This API can be used without an active AR session, for example, to present an "Enter AR" button only when VPS is available. See <a href="https://developers.google.com/ar/develop/ios/geospatial/check-vps-availability">Check VPS Availability</a> for more information and a usage example. * [`GARSession.checkVPSAvailabilityAtCoordinate:completionHandler:`](https://developers.google.com/ar/reference/ios/category_g_a_r_session_07_geospatial_08#ab4c2672d3a5f1869663ddb72d1c83189) * Geospatial transforms now expose their orientation in 3D space. * [`GARGeospatialTransform.eastUpSouthQTarget`](https://developers.google.com/ar/reference/ios/interface_g_a_r_geospatial_transform#abd5921fc07dca0e1e2c9ce3c1c2e637b) * [`GARSession.geospatialTransformFromTransform:error:`](https://developers.google.com/ar/reference/ios/category_g_a_r_session_07_geospatial_08#a8f34a2bedb4a1b2a41fcbdb9d3358e0c) * [`GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error:`](https://developers.google.com/ar/reference/ios/category_g_a_r_session_07_geospatial_08#a822bc1ce5bb3c1963568fb6c8cc9207c). Note that Geospatial poses obtained from these functions have a heading value set to zero. Instead, use [`GARGeospatialTransform.eastUpSouthQTarget`](https://developers.google.com/ar/reference/ios/interface_g_a_r_geospatial_transform#abd5921fc07dca0e1e2c9ce3c1c2e637b). ## Deprecations None. ## Bug fixes * Fixed a bug where the Geospatial API would return auth errors when using Signed JWT authentication. ## Breaking & behavioral changes To use Cloud Anchors, you must now enable the [ARCore API](https://console.cloud.google.com/apis/library/arcore) instead of the older [ARCore Cloud Anchor API](https://console.cloud.google.com/apis/library/arcorecloudanchor.googleapis.com), which is now deprecated. To support older app versions, you may enable both while making the transition. Apps built with ARCore SDK 1.32.0 and lower will target the older API, while apps built with ARCore SDK 1.33.0 and higher will target the new API. Note the following: * The new API uses the domain name `arcore.googleapis.com` instead of `arcorecloudanchor.googleapis.com`. * If you are using Signed JWTs to authenticate, you will need to change the `audience` claim to `https://arcore.googleapis.com/` for apps built with ARCore SDK 1.33.0 and higher. * If you are using an API Key which is restricted by API, you must allow the ARCore API. * If you send requests to the ARCore Cloud Anchor Management API from your backend, you must also change the domain name to `arcore.googleapis.com`, after enabling the ARCore API. * The old API/endpoint will continue to be supported through August 2023. * See [ARCore 1.33 Cloud Anchor endpoint changes](https://developers.google.com/ar/develop/cloud-anchors/endpoint-changes) for more details. ## New APIs and capabilities [ARCore Geospatial Terrain anchor API](https://developers.google.com/ar/develop/ios/geospatial/terrain-anchors) creates an anchor at a specified horizontal position and altitude relative to the horizontal position's terrain. * [`GARAnchor.terrainState`](https://developers.google.com/ar/reference/ios/category_g_a_r_anchor_07_geospatial_08#aa70e610288fc6447167fba1d572004b8) describes the current Terrain anchor state of GARAnchor. * [`GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:error:`](https://developers.google.com/ar/reference/ios/category_g_a_r_session_07_geospatial_08#a5f5941073ee7b5621989d3a692125933) creates a Geospatial Terrain anchor at the specified location and altitude above the terrain in meters and orientation relative to the Earth. ## Deprecations None. ## Other changes * Updates for Xcode 14 - see [Xcode 14 Release Notes](https://developer.apple.com/documentation/Xcode-Release-Notes/xcode-14-release-notes): * SDK binaries no longer contain bitcode, as Apple has deprecated bitcode. * SDK binaries no longer contain 32-bit architectures, as Xcode 14 does not support these. * The SDK no longer supports deployment targets < 11.0, as Xcode 14 does not support these. * SDK binaries now contain the arm64 simulator architecture for Macs with Apple Silicon. * SDK binaries are now packaged as XCFrameworks. * The SDK now includes Beta support for Swift Package Manager. See README.md for how to integrate with ARCore using Swift Package Manager. ## Bug fixes * Various bug fixes and performance improvements.