Vuforia Engine Unity：编辑器测试正常，iOS 17设备图像追踪失效求助

同类问题反馈 #

确实有不少开发者在iOS 17设备（含iPhone 14/15 Pro Max）遇到过完全一致的情况：Unity编辑器内图像追踪测试正常，iOS构建安装无报错，但真机启动后仅相机画面显示，无法识别目标图像。

iOS构建核心注意事项 #

• 隐私权限配置：iOS 17对隐私权限的校验更严格，必须在Info.plist中添加NSCameraUsageDescription键，且描述内容需清晰明确（不能为空或模糊表述）。Unity中可直接在Player Settings > iOS > Other Settings > Configuration里添加该权限的描述文本。
• Vuforia版本适配：Vuforia Engine 10.17.0及以上版本才正式支持iOS 17，旧版本存在兼容性缺陷，建议直接升级到最新稳定版。
• Xcode构建参数检查：
  • 确认Xcode项目的Signing & Capabilities中已开启Camera Usage权限；
  • 关闭Bitcode：Vuforia暂不支持Bitcode，需在Unity的Player Settings > iOS > Other Settings中将Enable Bitcode设为No；
  • 调整最低iOS版本：将Minimum iOS Version设置为15.0及以上，避免系统版本兼容问题。
• 图像数据库配置：
  • 选中Vuforia图像数据库文件，在Inspector面板中确保勾选Include in Build，否则数据库不会被打包进iOS应用；
  • 确认数据库是基于当前使用的Vuforia版本生成的，旧版本数据库可能在iOS 17上无法正常加载。
• 相机模式适配：iPhone 15 Pro系列的高分辨率相机和LiDAR模块可能需要特殊适配，在ARCamera组件的Camera Device Mode中选择DEFAULT，避免强制使用不兼容的相机模式。

快速排查流程 #

1. 连接设备到Xcode，打开控制台日志，启动应用后查看是否有Vuforia相关的错误或警告（比如权限被拒绝、数据库加载失败等）；
2. 重新导出Unity项目到Xcode，确保导出过程中未遗漏Vuforia相关资源；
3. 在设备的设置 > 隐私与安全性 > 相机中确认已授予应用相机权限；
4. 替换为一个简单的测试图像数据库，排除数据库本身的问题。

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