跳到主要内容

测试打包

插件版本 1.2.3 | 文档版本 1.2.3 | UE 5.3-5.7 面向读者:接入开发、发版同学 本篇自包含:测试流程、版本号规则、包体格式、DS 打包一次讲完。


目录​

  • 一、单人测试

  • 二、多人 & 播控联调测试

  • 三、全真大空间测试

  • 四、打包格式

  • 发版前检查清单


概述​

LBEVR 内容的调试往往占据开发时长的大头。推荐按三阶段递进测试(与 Unity 版同一模型),每阶段通过再进下一阶段,兼顾效率与稳定性:

一、单人测试        编辑器单场景 → 编辑器全流程 → 一体机全流程
二、多人 & 播控联调 DS + 多客户端互见 + 播控指令收发
三、全真大空间测试 真实场地地图 + 定位点 + 最佳路径,本地全真模拟放映

📷 【截图待补】 三阶段测试流程图


一、单人测试​

1.1 编辑器单场景测试​

目的:测试单个场景内的路径切换与表现效果。

操作:

  1. 打开目标关卡,确认场景内 Act / Plot 摆放正确、顺序正确

  2. 打开 SettingPanel(菜单 YOMOV SDK → SettingPanel)→ 点 [Update Act Sequence] 生成路径运行顺序

  3. 点击编辑器 Play 运行

⚠️ PIE 默认不自播(bAutoStartInPIE 默认 false)——日志会出现 StartPlay auto-start suppressed (waiting for remote playback control)。手动开演有两种方式:在 Editor Console 调 FC.StartPlay,或在 DA 中打开 bAutoStartInPIE。

📷 【截图待补】 SettingPanel 中 [Update Act Sequence] 的位置

1.2 编辑器全流程测试​

目的:从初始化场景跑完整放映逻辑。

操作:

  1. 按 §1.1 步骤 1–2 完成烘焙

  2. 打开初始化场景(PersistentMap),点击 Play

  3. 观察完整链路:场景加载 → Plot 推进 → 跨 Act 转场 → 叙事完结 → 报幕

1.3 一体机全流程测试​

目的:Android 真机全流程验证。

操作:

  1. 按 §1.1 步骤 1–2 完成烘焙

  2. 打包参数选择 PackagingType = Test

  3. 打包 Android 并安装到设备

  4. 运行观察全流程

⚠️ PackagingType 决定是否自动开演:仅 Test 类型自动开演(对齐 Unity Test 模式的 SetSinglePlay);Release / OpenPackage / TrailerPackage / Vgen一律等播控 Start。PIE 不受此影响(PIE 默认不自播,见 §1.1)。

设备与引擎版本对应:

引擎版本

Android NDK

UE 5.3 – 5.6

r25b(25.1.8937393)

UE 5.7

r27c(27.2.12479018)

  • 设备兼容性:Pico4 Ultra 全版本验证通过;Pico4E 仅 5.3–5.6(5.7 存在 OpenXR swapchain 问题)

  • 设备日志路径:Logs/<date>/YOMOVSDK.log


二、多人 & 播控联调测试​

若内容不接入 SDK 多人同步(03 流程 B),跳过本节。

2.1 PIE 2 玩家快验(免打包,先跑这个)​

目的:不打包 DS 的情况下快速验证多人逻辑。

最小配置:

  1. 新建 PersistentMap + 叙事 sub-level(含 VRPawn / FirstPerson + PlayerStart)

  2. 关卡 World Settings → GameMode Override = BP_YomovDSGameMode;Project Settings → Maps & Modes → Player State Class = AYomovPlayerState

  3. DA_DataAsset 配好 InitialSceneName + Avatar 字段;DA_CommandLineArgs 配好 BridgeServerIP / BridgeServerPort

  4. PIE 设置:Number of Players = 2,Net Mode = Listen Server

  5. 启动 Bridge 服务器后 Play

验证:两个玩家互见 = 链路通。日志核对见 §2.4。

⚠️ PIE 的边界:PIE 只能验证 host / server 视角逻辑(client world 不可达);per-client 严格验证仍需真打 DS + 真客户端。另外单玩家 PIE 走不通 DS→Bridge 链路(无远程 client 触发 Server_Login RPC),必须 2 玩家。

2.2 真机多人联调​

操作:

  1. 打 DS:见 03 §步骤四

  2. 客户端参数配置:DA_CommandLineArgs 填 ServerIP(DS 所在 PC 网络 IP)、ServerPort(与 DS config.ini 的 serverPort 一致)

  3. 运行环境:建议一个客户端从编辑器启动、另一个从一体机启动,确保两侧设备连接同一 Wifi 网络

  4. 启动顺序:推荐先启动 BridgeServer → 再启动 DS → 最后启动客户端。1.2.3 起 Bridge 后起 / 中途重启由 DS 自动重连恢复(1s 间隔),但首连阶段仍建议先起 Bridge 省一轮等待

  5. 客户端自动连接 DS,创建多个玩家角色

2.3 内容模拟器(跨内容玩家)​

用 ContentSimulator 模拟其他内容客户端向 Bridge 发送队伍玩家信息,验证跨内容玩家在本端 DS 的展示是否正确。

工具

路径

用途

测试桥接服务器

<TOOLS_ROOT>/BridgeServer*/BridgeServer.exe

替代真实业务服务器,收 DS msg 500 上报 + 下发 msg 501 / 503;轻量,本地联调首选

玩家模拟器

<TOOLS_ROOT>/ContentSimulator/ContentSimulator/ContentSimulator.exe

模拟其他内容客户端发队伍玩家信息给 Bridge

典型顺序:启动 BridgeServer → 启动 DS → VR 客户端连入 → 用 ContentSimulator 注入跨内容玩家 → 观察 VR 客户端是否 spawn 远程 Avatar。

2.4 验证标志​

标志

日志关键字

端

期望

客户端登录 DS

Server_Login success

客户端

每个客户端连入都出现

DS 连上 Bridge

UTCPClientSubsystem: Connected to

DS

出现在 Server_Login 之后

远程 Avatar spawn

Spawned remote player

客户端

看到其他客户端时出现

Avatar 分流

ResolveAvatarClass

客户端

TeamID 匹配选 DefaultAvatarClass,否则 NonTeamAvatarClass

DS 监听端口

YomovIpNetDriver + 9527

DS

不是 7777

可见性规则

Visibility: rules active (ShowDist=...)

客户端

1.1.1 起默认开启;距离按本机头显位置计算(1.2.3)

启动指纹

[Fingerprint] engine=... core=... ContentID=...

客户端 + DS

1.2.3 起启动一行;两端比对 core= / 模式 / ID 是否一致(排除错版 / 错配置)

上行持续

[Uplink] msg500 submitted teams=N players=M

DS

1.2.3 起 1s 降频;持续出现 = DS→Bridge 链路正常

建议顺序:先看 DS 端 YOMOVSDK.log,再看客户端 YOMOVSDK.log。stdout 有缓冲,排障以日志文件为准。


三、全真大空间测试​

目的:在真实场地用扫描地图 + 定位点 + 最佳路径,做本地全真模拟放映。

3.1 设置最佳路径​

最佳路径的二元作用:

  1. 接入阶段:按本地测试场地尺寸(如 6×8、8×10m)摆一条路径,完成本地全真模拟测试
  1. 发行阶段:导出的是导演视角的最佳体验路径——分发算法适配场馆地图时会读取路径中单元的相对位置与旋转角度作为计算权重,尽可能还原最佳体验

操作:

  1. 菜单 YOMOV SDK → Open BestPath Editor(或在 SettingPanel 的 Sequence 区点击按钮,带当前 Narrative 上下文)

  2. 在画布上摆放各 Act 的位置与旋转:左键点选后拖动移动;Shift + 左键拖动旋转;方向键微调

  3. 校验通过后点 [保存路径]——一键双写到 PathExport/ActSetting.json 与 Content/PathData/BestPath.json(运行时唯一读取源)

⚠️ [保存路径] 不落盘:浮泡会提示「Ctrl+S 保存资产以持久化」——仍需手动 Ctrl+S。

画布摆放不是随手排,是在给算法定「体验基准」。路径设计原则(尺寸 / 衔接 / 三区语义)见 05 大空间最佳实践;画布交互细节见 09 §BestPath。

📷 【截图待补】 BestPath 编辑器入口与画布 🎬 【视频待补】 拖拽 / 旋转 Act 的操作演示

3.2 绘制大空间地图与定位点​

  1. 通过设备(如 PICO4)在测试场地中扫描大空间地图

  2. 设置大空间定位点——建议设置在场地几何中心

原理:全真模拟放映时,会拿最佳路径内的定位向量与大空间扫描的定位向量做匹配,实现大空间 VR 的定位播放。定位点偏差会直接表现为内容与物理空间错位。

📷 【截图待补】 设备端大空间扫描与定位点设置界面

3.3 模拟器联调​

通过播控模拟器模拟播控系统启播流程 + 连接桥接服务器实现多内容数据同步。

具体操作见外部文档:YOMOV 播控模拟器说明。


四、打包格式​

4.1 导出配置文件​

  1. 基于最佳路径绘制流程,设计一条期望的最佳路径(见 §3.1)

  2. 确认路径范围与配置无误后,在 SettingPanel 点 [Export] 导出内容数据三件套 + 俯视截图到 <项目目录>/PathExport/

  3. 将配置文件给到游幕内容平台接入人员,上传到分发运营平台——分发时通过算法自动完成对场馆地图的适配

⚠️ 导出前会自动跑一遍烘焙,确保导出的是最新值。导出只标脏不落盘,仍需 Ctrl+S。

导出产物(供游幕 MapEditor / PathEditPanel 消费):

产物

内容

ActSetting.json

每 Act 的 sceneName / StartPoint / EndPoint / Points(=ActArea) / BestViewPoints(=主区域) / StartArea(=进入区) / Duration / WaitTime / StageName 等

Stage.json

{ContentName, StageList[]}:StageName = ActName、Order、AreaList(AreaName = PlotName)

TestMapEditData.map

场馆数据(StartPoint / LocatePoint / ArcadePoly / Obstacles)

{ActName}.png

每 Act 正交俯视截图(作 2D 画布底图)

BestPath.json

Act 序列点表 + 场馆数据 + 每 Act 的场馆摆放位置与角度(实际保存在 Content/PathData/)

4.2 应用打包流程​

  1. 打开 SettingPanel → 点 [Update Act Sequence] 更新路径运行顺序

  2. 打包参数选择 PackagingType = Release(Test 会自动开演,发行包不能用)

  3. 打包 Android 平台

📷 【截图待补】 PackagingType 下拉选择 Release

4.3 版本号规则​

客户端与服务端版本务必按 X.Y.Z(主.次.修订)格式:

位

何时递增

示例

主版本号

重大功能更新或架构变更

1.0.0 → 2.0.0

次版本号

新增功能或改进

1.0.0 → 1.1.0

修订号

bug 修复或小改动

1.0.0 → 1.0.1

比较规则:逐位比较,1.2.1 < 1.2.2 < 1.2.3。包体上传与后台校验按此识别版本新旧。

4.4 包体格式(提交分发平台)​

当前 YOMOV 内容分发平台的【应用及版本管理】功能暂未开放给外部开发者使用,需打包后通过网盘等方式将包体更新给到游幕对接人。

客户端​

后台校验原则:

  1. 必须上传 zip 压缩包,不支持直接上传 apk 文件

  2. zip 包内必须包含 apk 文件

  3. zip 包内只允许有 1 个 apk 文件,超过 1 个校验失败

  4. 系统会自动解析 apk 的应用名称和版本号

  5. 压缩包中没有 apk 文件 → 判定为不合法包

client-package-v1.0.0.zip
└── app-release.apk

服务端(DS)​

后台校验原则:

  1. 目录名需要加版本号

  2. 版本号目录名至少包含两个点,例如 1.0.0、2.3.15

  3. 压缩包内必须包含 exe 文件

  4. 主安装程序 exe 必须放在压缩包的一级子目录内

  5. 要求仅有 1 个 exe 程序,避免系统无法正确识别

server-package-v1.0.0.zip
└── 1.0.0
└── xxx.exe

示例

判定

1.0.0/xxx.exe

✅ 正确

2.3.15/app.exe

✅ 正确

xxx.exe(直接在压缩包根目录)

❌ 错误

1.0.0/windows/xxx.exe(目录层级过深)

❌ 错误

20260330/app.exe(目录名不是版本号格式)

❌ 错误

DS 打包产物是 WindowsServer/ 目录树(见 03 §4.3),压缩时保持 exe 在一级版本号目录下。

资源包分发限制​

平台不支持以下资源包分发形式:

  • APK 包下载后,人工手动拷贝资源包到头显设备

  • APK 包下载后,需要运营人员手动点击进行安装下载

OBB / AssetBundle 等资源包形式,以及 UE 侧特殊打包形态(如 Android OBB split),提交前请与游幕对接人确认。


发版前检查清单​

发版前逐条确认(多人相关):

  • 单人三阶段测试全部通过(编辑器单场景 / 编辑器全流程 / 一体机全流程)

  • 多人联调通过:Server_Login success + Spawned remote player 出现,远程 Avatar 可见且动作正确

  • 各端使用同一份 DA(边界字段完全一致)

  • 全真大空间测试通过:边界对齐、虚空、转场表现正常

  • 最佳路径已摆放、已 [保存路径]、已 Ctrl+S 落盘

  • [Export] 产物已导出并交付游幕对接人

  • 打包用 PackagingType = Release(不是 Test)

  • 客户端 / 服务端版本号按 X.Y.Z 格式,且已递增

  • 包体格式符合 §4.4 校验原则(客户端 1 个 apk;服务端一级版本号目录 + 1 个 exe)

更细的接入前检查清单(关卡 / DA / Pawn / 端口)见 03 §接入完成检查清单;多人问题排查见 08 FAQ。