Merge pull request #1468 from Esri/destiny/update-world-scale-AR-tutorial

des12437 · web-flow · commit bf87738e865f · 2026-06-15T15:25:29.000-07:00
Update WorldScaleSceneView tutorial
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep1.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep1.swift
@@ -4,8 +4,10 @@ import SwiftUI
 
 struct WorldScaleExampleView: View {
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        )
+        WorldScaleSceneView(provider: Provider) { _ in
+
+        } sceneView: { _ in
+
+        }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep2.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep2.swift
@@ -3,26 +3,14 @@ import ArcGISToolkit
 import SwiftUI
 
 struct WorldScaleExampleView: View {
-    @State private var scene: ArcGIS.Scene = {
-        // Creates an elevation source from Terrain3D REST service.
-        let elevationServiceURL = URL(
-            string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
-        )!
-        let elevationSource = ArcGISTiledElevationSource(url: elevationServiceURL)
-        let surface = Surface()
-        surface.addElevationSource(elevationSource)
-        surface.backgroundGrid.isVisible = false
-        surface.navigationConstraint = .unconstrained
-        let scene = Scene(basemapStyle: .arcGISImagery)
-        scene.baseSurface = surface
-        return scene
-    }()
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
     
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
-            SceneView(scene: scene)
+        WorldScaleSceneView(provider: provider) { context in
+
+        } sceneView: { _ in
+
         }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep3.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep3.swift
@@ -3,27 +3,14 @@ import ArcGISToolkit
 import SwiftUI
 
 struct WorldScaleExampleView: View {
-    @State private var scene: ArcGIS.Scene = {
-        // Creates an elevation source from Terrain3D REST service.
-        let elevationServiceURL = URL(
-            string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
-        )!
-        let elevationSource = ArcGISTiledElevationSource(url: elevationServiceURL)
-        let surface = Surface()
-        surface.addElevationSource(elevationSource)
-        surface.backgroundGrid.isVisible = false
-        surface.navigationConstraint = .unconstrained
-        let scene = Scene(basemapStyle: .arcGISImagery)
-        scene.baseSurface = surface
-        scene.baseSurface.opacity = 0
-        return scene
-    }()
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
     
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
-            SceneView(scene: scene)
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
+
         }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep4.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep4.swift
@@ -1,6 +1,5 @@
 import ArcGIS
 import ArcGISToolkit
-import CoreLocation
 import SwiftUI
 
 struct WorldScaleExampleView: View {
@@ -16,21 +15,17 @@ struct WorldScaleExampleView: View {
         surface.navigationConstraint = .unconstrained
         let scene = Scene(basemapStyle: .arcGISImagery)
         scene.baseSurface = surface
-        scene.baseSurface.opacity = 0
         return scene
     }()
     
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
+    
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
             SceneView(scene: scene)
         }
-        .task {
-            let locationManager = CLLocationManager()
-            if locationManager.authorizationStatus == .notDetermined {
-                locationManager.requestWhenInUseAuthorization()
-            }
-        }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep5.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep5.swift
@@ -1,6 +1,5 @@
 import ArcGIS
 import ArcGISToolkit
-import CoreLocation
 import SwiftUI
 
 struct WorldScaleExampleView: View {
@@ -20,25 +19,14 @@ struct WorldScaleExampleView: View {
         return scene
     }()
     
-    /// The location datasource that is used to access the device location.
-    @State private var locationDataSource = SystemLocationDataSource()
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
     
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
             SceneView(scene: scene)
         }
-        .task {
-            let locationManager = CLLocationManager()
-            if locationManager.authorizationStatus == .notDetermined {
-                locationManager.requestWhenInUseAuthorization()
-            }
-            
-            try? await locationDataSource.start()
-            
-            // Retrieve initial location.
-            guard let initialLocation = await locationDataSource.locations.first(where: { _ in true }) else { return }
-        }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep6.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep6.swift
@@ -20,46 +20,20 @@ struct WorldScaleExampleView: View {
         return scene
     }()
     
-    /// The location datasource that is used to access the device location.
-    @State private var locationDataSource = SystemLocationDataSource()
-    
-    /// The graphics overlay which shows a graphic around your initial location.
-    @State private var graphicsOverlay = GraphicsOverlay()
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
     
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
-            SceneView(scene: scene, graphicsOverlays: [graphicsOverlay])
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
+            SceneView(scene: scene)
         }
         .task {
             let locationManager = CLLocationManager()
             if locationManager.authorizationStatus == .notDetermined {
                 locationManager.requestWhenInUseAuthorization()
             }
-            
-            try? await locationDataSource.start()
-            
-            // Retrieve initial location.
-            guard let initialLocation = await locationDataSource.locations.first(where: { _ in true }) else { return }
-            
-            // Put a circle graphic around the initial location.
-            let circle = GeometryEngine.geodeticBuffer(
-                around: initialLocation.position,
-                distance: 20,
-                distanceUnit: .meters,
-                maxDeviation: 1,
-                curveType: .geodesic
-            )
-            graphicsOverlay.addGraphic(
-                Graphic(
-                    geometry: circle,
-                    symbol: SimpleLineSymbol(
-                        color: .red,
-                        width: 3
-                    )
-                )
-            )
         }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep7.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep7.swift
@@ -20,49 +20,25 @@ struct WorldScaleExampleView: View {
         return scene
     }()
     
-    /// The location datasource that is used to access the device location.
-    @State private var locationDataSource = SystemLocationDataSource()
-    
-    /// The graphics overlay which shows a graphic around your initial location.
-    @State private var graphicsOverlay = GraphicsOverlay()
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
     
     var body: some View {
-        WorldScaleSceneView(
-            clippingDistance: 400
-        ) { _ in
-            SceneView(scene: scene, graphicsOverlays: [graphicsOverlay])
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
+            SceneView(scene: scene)
         }
         .task {
             let locationManager = CLLocationManager()
             if locationManager.authorizationStatus == .notDetermined {
                 locationManager.requestWhenInUseAuthorization()
             }
             
-            try? await locationDataSource.start()
+            try? await provider.dataSource.start()
             
             // Retrieve initial location.
-            guard let initialLocation = await locationDataSource.locations.first(where: { _ in true }) else { return }
-            
-            // Put a circle graphic around the initial location.
-            let circle = GeometryEngine.geodeticBuffer(
-                around: initialLocation.position,
-                distance: 20,
-                distanceUnit: .meters,
-                maxDeviation: 1,
-                curveType: .geodesic
-            )
-            graphicsOverlay.addGraphic(
-                Graphic(
-                    geometry: circle,
-                    symbol: SimpleLineSymbol(
-                        color: .red,
-                        width: 3
-                    )
-                )
-            )
-            
-            // Stop the location datasource after the initial location is retrieved.
-            await locationDataSource.stop()
+            guard let initialLocation = await provider.dataSource.locations.first(where: { @Sendable _ in true }) else { return }
         }
     }
 }
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep8.swift b/Sources/ArcGISToolkit/Documentation.docc/Resources/WorldScaleSceneView/WorldScaleSceneViewStep8.swift
@@ -0,0 +1,65 @@
+import ArcGIS
+import ArcGISToolkit
+import CoreLocation
+import SwiftUI
+
+struct WorldScaleExampleView: View {
+    @State private var scene: ArcGIS.Scene = {
+        // Creates an elevation source from Terrain3D REST service.
+        let elevationServiceURL = URL(
+            string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
+        )!
+        let elevationSource = ArcGISTiledElevationSource(url: elevationServiceURL)
+        let surface = Surface()
+        surface.addElevationSource(elevationSource)
+        surface.backgroundGrid.isVisible = false
+        surface.navigationConstraint = .unconstrained
+        let scene = Scene(basemapStyle: .arcGISImagery)
+        scene.baseSurface = surface
+        scene.baseSurface.opacity = 0
+        return scene
+    }()
+    
+    /// The graphics overlay which shows a graphic around your initial location.
+    @State private var graphicsOverlay = GraphicsOverlay()
+    
+    /// The world-tracking provider used by this example.
+    @State private var provider = AppleWorldTracking(mode: .worldTracking)
+    
+    var body: some View {
+        WorldScaleSceneView(provider: provider) { context in
+            AppleWorldTrackingCameraFeedView(context: context)
+        } sceneView: { _ in
+            SceneView(scene: scene)
+        }
+        .task {
+            let locationManager = CLLocationManager()
+            if locationManager.authorizationStatus == .notDetermined {
+                locationManager.requestWhenInUseAuthorization()
+            }
+            
+            try? await provider.dataSource.start()
+            
+            // Retrieve initial location.
+            guard let initialLocation = await provider.dataSource.locations.first(where: { @Sendable _ in true }) else { return }
+            
+            // Put a circle graphic around the initial location.
+            let circle = GeometryEngine.geodeticBuffer(
+                around: initialLocation.position,
+                distance: 20,
+                distanceUnit: .meters,
+                maxDeviation: 1,
+                curveType: .geodesic
+            )
+            graphicsOverlay.addGraphic(
+                Graphic(
+                    geometry: circle,
+                    symbol: SimpleLineSymbol(
+                        color: .red,
+                        width: 3
+                    )
+                )
+            )
+        }
+    }
+}
diff --git a/Sources/ArcGISToolkit/Documentation.docc/Tutorials/WorldScaleSceneViewTutorial.tutorial b/Sources/ArcGISToolkit/Documentation.docc/Tutorials/WorldScaleSceneViewTutorial.tutorial

Original file line number	Diff line number	Diff line change
`@@ -4,8 +4,10 @@ import SwiftUI`
`4`	`4`
`5`	`5`	`struct WorldScaleExampleView: View {`
`6`	`6`	`var body: some View {`
`7`		`- WorldScaleSceneView(`
`8`		`- clippingDistance: 400`
`9`		`- )`
	`7`	`+ WorldScaleSceneView(provider: Provider) { _ in`
	`8`	`+`
	`9`	`+ } sceneView: { _ in`
	`10`	`+`
	`11`	`+ }`
`10`	`12`	`}`
`11`	`13`	`}`