RealityView中如何移动Kinematic实体并实现碰撞检测？

核心问题根源 #

1. kinematic模式特性限制：该模式下的实体完全由开发者控制运动，物理引擎不会对其施加任何力或冲量，所以applyLinearImpulse方法对它无效——这是RealityKit的设计特性。
2. physicsMotion未触发碰撞的原因：默认配置下，RealityKit可能不会自动上报运动学（kinematic）实体与静态（static）实体的碰撞事件，需要显式配置碰撞掩码确保事件能被检测到。

解决方案一：手动更新Kinematic实体位置（可控性强） #

通过RealityView的update回调手动修改实体位置，物理引擎会实时检测碰撞并触发事件：

struct CollisionView: View {

    @State var subscriptions: [EventSubscription] = []
    @State private var isMoving = false
    
    var body: some View {
        RealityView { content in
            let upperSphere = ModelEntity(mesh: .generateSphere(radius: 0.04))
            let lowerSphere = ModelEntity(mesh: .generateSphere(radius: 0.04))
            
            upperSphere.position = [0, 2, -2]
            upperSphere.physicsBody = .init()
            upperSphere.physicsBody?.mode = .kinematic
            upperSphere.generateCollisionShapes(recursive: false)
            // 显式设置碰撞过滤器，确保碰撞事件被上报
            upperSphere.collision?.filter = .collision
            
            lowerSphere.position = [0, 1, -2]
            lowerSphere.physicsBody = .init()
            lowerSphere.physicsBody?.mode = .static
            lowerSphere.generateCollisionShapes(recursive: false)
            lowerSphere.collision?.filter = .collision
            
            let sub = content.subscribe(to: CollisionEvents.Began.self, on: nil) { event in
                print("Collision! Between \(event.entityA.name) and \(event.entityB.name)")
            }
            subscriptions.append(sub)
            
            content.add(upperSphere)
            content.add(lowerSphere)
            
            Task {
                try? await Task.sleep(for: .seconds(2))
                print("Start moving upper sphere")
                isMoving = true
            }
        } update: { content, context in
            guard let upperSphere = content.entities.first(where: { $0.position.y > 1 }) else { return }
            if isMoving {
                // 手动控制移动速度，向下移动
                upperSphere.position.y -= 0.01
            }
        }
    }
}

解决方案二：正确使用PhysicsMotionComponent触发碰撞 #

如果偏好通过物理运动组件控制移动，需要显式配置碰撞掩码并监听目标实体的碰撞事件：

struct CollisionView: View {

    @State var subscriptions: [EventSubscription] = []
    
    var body: some View {
        RealityView { content in
            let upperSphere = ModelEntity(mesh: .generateSphere(radius: 0.04))
            let lowerSphere = ModelEntity(mesh: .generateSphere(radius: 0.04))
            
            upperSphere.position = [0, 2, -2]
            upperSphere.physicsBody = .init()
            upperSphere.physicsBody?.mode = .kinematic
            // 初始化物理运动组件
            upperSphere.physicsMotion = PhysicsMotionComponent()
            upperSphere.generateCollisionShapes(recursive: false)
            upperSphere.collision?.filter = .collision
            
            lowerSphere.position = [0, 1, -2]
            lowerSphere.physicsBody = .init()
            lowerSphere.physicsBody?.mode = .static
            lowerSphere.generateCollisionShapes(recursive: false)
            lowerSphere.collision?.filter = .collision
            
            // 仅监听upperSphere的碰撞事件，避免遗漏
            let sub = content.subscribe(to: CollisionEvents.Began.self, on: upperSphere) { _ in
                print("Collision!")
            }
            subscriptions.append(sub)
            
            content.add(upperSphere)
            content.add(lowerSphere)
            
            Task {
                try? await Task.sleep(for: .seconds(2))
                print("Start moving via physicsMotion")
                // 设置线性速度启动移动
                upperSphere.physicsMotion?.linearVelocity = [0, -1, 0]
            }
        }
    }
}

关键补充说明 #

• kinematic模式的核心是开发者完全掌控实体运动，物理引擎不会对其施加重力、冲量等物理效果，只能通过手动修改位置或physicsMotion控制移动。
• 碰撞事件触发的前提是两个实体的碰撞掩码（collision?.filter、categoryBitMask、collisionBitMask）相互匹配，显式设置.collision过滤器能确保事件被正确上报。

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