Tabletop AR: scene placement

microapps/ArTabletopApp/app/src/main/java/com/arcgismaps/toolkit/artabletopapp/screens/MainScreen.kt

@@ -18,24 +18,32 @@
 
 package com.arcgismaps.toolkit.artabletopapp.screens
 
+import androidx.compose.foundation.background
+import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.wrapContentSize
+import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.res.stringResource
-import androidx.compose.ui.unit.dp
+import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import com.arcgismaps.LoadStatus
 import com.arcgismaps.geometry.Point
 import com.arcgismaps.mapping.ArcGISScene
 import com.arcgismaps.mapping.BasemapStyle
-import com.arcgismaps.mapping.Viewpoint
+import com.arcgismaps.mapping.ElevationSource
+import com.arcgismaps.mapping.Surface
+import com.arcgismaps.mapping.layers.ArcGISMapImageLayer
+import com.arcgismaps.mapping.layers.ArcGISSceneLayer
 import com.arcgismaps.toolkit.ar.TableTopSceneView
 import com.arcgismaps.toolkit.ar.TableTopSceneViewProxy
 import com.arcgismaps.toolkit.ar.TableTopSceneViewStatus
@@ -47,7 +55,23 @@ import kotlin.math.roundToInt
 fun MainScreen() {
     val arcGISScene = remember {
         ArcGISScene(BasemapStyle.ArcGISImagery).apply {
-            initialViewpoint = Viewpoint(34.056295, -117.195800, 10000000.0)
+            operationalLayers.addAll(
+                listOf(
+                    // New York Transit Frequency
+                    ArcGISMapImageLayer("https://tiles.arcgis.com/tiles/nGt4QxSblgDfeJn9/arcgis/rest/services/UrbanObservatory_NYC_TransitFrequency/MapServer"),
+                    // New York Industrial Area
+                    ArcGISMapImageLayer("https://tiles.arcgis.com/tiles/nGt4QxSblgDfeJn9/arcgis/rest/services/New_York_Industrial/MapServer"),
+                    // New York Population Density
+                    ArcGISMapImageLayer("https://tiles.arcgis.com/tiles/4yjifSiIG17X0gW4/arcgis/rest/services/NewYorkCity_PopDensity/MapServer"),
+                    // New York Buildings
+                    ArcGISSceneLayer("https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/Buildings_NewYork_17/SceneServer")
+                )
+            )
+            baseSurface = Surface().apply {
+                elevationSources.add(
+                    ElevationSource.fromTerrain3dService()
+                )
+            }
         }
     }
     val tableTopSceneViewProxy = remember { TableTopSceneViewProxy() }
@@ -56,6 +80,9 @@ fun MainScreen() {
     Box(modifier = Modifier.fillMaxSize()) {
         TableTopSceneView(
             arcGISScene = arcGISScene,
+            arcGISSceneAnchor = Point(-74.0, 40.72, 0.0, arcGISScene.spatialReference),
+            translationFactor = 2000.0,
+            clippingDistance = 750.0,
             modifier = Modifier.fillMaxSize(),
             tableTopSceneViewProxy = tableTopSceneViewProxy,
             onInitializationStatusChanged = {
@@ -70,14 +97,71 @@ fun MainScreen() {
         ) {
             tappedLocation?.let {
                 Callout(location = it, modifier = Modifier.wrapContentSize()) {
-                    Text("Lat: ${it.y.roundToInt()}, Lon: ${it.x.roundToInt()}")
+                    Text(stringResource(R.string.lat_lon, it.y.roundToInt(), it.x.roundToInt()))
                 }
             }
         }
-        Text(
-            text = stringResource(R.string.initialization_status, initializationStatus),
-            modifier = Modifier.height(200.dp),
-            color = Color.Red
-        )
+        when (val status = initializationStatus) {
+            is TableTopSceneViewStatus.Initializing -> TextWithScrim(text = stringResource(R.string.initializing_overlay))
+            is TableTopSceneViewStatus.DetectingPlanes -> TextWithScrim(text = stringResource(R.string.detect_planes_overlay))
+            is TableTopSceneViewStatus.Initialized -> {
+                val sceneLoadStatus = arcGISScene.loadStatus.collectAsStateWithLifecycle().value
+                when (sceneLoadStatus) {
+                    is LoadStatus.NotLoaded -> {
+                        // Tell the user to tap the screen if the scene has not started loading
+                        TextWithScrim(text = stringResource(R.string.tap_scene_overlay))
+                    }
+
+                    is LoadStatus.Loading -> {
+                        // The scene may take a while to load, so show a progress indicator
+                        Column(
+                            modifier = Modifier.fillMaxSize(),
+                            verticalArrangement = Arrangement.Center,
+                            horizontalAlignment = Alignment.CenterHorizontally
+                        ) {
+                            CircularProgressIndicator()
+                        }
+                    }
+
+                    is LoadStatus.FailedToLoad -> {
+                        TextWithScrim(
+                            text = stringResource(
+                                R.string.failed_to_load_scene,
+                                sceneLoadStatus.error
+                            )
+                        )
+                    }
+
+                    LoadStatus.Loaded -> {} // Do nothing
+                }
+            }
+
+            is TableTopSceneViewStatus.FailedToInitialize -> {
+                TextWithScrim(
+                    text = stringResource(
+                        R.string.failed_to_initialize_overlay,
+                        status.error.message ?: status.error
+                    )
+                )
+            }
+        }
+    }
+}
+
+/**
+ * Displays the provided [text] on top of a half-transparent gray background.
+ *
+ * @since 200.6.0
+ */
+@Composable
+fun TextWithScrim(text: String) {
+    Column(
+        modifier = Modifier
+            .background(Color.Gray.copy(alpha = 0.5f))
+            .fillMaxSize(),
+        verticalArrangement = Arrangement.Center,
+        horizontalAlignment = Alignment.CenterHorizontally
+    ) {
+        Text(text = text)
     }
 }

microapps/ArTabletopApp/app/src/main/res/values/strings.xml

@@ -20,4 +20,10 @@
     <string name="app_name">ArTabletopApp</string>
     <string name="arcore_not_installed_screen_message">Google Play Services for AR must be installed to run this app.</string>
     <string name="initialization_status">Initialization status: %1$s</string>
+    <string name="detect_planes_overlay">Move your phone around to detect planes...</string>
+    <string name="lat_lon">Lat: %1$s, Lon: %2$s</string>
+    <string name="tap_scene_overlay">Tap on a plane to place the scene</string>
+    <string name="initializing_overlay">Setting up AR...</string>
+    <string name="failed_to_initialize_overlay">Failed to initialize: %1$s</string>
+    <string name="failed_to_load_scene">Failed to load scene: %1$s</string>
 </resources>

toolkit/ar/build.gradle.kts

@@ -46,9 +46,22 @@ android {
     kotlinOptions {
         jvmTarget = "1.8"
     }
+    @Suppress("UnstableApiUsage")
     buildFeatures {
         compose = true
     }
+    packagingOptions {
+        exclude("META-INF/LICENSE-notice.md")
+        exclude("META-INF/LICENSE.md")
+    }
+    // If this were not an android project, we would just write `explicitApi()` in the Kotlin scope.
+    // but as an android project could write `freeCompilerArgs = listOf("-Xexplicit-api=strict")`
+    // in the kotlinOptions above, but that would enforce api rules on the test code, which we don't want.
+    tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile> {
+        if ("Test" !in name) {
+            kotlinOptions.freeCompilerArgs += "-Xexplicit-api=strict"
+        }
+    }
 
     /**
      * Configures the test report for connected (instrumented) tests to be copied to a central