更新说明 / Changelog
v1.0.2

更新说明

本文列出 Slhx SDK 各发布版本的主要变更。 详细接入步骤见 SDK 开发文档

最新:1.0.2 Unity 2022.3 UPM 双包
图例 新增 优化 修复 移除 注意

v1.0.2 当前版本

发布形态:slhx-upm-1.0.2-release.zipcom.slhx.sdk + com.slhx.samples) · 相对 v1.0.1 的迭代

摘要

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.toolkit2.6.5
com.unity.xr.hands1.4.3
com.unity.inputsystem1.14.2
com.revenantx.litenetlib1.3.3
com.tuyoogame.yooasset3.0.4

v1.0.1 首个发布

发布形态:slhx-upm-1.0.1-release.zip · Slhx 内容端 SDK 的首个 UPM 正式发布

摘要

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 起)

约定说明
Unity2022.3.x LTS
Android 桥接包名固定 com.slhx.android
lycj 目录真机 /sdcard/Download/lycj
PICO SDK接入工程自备,不随 Slhx zip 分发
OpenUPM需配置 LiteNetLib、YooAsset

从 1.0.1 升级到 1.0.2

  1. 备份接入工程。
  2. 删除或替换 Packages/com.slhx.sdk 与(如有)com.slhx.samples 为 1.0.2 包内容。
  3. 确认 manifest.json 中 OpenUPM 与依赖版本仍可解析。
  4. 保证入口调用了 FrameworkBootstrap.InitFramework()(若使用 Framework)。
  5. 打开含体验区 / NetworkedObject 的场景,确认编译通过后保存场景
  6. 若使用 Agent 回传,确认双广播默认行为是否符合现场管控部署;必要时收窄目标包名。
  7. 回归:Boot 配置读取、进房、Avatar、体验区切换、权限与广播。
API 迁移 体验区相关请优先使用 ContentExperienceHandler 公开方法; 预览边界请改用 ShowExperienceAreaPreview

后续规划(非承诺排期)

方向说明
1.1.x 管控 IPC 增强(如 AIDL 主通道)、与广播过渡策略
Samples / UPM Package Manager Samples 导入体验(Samples~)持续完善
文档与接入 HybridCLR + Yoo 推荐接入说明、更多场景化示例

上表为方向性说明,具体以正式发版说明为准。