RealityKit在MacOS中未调用相机渲染ARView问题咨询

平台差异与核心原因 #

RealityKit的AR功能在MacOS和iOS上确实存在默认行为差异：iOS上的ARView会自动启动相机并触发权限请求，但MacOS端默认不会激活ARSession的相机输入——这就是你只看到黑背景立方体的原因，ARView只是渲染了3D物体，没有加载相机画面。

解决步骤 #

1. 配置相机权限（必做） #

MacOS 10.14+要求必须显式声明相机权限，否则连权限请求弹窗都不会出现：

• 打开项目的Info.plist
• 添加NSCameraUsageDescription键，填入权限说明（比如"需要访问相机以显示AR内容"）

2. 手动启动ARSession（关键） #

MacOS上不能依赖默认的ARSession启动逻辑，必须手动配置并启动：

import RealityKit
import ARKit

class ViewController: NSViewController {
    @IBOutlet var arView: ARView!
    
    override func viewDidAppear() {
        super.viewDidAppear()
        
        // 配置AR跟踪模式
        let config = ARWorldTrackingConfiguration()
        // 可根据需求添加平面检测等配置
        config.planeDetection = .horizontal
        
        // 主动请求相机权限
        AVCaptureDevice.requestAccess(for: .video) { granted in
            DispatchQueue.main.async {
                guard granted else {
                    print("相机权限被拒绝，无法显示AR内容")
                    return
                }
                // 启动ARSession
                self.arView.session.run(config)
                
                // 添加立方体到相机前方0.5米处
                let cubeMesh = MeshResource.generateBox(size: 0.1)
                let cubeMaterial = SimpleMaterial(color: .blue, isMetallic: true)
                let cubeEntity = ModelEntity(mesh: cubeMesh, materials: [cubeMaterial])
                cubeEntity.position = [0, 0, -0.5]
                
                let anchor = AnchorEntity(world: .zero)
                anchor.addChild(cubeEntity)
                self.arView.scene.addAnchor(anchor)
            }
        }
    }
}

3. 硬件与项目设置检查 #

• 确认你的Mac是Apple Silicon芯片（M1及以后）：Intel Mac不支持RealityKit的AR相机功能。
• 项目Signing & Capabilities中，勾选Camera权限（辅助配置，核心还是Info.plist的描述）。

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