维护日期:2026-11-15。本页不含账号、密码或门店 Key。私有接入资料统一保存在本机 D:\unityproject\Documentation\AllinXR-WebAdmin-统一运维手册.html。
安装包显示版本、系统构建号、后端 Player 记录、AB 资源版本是四个独立编号。以当前 Meta 为例:1.0.20(21)对应 Player 29、AB 2。无需在头显登录框输入 Player 编号。
项目发布与 Player 发布是两步。后续项目修改不会改写旧 Player 的冻结快照。仅补一个已构建包的 Pro 发布状态不需重打包;代码变化要新客户端;资源或序列化依赖变化才按影响决定 AB 重建范围。后台 deployment 的 production 与客户端内容 Pro 也是两个概念。
| 维度 | 选项 | 作用 |
|---|---|---|
| 后台部署环境 | production / test | 连接哪套后台服务和数据库。production 不等于内容 Pro。 |
| 构建平台 platform | Android / VisionOS | Unity 的实际 BuildTarget,决定原生应用平台。 |
| SDK 资源目标 targetId | 下表的官方 SDK 包 ID | 隔离 AB、本地化、项目配置/图片/遮罩、Player 快照、邀请码和设备绑定。 |
| 内容环境 | Dev / Pro | Dev 是编辑上传的工作版本;Pro 是已发布内容或指定 Player 的冻结快照。 |
| 官方 SDK 名称 / targetId | 平台与设备 | 工程与状态 | 资源目录键 |
|---|---|---|---|
Apple visionOS XR Plugincom.unity.xr.visionos | VisionOS / Apple Vision Pro | D:\unityproject\shan2保留原有平台适配;本机 Windows 的脚本编译不能代替 Xcode/真机验收。 | VisionOS |
PICO XRcom.bytedance.pico.xr | Android / PICO Swan | D:\unityproject\Shan2PICOSwan本机 SDK package.json 名称为 PICO XR、版本 6.1.1。 | Android |
Meta XR Core SDKcom.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 版本。
设备号为五位纯数字。首位 1 对应 Vision Pro,2 对应 PICO Swan,3 对应 Meta Quest 3。四套装机测试号第二位 0 为 Pro,1 为 Dev。后台实际绑定的店铺、项目、SDK 和环境须与设备配置一致。
店铺 Key 为五位字符,包含大写英文字母 A–Z 和数字 0–9。WebAdmin「店铺与 Key」可生成或轮换 Key。店铺记录 ID、项目编号、邀请码各有独立用途。
四套案例的实际设备号、店铺 Key 和定位原图见 管理员运维手册。
https://webadmin.allinxr.com/environments/production,确认实际构建平台 Android,并核对 SDK 资源目标。上传窗口中的 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 的同号版本。
ALLINXR_META_XR 编译定义,让公共接入代码使用 com.meta.xr.sdk.core。这只是后台路由开关,不会安装 SDK 或实现 Meta 设备能力。共同维护 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 已连接用于本轮验收;构建、安装、识别、校准和后台流程分别记录结果,不将后台接口通过等同于硬件体验通过。