Azure Spatial Anchors Unity安卓应用无法采集环境数据求助

一、基础配置校验 #

• 确认安卓目标API版本符合要求：ASA 2.10.2要求安卓minSdkVersion至少为24，targetSdkVersion建议在30~33区间，避免过高API版本的权限适配问题。你可以在Unity的Player Settings > Android > Other Settings > Identification路径下修改对应配置。
• 权限配置检查：确认AndroidManifest.xml中已正确声明相机权限、网络权限、ARCore必要权限，同时确保应用运行时已主动申请相机权限，没有被用户永久拒绝。
• ARCore版本校验：测试设备上安装的ARCore服务版本需要和你项目中引入的ARCore XR Plugin版本兼容，建议升级测试设备的ARCore到最新正式版后重新测试。

二、ASA会话配置排查 #

• 确认安卓端的ASA账户凭据配置无误，不存在拼写错误、区域不匹配的问题，注意iOS和安卓如果共用同一份凭据，需要确认账户没有开启IP访问限制，当前测试设备的网络可以正常访问Azure ASA服务端点。
• 检查ARFoundation的会话配置：确认ARSession、ARAnchorManager、ARRaycastManager组件都已正确挂载到场景中，且SpatialAnchorManager的配置项中SessionPreset已经设置为对应安卓平台的选项，没有错误使用iOS专属的配置参数。
• 环境扫描逻辑校验：在扫描阶段添加日志输出，确认CloudSpatialAnchorSession的ProcessFrame方法在每帧都被正常调用，没有因为代码分支逻辑错误导致帧数据没有传递给ASA SDK。

三、版本兼容性排查 #

• 你当前使用的Unity 2020.3.x系列匹配的ARCore/ARFoundation最高兼容版本建议锁定在4.0.x，你升级到4.1.7反而可能出现适配问题，建议回退到初始的4.0.12版本，避免跨次版本的兼容性冲突。
• 确认你在切换ARFoundation版本后，已经完全卸载旧版本包、删除项目下的Library文件夹重新构建，避免残留的旧版本缓存文件导致的异常。

四、运行时问题排查 #

• 测试时确保设备处于光线充足、纹理丰富的环境中，避免墙面、玻璃等无纹理的区域占满相机视野，导致ARCore无法正常提取特征点。
• 可以在场景中开启ARFoundation的特征点可视化功能，确认ARCore本身可以正常识别环境特征点，如果ARCore本身没有输出特征点，说明问题出在ARCore层而非ASA层，优先排查ARCore的适配问题。
• 抓取安卓端的运行日志，过滤ASA、ARCore、Unity关键词，查看是否有明确的权限错误、服务连接错误、初始化失败的报错信息，可以快速定位问题根因。

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