Xcode 9.2嵌入ARKit SceneKit View至视图控制器遇黑屏问题求助

我之前在Xcode 9.2里折腾ARKit的时候，也碰到过完全一样的问题——场景能正常显示，但相机画面直接黑了，当时头都大了！后来排查出几个核心原因，给你逐个拆解：

1. 相机权限未正确配置 #

这是最容易踩的坑！ARKit需要访问设备相机的权限，如果Info.plist里没添加权限描述，系统会默认禁止相机访问，自然就只能显示黑背景。

• 解决办法：
  打开项目的Info.plist，添加NSCameraUsageDescription键，值填清楚申请权限的原因（比如"需要访问相机以实现增强现实功能"），这样系统才会弹出权限请求弹窗，用户授权后相机才能正常工作。

2. ARSCNView的会话未初始化 #

如果你是手动把ARSCNView拖到视图控制器里的，很可能忘了初始化ARKit的会话配置，导致相机没有启动。

• 解决办法：
  首先确保你已经给ARSCNView关联了IBOutlet（比如命名为sceneView），然后在视图控制器的viewDidLoad方法里添加以下代码：

  override func viewDidLoad() {
      super.viewDidLoad()
      
      // 初始化ARKit追踪配置
      let configuration = ARWorldTrackingConfiguration()
      // 启动会话
      sceneView.session.run(configuration)
      
      // 可选：设置视图代理，方便处理ARKit回调
      sceneView.delegate = self
  }
  

  注意：Xcode 9.2对应的iOS版本是11.2左右，ARWorldTrackingConfiguration是当时的标准配置，不要用已废弃的旧配置。

3. 视图层级被遮挡 #

有时候相机画面没显示，不是ARKit的问题，而是ARSCNView被其他UIView给挡住了——比如你不小心拖了个黑色的UIView在它上面，或者约束设置错了导致层级覆盖。

• 解决办法：
  打开Xcode的「Debug View Hierarchy」工具（调试栏里的方块图标），查看视图层级结构，确认ARSCNView处于最上层，没有被其他视图遮挡。如果发现有遮挡，调整视图的zPosition或者重新设置约束。

4. 设备不兼容ARKit #

Xcode 9.2时期的ARKit只支持搭载A9及以上芯片的iOS设备（比如iPhone 6s/6s Plus、iPad Pro及以后的机型）。如果你的测试设备是iPhone 6或更早的机型，虽然能编译运行，但相机根本无法被ARKit调用，只能显示黑背景。

• 解决办法：
  换成A9+芯片的设备测试；如果需要兼容旧设备，得在代码里先判断设备是否支持ARKit，给用户友好提示：

  if ARWorldTrackingConfiguration.isSupported {
      // 正常初始化ARKit
  } else {
      // 提示设备不支持增强现实功能
  }
  

先从权限和会话配置这两个最常见的问题查起，大概率能解决你的问题，如果还不行再检查视图层级和设备兼容性～

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