共享空间锚点故障排除指南

• 无法识别用户所在的空间。
• 尝试从存储位置 Cloud 加载锚点时，需要确认已启用 Enhanced Spatial Services（增强版空间服务）设置。

• 让用户将内容放置在内容所属之处，或让用户走到已知位置，以重建场景，进而帮助系统恢复内容。
• 如果是共享空间锚点，请通知用户开启增强版空间服务。

• 前往 developer.meta.com⁠。
• 在您的开发者团队下，点击新建应用。
• 选择 Meta Horizon 商店。如果您使用 Link 在您的电脑上运行应用，请重复以上步骤，再创建一个 Rift 应用。
• 如果您还没有完成年龄段自证，请完成。必须完成此操作才能申请平台功能访问权限。
• 从左侧导航栏中前往隐私 > 数据使用情况检查，然后请求“用户编号”和“用户个人主页”平台功能的访问权限。
• 从开发者面板左侧导航栏中前往开发 > API，并记下应用编号。
• 在 Unreal 项目中，打开 DefaultEngine.ini，在 [OnlineSubsystemOculus] 下将应用编号设置为 MobileAppId=YOUR_APP_ID。
• 将头戴设备设置为开发者模式。
• 确保您以开发者身份登录，或使用您要开发的应用程序所属的开发者团队的一个测试账户登录。

• 指定的锚点在云端上不存在，或尝试下载锚点的用户无权访问这些锚点。
• 锚点已下载，但设备无法使用从发起共享的设备收到的空间数据进行定位，因为用户对环境的观察不足。

• 如果您看到以下任意一条消息，表示下载步骤本身就已失败：
  • xr_cloud_anchor_service: Downloaded 0 anchors
  • xr_cloud_anchor_service: Failed to download Map for spatial anchors
  • xr_cloud_anchor_service: Failed to download spatial anchor with error:
• 如果来自日志通道的日志 SlamAnchorRuntimeIpcServer 中包含下方消息，表示用户可以下载锚点，但设备无法在从发起共享的设备收到的空间数据中定位自身。您可能会看到错误代码 OVRSpatialAnchor.OperationResult.Failure_SpaceMappingInsufficient 和消息 Import task failed with code: <error> message: <message>。
• 如果您看到错误代码 OVRSpatialAnchor.OperationResult.Failure_SpaceNetworkRequestFailed 或 OVRSpatialAnchor.OperationResult.Failure_SpaceNetworkTimeout，表示连接云端时出现网络问题。请确保设备 Wi-Fi 连接正常，然后重试。

• 地图/锚点已过期。上传到云端的任何锚点都有存留时间 (TTL)。TTL 过期后，锚点会从云端中擦除。
• 空间锚点未成功上传到云端。
• 锚点的预期接收方没有访问权限。发送方可能未将锚点与接收方共享，或共享操作可能失败了。
• 设备未连接网络。请确保设备 Wi-Fi 工作正常，然后重试。

1. 使用新 UUID 创建一个新锚点，将其保存并重新共享。
2. 通过在 logcat 中搜索以下消息，确认上传成功：xr_cloud_anchor_service: Successfully uploaded spatial anchors: 和 xr_cloud_anchor_service: UUID: <some uuid>
   • 如果上传不成功，请按照锚点上传失败中的故障排除步骤操作。
3. 通过在 logcat 中搜索以下消息，确认共享成功：xr_cloud_anchor_service: Share spatial anchor success.。如果共享不成功，请按照锚点共享失败部分中的故障排除步骤操作。

• 指定的用户编号不存在或无效
• 空间锚点未上传到云端

• 如果空间锚点未上传，首先调用保存到云端操作，然后重新共享该锚点。
• 如果一个空间锚点已上传，您无需重新上传即可重新共享该锚点。在这种情况下，请调用共享操作，而不是调用保存操作。

• Request denied based on storage location for package {}, sessionUuid:{}。
• getCloudPermissionEnabled: oculus_spatial_anchor_cloud=false

• 用户在设置 > 隐私与安全 > 设备权限 > 增强版空间服务中禁用了“增强版空间服务”，或者在首次启动使用此功能的体验时显示的对话框中选择了“以后再说”。在这种情况下，日志应包含以下任意一个错误：
  • PreferencesManager: anchor_persistence_cloud_anchor_service_enabled: false
  • userPreference(anchor_persistence_cloud_anchor_service_enabled)=false
• 头戴设备和/或操作系统版本不支持共享空间锚点。在这种情况下，日志应包含以下任意一个错误：
  • checkGatekeeper gatekeeperName: oculus_spatial_anchor_cloud, value: false
  • GK(oculus_spatial_anchor_cloud)=false

XrSpaceComponentStatusFB storableStatus;
xrGetSpaceComponentStatusFB(
    space, XR_SPACE_COMPONENT_TYPE_STORABLE_FB, &storableStatus));
if (storableStatus.enabled) {
    // Save or upload the anchor.
}

XrSpaceComponentStatusFB sharableStatus;
xrGetSpaceComponentStatusFB(
    space, XR_SPACE_COMPONENT_TYPE_SHARABLE_FB, &sharableStatus));
if (sharableStatus.enabled) {
    // Share the anchor.
}

• 使用共享空间锚点
• 示例
• C++ 参考
• Blueprint 参考