按用户要求,Meta 删除眼前常驻文字、X 手柄两点校准和 Y 功能菜单。三个平台统一使用图片入口:系统功能卡打开登录/调试等界面,定位图进行空间校准;原有识别确认圆环和点火流程保留。
Meta 源码已通过编译及原有 5 项定位适配检查。当前已交付 Meta 仍为 1.0.17(18),其中仍包含旧文字和手柄入口;本次没有生成或安装新 APK,没有重打 AB,也没有上传 TestFlight。新行为须后续按用户指令打包后才能在头显生效。PICO/Vision 无对应 Meta 手柄分支;本次另同步三端 Dev 提示刷新修正,三工程均维护对应代码与文档。
默认冷启动先请求新后台的 launch,获取登录与项目配置;断网失败不会自动改读旧缓存。仅下载好 AB 与图片,不能保证正常断网启动。
调试中心的“跳过网络请求”会读取缓存 launch,并使用已有本地化数据,但它不是完整的正式离线模式:冷启动路径没有显式选择已保存的运行时资源目录,缺失/无效的图片或遮罩缓存仍会尝试下载。还需要同一后台、地区、SDK、Dev/Pro 和项目版本的配置、语言、catalog、全部 AB 依赖与媒体资源。当前未完成真机断网冷启动验收。
定位图库加载完成后,图片检测和姿态计算在头显本地执行,不依赖后端逐帧通信。后台点火、远程操作及计时会话仍按原规则运行;本次没有调整离线授权或点火行为。
Swan 当前安装 PICO 1.0.19(17),早于本地已交付的 1.0.20(18)。第一轮用户报告一次明显停顿;第二轮 Perfetto 捕获图片装载开始后的 1,391 毫秒 XR 帧间隔,其中 Unity 主线程运行 1,371 毫秒,渲染线程运行约 1 毫秒、其余主要等待。该间隔开始于 AB 初始化完成约 1.18 秒后,不能仅凭“AB 已下载”认定后续资源装载没有成本,也不能直接认定由 AB 或 PSO 引起。
第二轮图片阶段 18:53:17.153—18:53:27.528(香港时间),耗时 10.375 秒;Unity 分配内存约 375→689 MiB。SDK 帧率样本最低 36/90,随后恢复到约 85–90。该 SDK 的负 MTP 样本异常,未拿它作为实际延迟。卡顿阶段确定存在主线程长耗时,但采样不包含具体函数调用栈,因此根因尚未收敛到单一方法。
代码与日志还发现:缓存图片语义校验后会再次准备运行时纹理;PICO 有识别纹理转换;Meta 有主线程像素读取;PICO 隐藏平面可视化仍尝试生成网格,并反复报告多边形无法三角化。它们是排查点,不等于已证明某一项独占此次 1.39 秒。第一轮 atrace 文件未完整保存,第二轮 Perfetto 覆盖了完整启动及卡顿窗口,结束于容量上限。当前没有修改性能路径、没有重新打包,也没有宣称残余卡顿已修复。Quest 本轮未取得新启动追踪,旧低内存检查点不能代替卡顿根因证据。
正确规则为:普通、通用玩家或商务登录使用 Dev 内容时显示现有可关闭的“当前为 DEV 测试数据”提示,Pro 隐藏,测绘登录沿用不显示的规则。Dev/Pro 是内容环境,与国内/海外服务地区、后台 production/test 是不同维度。
发现旧代码仅在 UNITY_VISIONOS 条件中刷新提示;三个工程实际都包含相同提示预制体。因此 Android 没显示不能证明其使用 Pro。此次 Swan 启动缓存已确认 env=Dev,属于漏提示;Vision 提示与用户观察相符,尚无该次真机 launch 文件;Meta 本轮未读取实际环境,不能擅自认定为 Pro 或 Dev。
源码已把提示刷新扩展到三端,并在在线或缓存 launch 的实际环境写入项目配置后再次刷新。保持原有预制体、关闭按钮与测绘例外,不修改设备绑定、后台地址或 Dev/Pro 选择。三端编译记录见本次交付记录;因用户要求暂不打包,这一修正尚未在头显生效。
Swan 当前安装 PICO 1.0.19(17),早于本地已交付的 1.0.20(18)。第一轮用户报告一次明显停顿;第二轮 Perfetto 捕获图片装载开始后的 1,391 毫秒 XR 帧间隔,其中 Unity 主线程运行 1,371 毫秒,渲染线程运行约 1 毫秒、其余主要等待。该间隔开始于 AB 初始化完成约 1.18 秒后,不能仅凭“AB 已下载”认定后续资源装载没有成本,也不能直接认定由 AB 或 PSO 引起。
第二轮图片阶段 18:53:17.153—18:53:27.528(香港时间),耗时 10.375 秒;Unity 分配内存约 375→689 MiB。SDK 帧率样本最低 36/90,随后恢复到约 85–90。该 SDK 的负 MTP 样本异常,未拿它作为实际延迟。卡顿阶段确定存在主线程长耗时,但采样不包含具体函数调用栈,因此根因尚未收敛到单一方法。
代码与日志还发现:缓存图片语义校验后会再次准备运行时纹理;PICO 有识别纹理转换;Meta 有主线程像素读取;PICO 隐藏平面可视化仍尝试生成网格,并反复报告多边形无法三角化。它们是排查点,不等于已证明某一项独占此次 1.39 秒。第一轮 atrace 文件未完整保存,第二轮 Perfetto 覆盖了完整启动及卡顿窗口,结束于容量上限。当前没有修改性能路径、没有重新打包,也没有宣称残余卡顿已修复。Quest 本轮未取得新启动追踪,旧低内存检查点不能代替卡顿根因证据。
正确规则为:普通、通用玩家或商务登录使用 Dev 内容时显示现有可关闭的“当前为 DEV 测试数据”提示,Pro 隐藏,测绘登录沿用不显示的规则。Dev/Pro 是内容环境,与国内/海外服务地区、后台 production/test 是不同维度。
发现旧代码仅在 UNITY_VISIONOS 条件中刷新提示;三个工程实际都包含相同提示预制体。因此 Android 没显示不能证明其使用 Pro。此次 Swan 启动缓存已确认 env=Dev,属于漏提示;Vision 提示与用户观察相符,尚无该次真机 launch 文件;Meta 本轮未读取实际环境,不能擅自认定为 Pro 或 Dev。
源码已把提示刷新扩展到三端,并在在线或缓存 launch 的实际环境写入项目配置后再次刷新。保持原有预制体、关闭按钮与测绘例外,不修改设备绑定、后台地址或 Dev/Pro 选择。三端编译记录见本次交付记录;因用户要求暂不打包,这一修正尚未在头显生效。
维护日期:2026-11-10。适用工程:D:\unityproject\shan2Meta。返回多 SDK 发布教程
Meta 软件交付与自动验证已通过:Android AB V1、Player V2、APK 1.0.0 已发布到阿里云 production,四套 Dev/Pro 数据及真实一分钟到期流程通过。APK 已安装到连接的 Quest 3;摄像头识别、手柄校准、画面、声音和性能仍需戴上头显完成验收,因此当前仍标记“客户端验收中”。
APK 云端下载已暂停;请使用本地安装包(包名 com.allinxr.meta,ARM64 / IL2CPP,约 297 MB)。默认连接阿里云 production 的 Meta Pro 内容;设备编号和店铺密钥在私有运维手册中。
SHA-256:d47a35fa840a1da125d306081ae29138573b243baa6ab1c79cc5e8c94f0a1f30。
AB 共 210 个文件、7,627,676,434 字节;上传目录及云端文件完整性已核验,发布副本与 APK 无 PDB。四套配置保持源 shan2 数据;Unity 实际加载了 8 个代表性模型 Bundle,该预览使用明确标注的推断关联,不代表所有历史模型或真机视觉已验收。
| 选项 | Meta 项目使用值 | 意义 |
|---|---|---|
| 后台环境 | production | 阿里云正式 WebAdmin 服务,可同时维护 Dev 和 Pro 内容。 |
| 构建平台 / SDK | Android / Meta XR Core SDKcom.meta.xr.sdk.core | 与同属 Android 的 PICO XR 完全独立:AB、项目数据、语言包、Player 快照和设备绑定分别管理。 |
| 内容环境 | Dev / Pro | 上传先写 Dev,完成验证再发布项目 Pro 和指定 Player 快照。 |
production 不等于 Pro。Meta 不能使用 PICO Android AB;渲染、插件和着色器变体可能不同。未来同一 Meta SDK 支持的新设备通常沿用此目标,实际型号、系统版本和能力必须重新验收。
https://webadmin.allinxr.com/environments/production。同步范围为源码和静态页面;账号、数据库、上传资源、运行日志和环境密钥分别备份,不用本地数据目录覆盖阿里云。
com.allinxr.meta,产品名称为 allinxr;应用入口使用 GameActivity,MR 启动背景使用透视。ALab / Meta Quest / 配置 SDK、场景与 Android 构建 配置 OpenXR、Meta XR、摄像头和图片校准。该操作会保存 MainGame 场景,并使用 Meta SDK 生成或更新 AndroidManifest,先保存自己的编辑。随后运行 ALab / Meta Quest / 报告 SDK 必需配置,确认当前 Android 必需项目全部通过。ALab / Meta Quest / 验收 OpenCV 识别与 NewProject 校准 检查图像已知位姿、误识别拒绝及校准数学;这不代表真机识别通过。3 的五位纯数字,店铺 Key 填五位大写英文字母和数字,邀请码留空。正式装机使用绑定 Meta XR Core SDK / Pro 的设备号,四套测试号以 30 开头。实际设备号、Key、定位图和当前交付包见 管理员运维手册。
依赖 Meta XR Core SDK 83.0.1、Meta MR Utility Kit 83.0.1 和用户提供的 OpenCV for Unity 3.0.4。参考 QuestImageTracking 的 ORB、单应矩阵和 PnP 路径;3.0.4 的模块名不同,接入代码使用本地插件实际 API。
ALT_MetaImageTracking.downloadedImageWidthMetres 中设置,系统功能图可逐图设置尺寸。图像识别结果通过独立位姿接口送入 NewProject 的原校准算法;无需 ARFoundation 图像跟踪子系统或平面检测。摄像头帧只在设备内用于匹配,不上传后台。
系统功能卡用于打开登录、调试和重置等界面;项目定位图用于空间校准。保持完整图片进入视野,等待确认圆环完成。源码已移除 X 手柄校准与 Y 功能菜单,待后续打包生效。
五张系统卡及四套项目定位图共九张真实参考图,通过 27 个已知距离、角度的混合图库检查。另已检查空白图拒绝、无纹理参考图拒绝,以及 NewProject 校准的位置、朝向和重复应用。实际校准适配入口通过五种初始朝向和成功事件检查;当前 Meta SDK 的 49 项 Android 必需配置均通过。这里使用的是合成相机视图,不能据此推定 Quest 摄像头的实测精度、性能或遮挡表现;真机验收结果单独记录。
原校准源码在 Assets/ALabToolkit/Meta/Calibration,从 NewProject 逐字复制;修改算法前必须重新验证。Meta 适配在 Assets/ALabToolkit/Meta,PICO 工程与 VisionOS 工程保留各自 SDK 接入。
查看 Logs/MetaQuestBuild 的配置、识别、内容和 APK 报告;云端流程报告在 Logs/CloudRelease/20261107-meta-quest3。设备日志关注 MetaSetup、MetaImageTracking、MetaCalibration 和后端请求错误。发生 SDK 不匹配时检查后台设备绑定、APK 内置 SDK 和当前资源目标。
账号密码、店铺密钥、设备记录及本教程的完整备份统一保存在本机私有 HTML 运维手册中,不放在公开页面、APK、AB 或 SVN 源码中。