维护日期:2026-11-15。直接查看常见问题 · 完整功能手册
安装包显示版本、系统构建号、后端 Player 记录、AB 资源版本是四个独立编号。以当前 Meta 为例:1.0.20(21)对应 Player 29、AB 2。无需在头显登录框输入 Player 编号。
项目发布与 Player 发布是两步。后续项目修改不会改写旧 Player 的冻结快照。仅补一个已构建包的 Pro 发布状态不需重打包;代码变化要新客户端;资源或序列化依赖变化才按影响决定 AB 重建范围。后台 deployment 的 production 与客户端内容 Pro 也是两个概念。
先找相同现象,按顺序排查。当前版本见安装包与验收边界;完整原因与代码见技术复盘。
先检查:先记录版本、Dev/Pro、平台和发生时间;维护者查看实际异常或 HTTP 状态,界面这句提示不能单独判断原因。
怎么处理:核对 SDK、正式/开发设备绑定及 Key。HTTP 409 还要核对该包的 Player 是否已确认并发布到 Pro;旧包的候选登录取消问题需使用本次修复包。
是否重打:仅遗漏 Pro 发布状态:不重装;客户端缺少修复:更新客户端;不因此重打 AB。
先检查:Dev 与 Pro 使用独立登录缓存;第一次切换到尚未保存资料的环境时会空白。
怎么处理:输入该环境的正确资料,保存成功后关闭再打开面板,再重启检查。切回 Dev 应读取原 Dev 资料;不需要清除应用数据。
是否重打:正常切换不重打包;保存成功仍丢失时保留日志排查写入或作用域。
先检查:400:请求/必填项;401:账号或会话凭据;403:SDK/环境/权限不允许;409:发布、快照或配置未就绪;429:尝试过多。具体以响应说明为准。
怎么处理:不要统一当网络断开。检查输入、设备绑定和发布状态;限流时按提示等待再试。只有真正的连接不可用才按离线缓存流程处理,业务拒绝不能靠离线绕过。
是否重打:先修配置或网络;是否更新客户端取决于实际错误,不按状态码一律重包。
先检查:它们分别是后端记录、显示版本和系统构建号;AB 2 又是资源版本。
怎么处理:按交付表对照,在全局管理选择该包对应的 Player。头显只安装正确版本,不手工填写 Player。不要因为数字不同就改包或改设备号。
是否重打:编号不同是正常的;发布已有已确认 Player 不重新打包。
先检查:检查项目是否已发布、该 Player 是否已发布、构建时冻结的快照是否包含当前项目与内容。
怎么处理:如果项目是在构建之后才改的,旧包继续使用旧快照是预期行为。先发布新项目内容,再构建并确认新 Player,再将该 Player 发布到 Pro。
是否重打:快照内容需要改变时交付新 Player;AB 是否重建看资源依赖是否改变。
先检查:首次切换环境可能下载;后续进度也包含本地校验、解码及原生识别库建立。
怎么处理:同一账号/环境/内容下看 ResourceCache 是否为 verified disk hit、networkRequests=0。若持续真实下载,检查缓存完整性、资源版本、应用清理和作用域变化;不要仅凭进度条判断。
是否重打:正常准备不重包;缓存损坏先联网完成准备;持续异常需日志定位。
先检查:还需要该账号、地区、SDK、Dev/Pro 和安装包身份对应的完整启动快照;单独下载文件不等于整套准备完成。
怎么处理:先联网完整启动到加载结束,确认完整快照保存,再退出应用断网冷启动。升级、换账号/环境、清数据或资源不齐时重新联网准备。缓存系统未就绪和真正缺文件应分别处理。
是否重打:当前修复包支持完整快照;不为离线错误直接清缓存或重新构建 AB。
先检查:本地内容恢复与远程控制是不同能力。离线不会恢复旧 token、心跳和 SSE。
怎么处理:当前远程点火、暂停等后台指令需要网络。本地事件点火是后续功能,不能把离线启动支持当作该功能已经完成。
是否重打:这不是资源下载故障;新增本地事件功能需单独开发和验证。
先检查:历史包有登录子进度停在 50% 的缺陷;当前包已修正成功分支。
怎么处理:核对实际安装版本。新包复现时记录提示、时间和场景是否已运行,保留日志;不要强制隐藏整个加载 UI 来掩盖失败。
是否重打:旧包更新客户端;新包先查日志,不默认重打 AB。
先检查:先核对图名/GUID、当前项目、权限、跟踪是否就绪和真实展示尺寸。当前盘山流程起点为 ALabHouse101(L01),SH11 是沿途定位图。
怎么处理:使用完整原图,不只截取文字牌;按参考图配置的真实宽度展示,减少反光与遮挡,稳定看图。Vision 检查世界感知权限及图像 Provider 就绪;PICO 还需满足平面与稳定条件。
是否重打:用错图/权限不重包;旧识别库生命周期或圆环回归需更新修复客户端。
先检查:持续盯着已完成的图时,不会每帧重复移动场景,这是正常设计。
怎么处理:移开视线约 1 秒再回看,重新稳定停留并观察圆环。仍无法再次定位时,检查是否使用本次修复包,以及图像跟踪和重新开放状态日志。
是否重打:旧一次性锁定问题已改客户端;无需因此重做定位图或 AB。
先检查:区分图像外法线、平面法线与美术定位前向,同时核对平台和目标定位点。
怎么处理:使用当前已修复的坐标转换版本。复现时提供图名、期望方向和实际方向;不要给全部场景统一再转 180°,也不要直接认定为镜像识别。
是否重打:若代码坐标契约错误需改客户端;若定位配置错误需按项目发布/快照流程更新。
先检查:本次约 1.39 秒长帧已定位到调试预览的 Sprite 轮廓生成;其他停顿需分别看实际函数耗时。
怎么处理:先核对是否正常修复包、是否仍有运行时调试预览。复现时记录提示阶段,由维护者抓 logcat/性能追踪;诊断包与正式包分开验收。
是否重打:不要凭“卡一下”就重做全部 Shader/AB;按证据决定改动。
先检查:下载成功不等于对象引用还原成功;历史故障为 Art 找不到先前 Locate 导入的 Mask 根引用。
怎么处理:记录具体异常和安装版本,使用包含分批导入修复的客户端。资源缺失、引用范围、版本不匹配分别排查,不先清空所有 AB。
是否重打:引用范围代码问题更新客户端;实际资源/配置损坏按对应版本修复。
先检查:记录具体模型、材质、版本及是否诊断包。历史两个紫色方形模型只在诊断包出现,精确 Shader 原因未确认。
怎么处理:用正常发布包对比;维护者检查材质/Shader、变体与构建差异、实际目录和资源摘要。不要把这次现象写成已经证明的 PSO 问题。
是否重打:需依据材质/资源或客户端构建的实际原因决定,不盲目重建所有包。
先检查:先退出应用观察系统界面是否恢复;这只能帮助区分发生范围,不能直接证明硬件或系统坏了。
怎么处理:核对修复版本并记录哪只眼、发生阶段。当前修复包含临时渲染目标与 sRGB 状态恢复;仍复现需抓取应用/渲染日志。
是否重打:应用渲染问题可能需更新客户端;不能仅靠重下 AB 判断。
先检查:核对设备、Dev/Pro 与回执;只有配置为触发点火的起点图才进入等待,普通定位图只校准。
本次修复:PICO 1.0.27(25)、Meta 1.0.21(22)、Vision 1.2.10(13)已包含准备好再执行、执行失败回失败、等待时每 2 秒补收及定位后立即检查。旧版本可能在无监听或同步监听异常时误报成功。
测试方法:新包先联网完成加载并校准正确起点图,等后台显示等待后只点一次巡游开始,核对 pending / acknowledged / failed / expired 和实际场景。首次 15.424 秒延迟的具体阶段仍缺原始头显日志,新包真机验收待进行;成功回执只代表同步派发成功,不代表异步动画已经完成。
交付:Android 仅本地 APK;Vision 已上传 TestFlight,Apple 处理完成与测试者可用未独立确认。本轮无需重打 AB。
先检查:Apple 接受上传、处理完成、测试组可用、头显安装是不同状态。
怎么处理:先核对版本和构建号,等待处理后刷新 TestFlight;仍不可用由管理员检查对应测试组/账号资格。当前 1.2.11(14)已获上传接受,处理完成与测试者可用尚未独立确认。
是否重打:不因暂时未显示就反复重打同一构建号或重复上传。
先检查:这是当前明确的分发策略:Android 包只保留本地,Vision 使用 TestFlight。
怎么处理:使用交付记录里的本地 APK 路径覆盖安装;后端 Player 发布只批准正式使用,并不上传 APK。恢复在线下载需另行安排。
是否重打:无需重新打包来恢复入口;不能把已发布到 Pro 等同于 APK 可下载。
先检查:语言、系统地区路由、服务地区和 Dev/Pro 是独立配置。当前国内及其他系统地区均路由香港海外区,国内入口尚未开放。
怎么处理:使用当前统一新后台。国内域名/备案/服务准备好后按地区接入方案配置;不要改回旧项目接口。
是否重打:未来路由/包内配置改变需按地区方案重打;语言切换本身不要求新包。
先检查:先区分系统世界追踪、应用对象跟随、空间 Canvas/输入模块和平台权限。
怎么处理:对比系统空间界面是否稳定;记录设备系统版本、权限与应用恢复过程。输入问题需要对应头显验证,编辑器鼠标可点不能代替手势验证。
是否重打:按具体追踪或交互原因处理,不把所有现象都归因定位图。
反馈问题时请提供平台、设备号、Dev/Pro、安装版本、操作时间、提示或截图;由维护者保留相关日志。账号密码、完整 Key 和令牌不放公开反馈。