更新说明
本文列出 Slhx SDK 各发布版本的主要变更。 详细接入步骤见 SDK 开发文档。
图例
新增
优化
修复
移除
注意
v1.0.2 当前版本
摘要
1.0.2 在保持 UPM 双包交付与核心接入路径不变的前提下,重点强化 体验区运行时结构、管控通信默认策略、 网络物体 id 制作体验,以及内容联调相关示例与工具能力。
新增
-
新增
体验区模块化运行时:Catalog / Registry / Switcher / Aligner / SafetyPresenter,
门面
ContentExperienceHandler统一公开 API。 -
新增
体验区预览 API:
ShowExperienceAreaPreview;旧ShowBoundary标记 Obsolete。 -
新增
地图体验区配置工具(随 SDK 包交付):
Tools → Slhx → 地图体验区配置工具,支持 placeOperation 导入、线框预览、导出 BoundaryConfig。 -
新增
NetworkedObject编辑器无感自动分配唯一objectId(≥ 1000); 运行时 Spawn 使用高位递增 id,避免与场景烘焙 id 冲突。 - 新增 内容边界 Marker 组件体系(一文件一类),降低对节点命名的依赖。
优化
- 优化 Unity → 管控消息默认双广播至 agent 与 server 包名(可配置),提升多管控并存场景的可达性。
- 优化 体验区与场景解耦:切换路径统一走 Switcher;不在切换逻辑中改写 Layer。
- 优化 出区表现链路收敛:SafetyPresenter → ContentItem → BoundaryPresentation。
- 优化 Samples 内容场景流、房间推进示例整理,便于对照正式业务实现。
-
优化
ObjectSyncHandler生成路径统一BindObjectId,去掉反射写 id。 -
移除
Unity Localization 全链路:
SDK 不再依赖
com.unity.localization, 不再提供ILocalizationService/ Bootstrap 注入; 多语言由内容工程自行处理。
修复与清理
- 修复 多 MonoBehaviour 同文件导致的边界 Marker 编辑器异常风险(按类拆文件)。
- 移除 Runtime 中未就绪的 AIDL 脚手架(主通道仍为系统广播;AIDL 规划后续版本)。
行为与兼容说明
- 注意 若业务曾直接依赖已拆分前的巨型体验区 Handler 内部字段,请改为门面公开 API。
-
注意
NetworkedObject.objectId小于 1000 视为无效;请打开场景保存一次以固化自动分配结果。 - 注意 管控双广播为默认策略;若现场仅允许单目标,请使用 SDK 提供的包名配置接口收窄目标列表。
依赖(以 package.json 为准)
| 包 | 版本 |
|---|---|
| com.unity.xr.interaction.toolkit | 2.6.5 |
| com.unity.xr.hands | 1.4.3 |
| com.unity.inputsystem | 1.14.2 |
| com.revenantx.litenetlib | 1.3.3 |
| com.tuyoogame.yooasset | 3.0.4 |
v1.0.1 首个发布
摘要
1.0.1 完成从大空间模板工程到可复用 SDK 的剥离,形成
com.slhx.sdk + com.slhx.samples 双包结构,
并提供完整接入路径(OpenUPM 依赖、PICO 前置、Boot / lycj、房间与 Avatar 等)。
交付与工程
- 新增 UPM 双包交付:核心 SDK + 可选 Samples。
- 新增 接入约定文档:环境、安装、目录分层、Android 桥与 lycj 路径说明。
核心能力(首发即包含)
- 新增 Framework:服务定位、事件、配置、存档、场景、输入、定时、下载、日志等。
- 新增 UI:UIManager / 页面栈 / Layer / UIBase。
- 新增 Yoo:YooAsset 热更封装、外置资源源、场景加载流水线。
- 新增 HandGesture:手势跟踪与常用手势封装。
- 新增 Game / Room:LiteNet 房间同步(成员、位姿、物体、心跳、时间、事件广播等)。
- 新增 Game / Avatar:多人 Avatar、Catalog 注入、校准相关能力。
- 新增 Game / ToB:Boot 系统、场地 / 边界相关能力、与管控广播桥接。
-
新增
Android 桥:固定 Java 包
com.slhx.android, applicationId 可按产品自定义。
Samples(可选)
- 新增 内容场景表 / 场景流示例、UI Sample、LiteNet 相关演示控制器等。
固定约定(自 1.0.1 起)
| 约定 | 说明 |
|---|---|
| Unity | 2022.3.x LTS |
| Android 桥接包名 | 固定 com.slhx.android |
| lycj 目录 | 真机 /sdcard/Download/lycj |
| PICO SDK | 接入工程自备,不随 Slhx zip 分发 |
| OpenUPM | 需配置 LiteNetLib、YooAsset |
从 1.0.1 升级到 1.0.2
- 备份接入工程。
- 删除或替换
Packages/com.slhx.sdk与(如有)com.slhx.samples为 1.0.2 包内容。 - 确认
manifest.json中 OpenUPM 与依赖版本仍可解析。 - 保证入口调用了
FrameworkBootstrap.InitFramework()(若使用 Framework)。 - 打开含体验区 /
NetworkedObject的场景,确认编译通过后保存场景。 - 若使用 Agent 回传,确认双广播默认行为是否符合现场管控部署;必要时收窄目标包名。
- 回归:Boot 配置读取、进房、Avatar、体验区切换、权限与广播。
API 迁移
体验区相关请优先使用
ContentExperienceHandler 公开方法;
预览边界请改用 ShowExperienceAreaPreview。
后续规划(非承诺排期)
| 方向 | 说明 |
|---|---|
| 1.1.x | 管控 IPC 增强(如 AIDL 主通道)、与广播过渡策略 |
| Samples / UPM | Package Manager Samples 导入体验(Samples~)持续完善 |
| 文档与接入 | HybridCLR + Yoo 推荐接入说明、更多场景化示例 |
上表为方向性说明,具体以正式发版说明为准。