From 7aeed4c2c3bd363f816c34582c673d6b4b2073bf Mon Sep 17 00:00:00 2001 From: jlacoche <jeremy.lacoche@orange.com> Date: Wed, 18 Dec 2024 17:25:22 +0100 Subject: [PATCH] Add documentation for VisionOS Image Tracking --- README.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ddda2ae..7374b96 100644 --- a/README.md +++ b/README.md @@ -17,20 +17,25 @@ # ARFoundation World Analysis # This wrapper for the World Analysis relies on the ARFoundation (version 5.1.x) Unity package available here: https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.1/manual/index.html and is compatible with ARKit and ARCore. +Some capabilities are also compatible with VisionOS based on Polyspatial 1.X https://docs.unity3d.com/Packages/com.unity.polyspatial.visionos@1.3/manual/index.html + ## Supported Trackables and Setup ### Image Trackables ### -Image markers are supported on both iOS and Android platforms through ARKit and ARCore. +Image markers are supported on both iOS and Android platforms through ARKit and ARCore. (Use Trackable Type "OTHER" with version 1.01) The name of the Trackable in the World Storage must correspond to the name of a file (jpg or png) placed in the Unity persistent data path of the application on the user device. The variable keyvalueTags of the Trackable can also contain a parameter with the "url" key providing a link to download the image. More information about ARFoundation Image Tracking can be found here: https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.1/manual/index.html +Image Trackables are also supported on VisionOS but cannot be loaded dynamcally at runtime due to limitations of Polyspatial 1.X. Dynamic creation of runtime image library is supported with Polyspatial 2.X but this feature has not been tested yet with this package. +To track an image you need to create a static reference Image Library named VisionOSImageLibrary in a Resources folder. The name of the image in this library must correspond to the name of the corresponding Trackable. Other parameters included in the World Storage such as size and unit are ignored. + ### Mesh Trackables ### -Mesh trackables are supported on iOS through ARKit. +Mesh trackables are only supported on iOS through ARKit. ARKit can track meshes that are defined in the .arobject format. Such an object can be scanned with the sample application provided here: https://developer.apple.com/documentation/arkit/arkit_in_ios/content_anchors/scanning_and_detecting_3d_objects @@ -53,7 +58,7 @@ More information about ARFoundation Mesh Tracking can be found here: https://doc #### iOS: ARWorldMap #### -On iOS/ARKit Map Trackables are supported with ARWorlMap feature. Only one Map Trackable per World Graph is supported. +On iOS/ARKit Map Trackables are supported with ARWorlMap feature. Only one Map Trackable per World Graph is supported. ARWorlMap is not supported on VisionOS. In ARKit, an ARWorldMap includes ARKit's awareness of the physical space in which the user moves the device that can be serialized into a file to be reloaded later on the same or on another device: https://developer.apple.com/documentation/arkit/arworldmap @@ -79,6 +84,7 @@ For using ARCore cloud anchors you need to: To use a Map Trackable that corresponds to a Google Cloud Anchor, the name of the Trackable in the World Storage must correspond to the name of Google UUID of the anchor. + ### Geo Trackables ### #### iOS: perspectives #### -- GitLab