RealityView环境下RealityKit实现Entity射线碰撞检测的方法问询

问题背景 #

当前使用Xcode 16.4模板生成的RealityView代码（无ARView实例），需求是通过屏幕点击或GameController交互，检测当前视角正前方首个Entity的距离。此前在SceneKit中可通过hitTestWithSegment实现，现需RealityKit的替代方案，同时纠结是否需要引入ARView使用entity(at:)或raycast方法。

解决方案 #

1. 无需ARView：用RealityKit原生射线检测 #

RealityKit的Scene和Entity内置了raycast(from:to:query:mask:relativeTo:)方法，完全对应SceneKit的hitTestWithSegment功能，无需依赖ARView。核心思路是从相机位置向正前方发射射线，获取首个碰撞实体并计算距离。

示例代码：

import SwiftUI
import RealityKit

struct ContentView: View {
    @State private var shouldPerformRaycast = false
    
    var body: some View {
        ZStack {
            RealityView { content in
                // 添加测试实体
                let testBox = ModelEntity(mesh: .generateBox(size: 0.5))
                testBox.position = [0, 0, -2] // 相机正前方2米处
                content.add(testBox)
            } update: { content in
                guard shouldPerformRaycast, let camera = content.camera else { return }
                
                // 获取相机位置与正前方方向
                let cameraPos = camera.position(relativeTo: nil)
                let forwardDir = camera.transform.forwardVector
                
                // 定义射线终点：正前方10米处（可按需调整）
                let rayEndPos = cameraPos + forwardDir * 10
                
                // 执行射线检测，只取最近的首个结果
                let hitResults = content.scene.raycast(
                    from: cameraPos,
                    to: rayEndPos,
                    query: .nearest,
                    mask: .all,
                    relativeTo: nil
                )
                
                if let firstHit = hitResults.first {
                    let distance = simd_distance(cameraPos, firstHit.position)
                    print("首个实体距离：\(String(format: "%.2f", distance))米")
                }
                
                // 重置检测标记
                shouldPerformRaycast = false
            }
            // 屏幕点击触发检测
            .gesture(
                TapGesture()
                    .onEnded { _ in
                        shouldPerformRaycast = true
                    }
            )
        }
    }
}

2. 处理GameController交互 #

监听GameController输入事件（如按钮按下），触发上述射线检测逻辑即可，示例代码片段：

// 在ContentView初始化或onAppear中监听GameController
.onAppear {
    NotificationCenter.default.addObserver(
        forName: .GCControllerDidConnect,
        object: nil,
        queue: .main
    ) { _ in
        guard let controller = GCController.controllers().first else { return }
        controller.extendedGamepad?.buttonA.pressedChangedHandler = { _, pressed in
            if pressed {
                shouldPerformRaycast = true
            }
        }
    }
}

3. 是否需要引入ARView？ #

• 若仅需纯虚拟3D场景的实体检测：不需要，RealityView原生的射线检测完全满足需求。
• 若需AR平面检测、空间锚点等AR功能：可引入ARView，使用其raycast方法检测真实空间，但此时需将RealityView替换为ARView或在ARView中集成RealityKit内容。

内容的提问来源于stack exchange，提问作者PKCLsoft