如何在AR模式下设置及修改RealityKit主相机的远裁剪平面（Swift）

访问AR模式下的RealityKit主相机 #

RealityKit的ARView会自动创建与ARSession绑定的主相机实体，你可以通过ARView.camera属性获取这个实体。需要注意的是，该相机实体在ARSession启动后才会完成初始化，建议在viewDidAppear或ARSession状态变为.running时进行访问，避免出现nil。

修改远裁剪平面 #

主相机的裁剪平面参数由CameraComponent控制，你需要获取该组件的可变副本，修改farPlaneDistance属性后重新赋值给相机实体：

import UIKit
import RealityKit
import ARKit

class ViewController: UIViewController {
    @IBOutlet var arView: ARView!
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        
        // 启动ARSession（使用默认跟踪配置）
        arView.session.run(ARWorldTrackingConfiguration())
        
        // 延迟执行，确保相机实体已初始化
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
            self.adjustCameraFarPlane()
        }
    }
    
    private func adjustCameraFarPlane() {
        guard let cameraEntity = arView.camera else {
            print("相机实体未完成初始化")
            return
        }
        
        // 获取并修改相机组件的远裁剪平面
        if var cameraComponent = cameraEntity.components[CameraComponent.self] as? CameraComponent {
            // 设置远裁剪平面距离（单位：米），默认值为1000.0
            cameraComponent.farPlaneDistance = 50.0
            cameraEntity.components[CameraComponent.self] = cameraComponent
            print("远裁剪平面已设置为50米")
        }
    }
}

注意事项 #

• farPlaneDistance的取值需合理：过小会导致远处AR内容被裁剪，过大会增加GPU渲染负载，建议根据实际场景需求调整。
• 若使用自定义相机实体而非ARView默认主相机，同样可通过修改其CameraComponent的farPlaneDistance属性调整裁剪平面。

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