AllinXR 多 SDK 资源与发布教程

维护日期:2026-11-15。本页不含账号、密码或门店 Key。私有接入资料统一保存在本机 D:\unityproject\Documentation\AllinXR-WebAdmin-统一运维手册.html。

当前正式发布与现场操作

安装包显示版本、系统构建号、后端 Player 记录、AB 资源版本是四个独立编号。以当前 Meta 为例:1.0.20(21)对应 Player 29、AB 2。无需在头显登录框输入 Player 编号。

店员:安装与正式登录

  1. 安装对应设备的新包。PICO/Meta 使用本地 APK;Vision Pro 使用 TestFlight。先核对交付记录中的版本,不卸载或清空原数据来尝试解决登录问题。
  2. 在头显关闭 Dev,使用管理员分配给该平台、该项目的正式设备号与店铺 Key 保存。
  3. 看到保存成功后,关闭再打开面板检查资料保留,再完全退出并重启应用。仅摘下头显休眠不等于重启应用。
  4. 第一次 Pro 启动保持联网,等资源、场景、图片识别准备和进度结束。使用该项目规定的起点图完成校准;后台设备进入等待后,再按现场流程点火。

维护者:发布一个已构建的 Player 到 Pro

  1. 登录 新后台 → 全局管理 V2,下拉选择正确 SDK。PICO XR 和 Meta XR Core SDK 虽然都是 Android,发布记录和 AB 不能混用。
  2. 对照交付记录确认包内 Player 编号与实际 APK/TestFlight 版本。点击选择 Player 版本发布,在“发布已确认的 Player 快照”中选择对应项,例如 Player V29 · AB V2。只选经过构建确认的记录。
  3. 点击确认发布,核对确认框中的 SDK 与 Player。完成后点刷新数据,检查 Pro · 正式版本 → Player 发布显示预期编号。
  4. 再用匹配的正式设备号在头显保存、重启和验证。修改后端发布状态不会给头显自动安装新包,也不会恢复云端 APK 下载。

内容发生变化时,顺序不能倒置

  1. 在对应 Unity 工程准备并验证 Dev 数据;资源产物变化时构建、上传该 SDK 的 AB,只有全部校验通过才使用。
  2. 进入项目管理 V2 → 选择 SDK → 版本与资源 → 发布当前 Dev 到 Pro,先发布验证完成的项目内容。
  3. 构建新 Player;构建流程预留版本、冻结当时已发布的项目与应用资源快照,成功后确认构建。
  4. 回到全局管理 V2 → 选择 Player 版本发布,发布这个新 Player,再交付安装包。

项目发布与 Player 发布是两步。后续项目修改不会改写旧 Player 的冻结快照。仅补一个已构建包的 Pro 发布状态不需重打包;代码变化要新客户端;资源或序列化依赖变化才按影响决定 AB 重建范围。后台 deployment 的 production 与客户端内容 Pro 也是两个概念。

常见问题:登录、图片、离线、定位、TestFlight

先分清四个维度

维度选项作用
后台部署环境production / test连接哪套后台服务和数据库。production 不等于内容 Pro。
构建平台 platformAndroid / VisionOSUnity 的实际 BuildTarget,决定原生应用平台。
SDK 资源目标 targetId下表的官方 SDK 包 ID隔离 AB、本地化、项目配置/图片/遮罩、Player 快照、邀请码和设备绑定。
内容环境Dev / ProDev 是编辑上传的工作版本;Pro 是已发布内容或指定 Player 的冻结快照。

三个 SDK 目标

官方 SDK 名称 / targetId平台与设备工程与状态资源目录键
Apple visionOS XR Plugin
com.unity.xr.visionos
VisionOS / Apple Vision ProD:\unityproject\shan2
保留原有平台适配;本机 Windows 的脚本编译不能代替 Xcode/真机验收。
VisionOS
PICO XR
com.bytedance.pico.xr
Android / PICO SwanD:\unityproject\Shan2PICOSwan
本机 SDK package.json 名称为 PICO XR、版本 6.1.1。
Android
Meta XR Core SDK
com.meta.xr.sdk.core
Android / Meta Quest 3;后续设备需另做兼容验收后台目标已启用;客户端工程 D:/unityproject/shan2Meta 的 Dev 完整流程已获用户确认。新包 1.0.20(21)的 Pro 真机验收仍待进行,详见当前交付记录。com.meta.xr.sdk.core

SDK 的版本号和设备型号不参与资源目标 ID。PICO 与 Meta 即使都是 Android,也必须各自构建、上传、测试和发布。不可把 PICO 的 AB 或 APK 直接当作 Quest 版本。

设备编号与店铺 Key

设备号为五位纯数字。首位 1 对应 Vision Pro,2 对应 PICO Swan,3 对应 Meta Quest 3。四套装机测试号第二位 0 为 Pro,1 为 Dev。后台实际绑定的店铺、项目、SDK 和环境须与设备配置一致。

店铺 Key 为五位字符,包含大写英文字母 A–Z 和数字 0–9。WebAdmin「店铺与 Key」可生成或轮换 Key。店铺记录 ID、项目编号、邀请码各有独立用途。

  1. 扫红色「店铺登录」卡,输入设备号及该店铺的 Key。
  2. 提交并看到「保存成功」,退出并重新打开 allinxr,等项目资源加载结束。
  3. 扫对应项目定位牌。到 WebAdmin「设备管理」找到该设备,状态变为「等待」后勾选并点击「巡游开始」。

四套案例的实际设备号、店铺 Key 和定位原图见 管理员运维手册。

上传 Android Pro 的正确操作顺序

  1. 对应 Unity 工程连接 https://webadmin.allinxr.com/environments/production,确认实际构建平台 Android,并核对 SDK 资源目标。
  2. 编辑器选择项目 Dev,上传美术、定位、定位图和遮罩等数据;后台项目页面选择相同 SDK。项目配置和 AB 的版本号各自独立。
  3. 使用 Addressable 上传工具构建并上传。全量/增量上传均写入该 SDK 的 Dev;完整清单、大小、SHA-256 校验通过后才生成可用 AB 版本。增量只能复用同一 SDK 的版本。
  4. 用相同 SDK 的 Dev 客户端验证四套项目数据、下载、校准和运营流程。协议测试不能代替头显体验。
  5. 在项目管理将验证完成的项目 Dev 发布为项目 Pro。这一步不会自动发布应用 AB。
  6. 构建对应 Player。构建前预留 release,写入后台地址、platform、targetId、releaseVersion;最终 BuildReport 成功后才确认该 release。快照固定当时的 AB、本地化和已发布项目 Pro。
  7. 在全局管理选择该 SDK,使用“选择 Player 版本发布”,发布刚刚确认的 Player 完整快照到 Pro。构建后又修改的项目不进入旧快照,需要重新发布项目并构建新 Player。
  8. 交付的 APK 直接连接阿里云 production,按内置 SDK 和 releaseVersion 读取 Pro。上传新 Dev AB 不会改变旧 Player 已冻结的内容。

上传窗口中的 production 表示服务地址;“内容写入位置:Dev”表示上传落点。要进入 Pro,必须完成项目发布、Player 构建确认和选择 Player 发布。仅改 Inspector 为 Pro 不能完成发布。

后台操作与兼容规则

项目管理、全局管理的下拉菜单按官方 SDK 名称显示;设备绑定可以限定 SDK 和 Dev/Pro;邀请码也绑定 SDK。Meta Dev 完整流程已获用户确认;新版本的 Pro 验收按交付记录逐项确认。AB、Player、项目历史列表只展示所选目标的版本。

协议示例:platform=Android&targetId=com.bytedance.pico.xr 或 platform=Android&targetId=com.meta.xr.sdk.core。SDK 与平台不匹配会拒绝请求。注册表接口是 /as/v2/targets。

为保护已交付客户端,旧请求不传 targetId 时,Android 继续映射 PICO XR、VisionOS 映射 Apple visionOS XR Plugin。旧 Android 下载 URL、数据库键、版本计数和 Player 快照不迁移。Meta 使用自己的目录和计数,从自己的 V1 开始,不共享 PICO 的同号版本。

维护 Meta 工程

  1. 复制独立 Unity 工程,重新配置 Meta SDK、XR Loader、渲染管线、相机权限、应用标识和签名;不要复制运行缓存与私有凭据。
  2. 启用该工程的 ALLINXR_META_XR 编译定义,让公共接入代码使用 com.meta.xr.sdk.core。这只是后台路由开关,不会安装 SDK 或实现 Meta 设备能力。
  3. 接入设备能力适配层。图像识别、空间定位输入可以各自实现,保留已验证的空间校准算法;不要求为了共用后端而改成 AR Foundation 图像识别。
  4. 在已有 WebAdmin 选择 Meta XR Core SDK,按 Dev → 项目 Pro → Player 构建确认 → Player Pro 的相同流程发布,无需再新增 Quest 3 后台分支。
  5. 对 Quest 3 和未来设备逐一验证相机接口、渲染、定位、资源加载及运营流程。新增型号不自动等于兼容通过。

联合维护、验收与备份

共同维护 shan2、Shan2PICOSwan、shan2Meta 三个 Unity 工程、本地 WebAdmin 和阿里云 WebAdmin。公共协议修改同步客户端,平台专用实现和 Unity .meta GUID 保留。本地后端用于备份验证,验证通过后部署阿里云;不整体覆盖云端数据库。

后端回归:在独立验证数据库运行 node scripts/test-shan2.js,数据库管理员凭据通过环境变量注入,不写入 SVN。该测试包含 SDK 隔离、旧客户端兼容、上传完整性、快照、设备与运营流程。测试 AB 是合约样例,不能证明 Unity 资产加载正确。

发布只在专用副本删除全部大小写形式的 .pdb;检查发布目录、实际归档和远端解压目录,并核对 SHA-256。只提交相关源码、配置、测试和无凭据教程到各自 SVN;私有 HTML、UserSettings、Library、日志、构建产物和密码不提交。

Quest 3 已连接用于本轮验收;构建、安装、识别、校准和后台流程分别记录结果,不将后台接口通过等同于硬件体验通过。

返回项目与门店管理

Meta Quest 3 图像识别与构建教程