ARKit无法识别参考图片，使用ARKit+RealityKit放置3D模型问题排查

• 检查convertToReferenceImages自定义方法的实现，确认生成ARReferenceImage时设置了正确的物理尺寸。这是ARKit识别图片的核心依据，仅传入UIImage不设置现实物理宽高的情况下，系统无法匹配现实场景中的图片大小，会直接导致识别失败。正确创建示例如下：

// 0.1 表示当前参考图片在现实世界中的实际宽度为10厘米，需和你打印的实体图片尺寸完全对应
let referenceImage = ARReferenceImage(qrCodeReferenceImage.cgImage!, orientation: .up, physicalWidth: 0.1)

• 修正代理方法的逻辑错误：当前session(_:didAdd:)方法中，判断anchor不是ARImageAnchor类型时直接return，会导致遍历到第一个非图片锚点时就直接退出整个方法，后续的图片锚点完全不会被处理。把return改为continue即可修复该逻辑问题。
• 补充AR配置参数：可以在ARWorldTrackingConfiguration初始化后添加configuration.maximumNumberOfTrackedImages = 1，部分低版本ARKit的默认跟踪图片数量为0，会导致不触发图片识别逻辑，数值可根据你需要同时跟踪的图片数量调整。
• 确认参考图片无特征问题：确保你导入的参考图片和现实中打印的实体图片完全一致，没有出现拉伸、裁剪、压缩失真、加滤镜的情况，且图片本身对比度足够、无大面积重复纹理。
• 校验运行时配置是否生效：可以在正常触发的session(_:didUpdate:)方法中打印当前配置的detectionImages数量，确认ARSession运行时确实正确加载了参考图片，没有出现配置被覆盖、重置的情况。

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