iOS AR应用中RealityKit平移/旋转/缩放手势无法使用求助

核心问题分析 #

你的代码存在两个关键问题导致手势失效：

1. 锚点与实体层级冲突：先将加载的scene（本身是AnchorEntity）添加到AR场景，随后又把它的子实体移到新创建的AnchorEntity中重复添加，导致实体层级混乱，手势无法正确绑定到目标实体。
2. 实体转移父节点导致手势失效：执行anchor.addChild(entity)时，entity会自动从原父节点（scene）移除，此时给entity安装的手势会因实体层级变更而失效。

修复后的代码 #

class ViewController: UIViewController {

    @IBOutlet var arView: ARView!

    override func viewDidLoad() {
        super.viewDidLoad()

        // 加载场景（返回值为AnchorEntity类型）
        let sceneAnchor = try! Project.loadScene()

        // 获取目标实体并配置碰撞
        if let targetEntity = sceneAnchor.children.first as? Entity & HasCollision {
            // 生成碰撞形状（手势生效的必要条件）
            targetEntity.generateCollisionShapes(recursive: true)
            
            // 给目标实体安装手势
            arView.installGestures([.rotation, .scale, .translation], for: targetEntity)
        }

        // 将场景锚点添加到AR视图
        arView.scene.addAnchor(sceneAnchor)
    }
}

关键修复点说明 #

• 移除冗余锚点创建：Project.loadScene()返回的本身就是AnchorEntity，无需额外创建新锚点，直接使用该场景锚点即可避免层级冲突。
• 调整手势安装时机：确保实体处于正确层级结构后再安装手势，直接绑定到目标实体，避免实体转移父节点导致的手势失效。
• 保留碰撞形状生成：generateCollisionShapes(recursive: true)是ARKit手势生效的前提，必须保留——手势需要通过碰撞检测识别用户操作的实体。

额外检查项 #

• 确认目标实体符合Entity & HasCollision协议，若模型未启用碰撞，可在Reality Composer中手动开启碰撞设置。
• 测试时确保手势操作在实体的碰撞区域内，若自动生成的碰撞形状不正确，可尝试在Reality Composer中手动定义碰撞体。

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