io.github.sceneview を使った Antigravity AR 開発入門——AnchorNode のエラーを乗り越えて

// build.gradle.kts（Module）
dependencies {
    implementation("io.github.sceneview:arsceneview:2.3.0")
}

<manifest>
    <!-- ARCore 必須 -->
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-feature android:name="android.hardware.camera.ar" android:required="true" />
    
    <application>
        <meta-data
            android:name="com.google.ar.core"
            android:value="required" />
    </application>
</manifest>

// Compose での使い方
@Composable
fun ARScreen() {
    var arSceneView: ARSceneView? = remember { null }
    
    AndroidView(
        factory = { context ->
            ARSceneView(context).also { sceneView ->
                arSceneView = sceneView
            }
        },
        modifier = Modifier.fillMaxSize()
    )
}

<io.github.sceneview.ar.ARSceneView
    android:id="@+id/arSceneView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

// ❌ onViewCreated で即座に AnchorNode を作ろうとしている
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val anchorNode = AnchorNode(arSceneView.engine, anchor) // クラッシュ
    arSceneView.addChild(anchorNode)
}

// ✅ onSessionResumed コールバックを使う
arSceneView.onSessionResumed = { session ->
    // セッションが有効になってから操作する
    setupARContent()
}
 
private fun setupARContent() {
    arSceneView.onTapAr = { hitResult, _ ->
        val anchor = hitResult.createAnchor()
        val anchorNode = AnchorNode(arSceneView.engine, anchor)
        anchorNode.addChild(
            ModelNode(
                modelInstance = modelLoader.createModelInstance(modelFile),
                autoAnimate = true
            )
        )
        arSceneView.addChild(anchorNode)
    }
}

// ARCore の導入状況を確認し、未導入ならインストールを促す
private var installRequested = false
 
private fun ensureArCore(): Boolean {
    return try {
        when (ArCoreApk.getInstance().requestInstall(requireActivity(), !installRequested)) {
            ArCoreApk.InstallStatus.INSTALL_REQUESTED -> {
                // インストール画面に遷移したので、次回 onResume を待つ
                installRequested = true
                false
            }
            ArCoreApk.InstallStatus.INSTALLED -> true
        }
    } catch (e: UnavailableUserDeclinedInstallationException) {
        // ユーザーがインストールを拒否した
        showFallbackUI()
        false
    }
}

// assets/ フォルダに model.glb を配置して読み込む
class ARFragment : Fragment() {
    
    private lateinit var modelLoader: ModelLoader
    
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        
        val sceneView = view.findViewById<ARSceneView>(R.id.arSceneView)
        modelLoader = ModelLoader(sceneView.engine, requireContext())
        
        sceneView.onSessionResumed = { _ ->
            setupTapToPlace(sceneView)
        }
    }
    
    private fun setupTapToPlace(sceneView: ARSceneView) {
        sceneView.onTapAr = { hitResult, _ ->
            lifecycleScope.launch {
                val modelInstance = modelLoader.loadModelInstance("models/robot.glb")
                    ?: return@launch
                
                val anchor = hitResult.createAnchor()
                val anchorNode = AnchorNode(sceneView.engine, anchor).apply {
                    addChild(ModelNode(
                        modelInstance = modelInstance,
                        scaleToUnits = 0.5f  // メートル単位でスケール指定
                    ))
                }
                sceneView.addChild(anchorNode)
            }
        }
    }
}

// 検出した平面をドットで可視化する
arSceneView.planeRenderer.isEnabled = true
 
arSceneView.onTapAr = { hitResult, _ ->
    placeModel(hitResult)
    // 配置が済んだら視覚的なノイズを減らすため非表示にする
    arSceneView.planeRenderer.isEnabled = false
}

// Antigravity AI でシーン提案を生成して AR に反映する例
suspend fun generateARSceneFromPrompt(prompt: String): ARSceneConfig {
    val client = AntigravityClient(apiKey = "YOUR_API_KEY")
    
    val response = client.generateScene(
        prompt = prompt,
        outputFormat = "structured_json",
        parameters = mapOf(
            "include_position" to true,
            "include_scale" to true,
            "coordinate_system" to "ar_world"
        )
    )
    
    return ARSceneConfig.fromJson(response.content)
}
 
// 生成された設定を AR シーンに適用
fun applySceneConfig(config: ARSceneConfig, sceneView: ARSceneView) {
    config.objects.forEach { objectConfig ->
        // 各オブジェクトを指定位置に配置
        val position = Float3(
            objectConfig.position.x,
            objectConfig.position.y,
            objectConfig.position.z
        )
        // ...
    }
}

// 配置済みモデルをすべて片付ける
fun clearPlacedModels(sceneView: ARSceneView) {
    sceneView.children
        .filterIsInstance<AnchorNode>()
        .forEach { node ->
            node.anchor.detach()      // ARCore セッションからアンカーを解放
            sceneView.removeChild(node)
        }
}

override fun onResume() {
    super.onResume()
    arSceneView.onResume()
}
 
override fun onPause() {
    super.onPause()
    arSceneView.onPause()
}
 
override fun onDestroy() {
    super.onDestroy()
    arSceneView.destroy()  // エンジンリソースの解放
}

if (!ArCoreApk.getInstance().checkAvailability(requireContext()).isSupported) {
    // AR非対応の場合は代替UIを表示
    showFallbackUI()
    return
}