RealityKit使用Face Anchor时AR面部挂载模型无法显示

你这段代码的锚点挂载逻辑本身没有结构性错误，模型不显示基本是踩了RealityKit资源加载和面部锚点的常见坑，按以下顺序排查即可：

• 资源加载逻辑错误
  你用try!强制解包加载模型，一旦资源加载失败要么直接触发崩溃，要么静默吞掉错误。SketchFab下载的模型默认多为嵌套文件夹结构，直接写文件名加载会找不到资源：导入Xcode时如果是文件夹引用要写全相对路径，非.usdz/.reality格式的模型（比如glb、obj、fbx）RealityKit不支持直接加载，必须先转成官方支持的格式，同时要确认模型文件勾选了当前App Target的成员资格。
• 模型变换参数不匹配
  SketchFab导出的模型默认单位和RealityKit的米制单位不匹配，绝大多数第三方下载的模型要么缩放值过大（远超镜头视锥体范围）要么过小（肉眼不可见），且部分模型初始原点偏移严重，直接挂载到锚点上会跑出可视范围。面部锚点原点位于人脸几何中心，z轴正方向朝向镜头外侧。
• 运行环境/权限缺失
  面部追踪仅支持搭载原深感摄像头的真机（iPhone X及后续带面容ID的机型），模拟器完全无法运行该功能。另外Info.plist必须添加NSCameraUsageDescription、NSFaceTrackingUsageDescription两个权限字段，缺失的话ARSession会直接中断，不会渲染任何内容。
• 材质兼容性问题
  部分SketchFab导出的模型带RealityKit不支持的自定义着色器、异常透明通道参数，会出现加载成功但无法渲染的情况。

修复后可直接运行的代码 #

struct ARViewContainer: UIViewRepresentable {
    
    func makeUIView(context: Context) -> ARView {
        
        let arView = ARView(frame: .zero)
        
        let configuration = ARFaceTrackingConfiguration()
        arView.session.run(configuration, options: [.resetTracking, .removeExistingAnchors])
        
        let faceAnchor = AnchorEntity(.face)
        
        do {
            // 用do-catch捕获加载错误，控制台可直接看到具体失败原因
            let maskModel = try Entity.loadModel(named: "squid-game")
            // 按实际模型调整缩放、位置，以下参数适配常规1:1人脸尺寸面具模型
            maskModel.scale = [0.13, 0.13, 0.13]
            maskModel.position = [0, 0, 0.02] // 向镜头方向偏移2cm避免穿模
            faceAnchor.addChild(maskModel)
        } catch {
            print("模型加载异常：\(error)")
        }

        arView.scene.addAnchor(faceAnchor)           
        return arView
    }       
    func updateUIView(_ uiView: ARView, context: Context) { }
}

快速验证技巧 #

• 如果加载无报错仍看不到内容，先替换成Xcode内置的测试模型（比如toy_robot.usdz）验证锚点逻辑，内置模型能显示就说明是你下载的SketchFab模型本身格式/参数问题，重新导出usdz或者调整缩放值即可
• 运行时紧盯Xcode控制台输出，ARSession的权限错误、追踪异常、资源加载错误都会在控制台打印明确日志
• 不要用模拟器测试，必须用支持面容ID的真机运行

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