iOS RealityKit碰撞检测异常问题求助

核心问题分析 #

你遇到的两个同组Box无法触发碰撞检测的情况，大概率是以下几个原因导致：

1. 碰撞事件订阅范围错误：如果只订阅了单个实体（比如Board）的碰撞事件，自然捕获不到两个Box之间的碰撞。
2. 代码缺失导致订阅逻辑不完整：你提供的CollisionManager代码存在乱码和内容缺失，关键的碰撞事件订阅代码没有完整实现。
3. Board的碰撞过滤器干扰：虽然你设置了Box的同组过滤，但Board的碰撞参数可能默认参与了碰撞检测，掩盖了Box之间的碰撞日志（注释过滤器后出现的Board相关日志也验证了这一点）。

解决方案 #

1. 正确订阅全局碰撞事件

要捕获场景中所有符合条件的碰撞，需要订阅整个ARView场景的CollisionEvents.Began事件，而非单个实体：

func setupCollisionSubscription(in arView: ARView) {
    collisionSubscription = arView.scene.subscribe(to: CollisionEvents.Began.self) { event in
        let nameA = event.entityA.name.isEmpty ? "未命名实体" : event.entityA.name
        let nameB = event.entityB.name.isEmpty ? "未命名实体" : event.entityB.name
        print("collision began between \(nameA) and \(nameB)")
    }
}

2. 隔离Board的碰撞逻辑

如果不需要Board参与碰撞检测，给它单独设置碰撞组并屏蔽所有碰撞掩码，避免干扰Box之间的检测：

// 创建Board时设置
let boardGroup = CollisionGroup(rawValue: 1 << 1)
boardEntity.generateCollisionShapes(recursive: false)
boardEntity.collision!.filter = CollisionFilter(group: boardGroup, mask: [])

3. 确保Box的碰撞配置完整且一致

给每个Box设置唯一名称，并确保碰撞过滤器完全一致：

func createBox(name: String) -> ModelEntity {
    let boxEntity = ModelEntity(mesh: .generateBox(size: 0.1))
    boxEntity.name = name
    
    boxEntity.generateCollisionShapes(recursive: false)
    boxEntity.collision!.mode = .trigger
    
    let boxGroup = CollisionGroup(rawValue: 1 << 0)
    boxEntity.collision!.filter = CollisionFilter(group: boxGroup, mask: boxGroup)
    
    return boxEntity
}

// 调用示例
let fixedBox = createBox(name: "Fixed box")
let movingBox = createBox(name: "Moving box")

4. 验证移动逻辑的正确性

添加位置打印，确认移动Box确实和固定Box发生了碰撞形状重叠：

func startMoving(_ box: ModelEntity, target: ModelEntity) {
    movementTimer?.invalidate()
    movementTimer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { [weak box, weak target] _ in
        guard let box = box, let target = target else { return }
        box.position.x -= 0.005
        print("移动Box位置：\(box.position)，固定Box位置：\(target.position)")
    }
}

完整修正后的CollisionManager示例 #

import Combine
import Foundation
import RealityKit

class CollisionManager {
    var movementTimer: Timer?
    private var collisionSubscription: Cancellable?
    
    func setupCollisionDetection(in arView: ARView) {
        collisionSubscription = arView.scene.subscribe(to: CollisionEvents.Began.self) { event in
            let nameA = event.entityA.name.isEmpty ? "未命名实体" : event.entityA.name
            let nameB = event.entityB.name.isEmpty ? "未命名实体" : event.entityB.name
            print("collision began between \(nameA) and \(nameB)")
        }
    }
    
    func createBox(name: String) -> ModelEntity {
        let boxEntity = ModelEntity(mesh: .generateBox(size: 0.1))
        boxEntity.name = name
        
        boxEntity.generateCollisionShapes(recursive: false)
        boxEntity.collision!.mode = .trigger
        
        let boxGroup = CollisionGroup(rawValue: 1 << 0)
        boxEntity.collision!.filter = CollisionFilter(group: boxGroup, mask: boxGroup)
        
        return boxEntity
    }
    
    func startMovingBox(_ box: ModelEntity) {
        movementTimer?.invalidate()
        movementTimer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { [weak box] _ in
            guard let box = box else { return }
            box.position.x -= 0.005
        }
    }
}

额外注意事项 #

• 确保所有实体都正确添加到ARView的场景中（比如添加到arView.scene.anchors.first!）。
• Trigger模式无需启用物理模拟，你的这部分设置是正确的。
• 如果仍无法检测碰撞，可以更换CollisionGroup的rawValue（比如用1 << 2），避免和系统默认组冲突。

内容的提问来源于stack exchange，提问作者Reinhard Männer