2026-11-14 Meta 交互统一(源码已改,暂不打包)

按用户要求,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 依赖与媒体资源。当前未完成真机断网冷启动验收。

定位图库加载完成后,图片检测和姿态计算在头显本地执行,不依赖后端逐帧通信。后台点火、远程操作及计时会话仍按原规则运行;本次没有调整离线授权或点火行为。

图片装载停顿排查(2026-11-14 真机记录)

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 内容时显示现有可关闭的“当前为 DEV 测试数据”提示,Pro 隐藏,测绘登录沿用不显示的规则。Dev/Pro 是内容环境,与国内/海外服务地区、后台 production/test 是不同维度。

发现旧代码仅在 UNITY_VISIONOS 条件中刷新提示;三个工程实际都包含相同提示预制体。因此 Android 没显示不能证明其使用 Pro。此次 Swan 启动缓存已确认 env=Dev,属于漏提示;Vision 提示与用户观察相符,尚无该次真机 launch 文件;Meta 本轮未读取实际环境,不能擅自认定为 Pro 或 Dev。

源码已把提示刷新扩展到三端,并在在线或缓存 launch 的实际环境写入项目配置后再次刷新。保持原有预制体、关闭按钮与测绘例外,不修改设备绑定、后台地址或 Dev/Pro 选择。三端编译记录见本次交付记录;因用户要求暂不打包,这一修正尚未在头显生效。

图片装载停顿排查(2026-11-14 真机记录)

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 内容时显示现有可关闭的“当前为 DEV 测试数据”提示,Pro 隐藏,测绘登录沿用不显示的规则。Dev/Pro 是内容环境,与国内/海外服务地区、后台 production/test 是不同维度。

发现旧代码仅在 UNITY_VISIONOS 条件中刷新提示;三个工程实际都包含相同提示预制体。因此 Android 没显示不能证明其使用 Pro。此次 Swan 启动缓存已确认 env=Dev,属于漏提示;Vision 提示与用户观察相符,尚无该次真机 launch 文件;Meta 本轮未读取实际环境,不能擅自认定为 Pro 或 Dev。

源码已把提示刷新扩展到三端,并在在线或缓存 launch 的实际环境写入项目配置后再次刷新。保持原有预制体、关闭按钮与测绘例外,不修改设备绑定、后台地址或 Dev/Pro 选择。三端编译记录见本次交付记录;因用户要求暂不打包,这一修正尚未在头显生效。

Meta Quest 3:资源、构建与空间校准

维护日期:2026-11-10。适用工程:D:\unityproject\shan2Meta。返回多 SDK 发布教程

Meta 软件交付与自动验证已通过:Android AB V1、Player V2、APK 1.0.0 已发布到阿里云 production,四套 Dev/Pro 数据及真实一分钟到期流程通过。APK 已安装到连接的 Quest 3;摄像头识别、手柄校准、画面、声音和性能仍需戴上头显完成验收,因此当前仍标记“客户端验收中”。

Meta 1.0.0 历史发布记录

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 内容。
构建平台 / SDKAndroid / Meta XR Core SDK
com.meta.xr.sdk.core
与同属 Android 的 PICO XR 完全独立:AB、项目数据、语言包、Player 快照和设备绑定分别管理。
内容环境Dev / Pro上传先写 Dev,完成验证再发布项目 Pro 和指定 Player 快照。

production 不等于 Pro。Meta 不能使用 PICO Android AB;渲染、插件和着色器变体可能不同。未来同一 Meta SDK 支持的新设备通常沿用此目标,实际型号、系统版本和能力必须重新验收。

二、本地代码与阿里云同步顺序

  1. 先修改本地 WebAdmin 源码,并检查三个 Unity 客户端受影响的接口。
  2. 使用独立测试数据库和端口运行本地验证,保留现有生产数据。
  3. 生成本次发布副本,删除所有大小写形式的 PDB;核对目录、实际压缩包清单及 SHA-256。
  4. 将阿里云原文件备份到本机构建电脑,并确认它们未被并发修改;同步已验证的本地代码。
  5. 检查云端解压结果、线上代码哈希、production / test 接口和客户端流程。公开 APK 始终连接 https://webadmin.allinxr.com/environments/production。

同步范围为源码和静态页面;账号、数据库、上传资源、运行日志和环境密钥分别备份,不用本地数据目录覆盖阿里云。

三、Unity 日常入口

  1. 使用工程对应的 Unity 版本,激活 Android 构建配置;应用包名为 com.allinxr.meta,产品名称为 allinxr;应用入口使用 GameActivity,MR 启动背景使用透视。
  2. 菜单 ALab / Meta Quest / 配置 SDK、场景与 Android 构建 配置 OpenXR、Meta XR、摄像头和图片校准。该操作会保存 MainGame 场景,并使用 Meta SDK 生成或更新 AndroidManifest,先保存自己的编辑。随后运行 ALab / Meta Quest / 报告 SDK 必需配置,确认当前 Android 必需项目全部通过。
  3. ALab / Meta Quest / 验收 OpenCV 识别与 NewProject 校准 检查图像已知位姿、误识别拒绝及校准数学;这不代表真机识别通过。
  4. 在盘山发布工作台连接阿里云 production,确认 SDK 显示 Meta XR Core SDK。上传完整 Android AB 到 Meta Dev,保持 catalog、hash 和全部 bundle 一起上传。
  5. 使用 Meta Dev 设备验收四套数据,完成后发布各项目的 Meta Pro,再构建 Player。构建成功报告确认后,选择该 Player 发布全局 Pro。
  6. 使用 Meta Pro 设备验收所发布的同一 APK,包括启动、暂停、恢复、重置和计时结束。

Quest 3 装机登录

  1. 扫红色「店铺登录」卡。设备号填首位为 3 的五位纯数字,店铺 Key 填五位大写英文字母和数字,邀请码留空。正式装机使用绑定 Meta XR Core SDK / Pro 的设备号,四套测试号以 30 开头。
  2. 看到「保存成功」后退出并重开 allinxr,等项目加载完再扫定位牌。
  3. WebAdmin「设备管理」中,该设备显示「等待」后勾选并点「巡游开始」。

实际设备号、Key、定位图和当前交付包见 管理员运维手册。

四、Quest 图像识别

依赖 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。

  1. 在头显中允许本应用请求的摄像头权限;启用系统透视。拒绝权限或设备系统不支持摄像头接口时,无法使用图片识别;请处理权限或设备支持问题。
  2. 定位图实体宽度必须与配置相同:当前系统功能卡为 0.5 米,下载的项目定位图默认 0.5 米。保持宽高比,不拉伸打印。下载定位图在 ALT_MetaImageTracking.downloadedImageWidthMetres 中设置,系统功能图可逐图设置尺寸。
  3. 对准有足够纹理的平整定位图,保持稳定,等待校准进度完成。空白图、特征不足、几何不合理或抖动过大的识别不会用于校准。
  4. 系统功能图连续稳定识别至少 0.6 秒后进入原有登录等菜单;同一张图持续可见时只触发一次,移开超过 1 秒后可再次触发。

图像识别结果通过独立位姿接口送入 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 源码中。