Appearance
版本更新说明
2.7.3（推荐）
TIP
重点关注
- XRMan 作为优先推荐使用的组件。完善了相关使用。支持右键添加和迁移旧模式到 XRMan。
- 变更部分 Mesh 的基础类的命名空间和目录，从 SpatialMesh 空间移入 Conmmon 空间。
- 支持 Unity Localization 进行响应 AROS 进行多语言适配。
- Input 优化和变更。增加交互的 LayerMask,优化交互细节，对手和手柄增加可见性，射线交互，触碰交互，物理交互的设置。
- 补充完善系统事件的处理。
- 优化内存。
- 优化 UI 使用。
- 修复若干已知问题。
详情见 V2.7.3
v2.7.1
TIP
重点关注
- 变更部分命名空间，从 EZXR.Glass.Core 变更为 EZXR.Glass.Runtime
- InputSystem 类有变量更名，包括手和手柄。
- InputInfo 增加信息。对手和手柄增加可见性，射线交互，触碰交互，物理交互的设置。
- 手柄按键 Return 改为 Back。
- 新增 XRMan 组件和类，方便整体性使用 AR 开发，对各组件进行了整合。
- 修改空间计算和图像跟踪的初始化流程，解绑 asset 资源解压复制和 manager 的初始化，归入 demo 级别逻辑，实际应用根据情况参考修改。
- 旧版本录屏 RecordingManager 新增支持录制音频，但需传入 AudioListener。
- 修复若干 UI 和交互的问题
详情见 V2.7.1
V2.7.0
开发指南参考：
- 【特性】新增获取全部平滑网格数据功能,依赖系统 OS0.6.0；
- 【特性】新增保存全部平滑网格数据功能，保存格式为 ply 格式，目录为 SDCard/Download；
- 【特性】新增 mesh 的开启关闭接口，使用 SpatialMesh 功能建议更新最新的 SDK 以及 OS 版本；
- 【特性】允许开发者从外部设置射线的方向以及发射点；
- 【特性】UnityWarp 模式兼容车载镜片(20231113)和 DVT 镜片(20230510)的上屏逻辑；
- 【特性】新增二维码扫描功能，及 Demo；
- 【特性】重构代码结构，修改 EZXRGlassSDK 目录，以 UPM 推荐目录格式整理，其中 core 改名 Runtime，部分代码移入新增 Common 目录；
- 【特性】重构代码结构，废除 EZXRGlassSDK/EZXRPlugin 和 ezxrcommon，拆分代码到 Runtime/common 和空间计算及图像跟踪等其他目录中；
- 【特性】重构代码命名空间，统一命名空间，均以 Ezxr.Glass.xxxx 规范，废除类似 ExrGlass 等命名空间；
- 【特性】重构 SpatialComputing 代码结构，以 SpatialComputingManager 为唯一管理脚本，资源复制等脚本归类为 Demo 脚本功能；
- 【优化】手的 wrist 节点更改为 wrist 的父级节点；
- 【优化】手柄控制信息增加 tipPoint；
- 【优化】优化调整 Mesh Demo，Tracking2D Demo，SpatialComputing Demo，方便开发者理解这部分内容；
- 【优化】mesh 有关计算改为异步执行，不占用主线程开销；
- 【优化】调整部分脚本执行优先级，优化数据周期；
- 【优化】变更 RGBPreview 预制体和脚本，便于直接使用；
- 【修复】修复 projectionManager 重复实例化的问题；
- 【修复】修复 canvas 触发区厚度偏小问题；
- 【修复】修改 ugui 的 eventCamera 指定，从 leftCamera 更改为自动根据指尖区域所在相机；
TIP
- OS 版本要求最低为：0.5.1
- 硬件版本要求最低为：DVT2
TIP
版本升级提示：
- 不同版本的 SDK 之间存在不确定性，故而推荐在更新新版 sdk 之前，先删除旧版的 SDK；
- AROS 升级至最新的 0.3.0 版本，可以在连网环境下进入眼镜设置功能的关于本机界面进行 OTA；
- 0.3.0 中将 HandRig 模块和 HandleController 模块整合为了一个 InputSystem 模块，所以需要将场景中的 HandRig 和 HandleController 删除并换为 InputSystem（可参考输入系统（InputSystem）文档）；
V2.6.0
开发指南参考：V2.6.0
- 【特性】新增反畸变 101 个控制点的兼容支持；
- 【特性】新增 URP、HDR、后处理文档指引支持，参考 URP 管线适配、使用 HDR 与后处理
- 【优化】优化手柄-手势交互，补充手柄事件、优化手势/手柄自动切换功能、更新模型手；
- 【优化】优化 RGB 在大场景下的曝光适配策略；
- 【优化】优化空间计算及 Tracking2D 的命名空间和代码管理；
- 【特性】新增手势字段"手指弯曲度"；
- 【优化】优化 NormalRGBCameraDevice 部分接口，避免跨接口获取该功能；
- 【优化】优化获取指定图像接口：提供灰度 raw，jpg，rgba_raw；
- 【修复】修复 systemUI 未崩溃但不运行，偶现伴随 Server 重启或 Server 异常问题；
- 【特性】新增接入空间计算 SDK V1.2.0 版本；
TIP
- OS 版本要求最低为：0.5.1
- 硬件版本要求最低为：DVT2
TIP
版本升级提示：
- 不同版本的 SDK 之间存在不确定性，故而推荐在更新新版 sdk 之前，先删除旧版的 SDK；
- AROS 升级至最新的 0.3.0 版本，可以在连网环境下进入眼镜设置功能的关于本机界面进行 OTA；
- 0.3.0 中将 HandRig 模块和 HandleController 模块整合为了一个 InputSystem 模块，所以需要将场景中的 HandRig 和 HandleController 删除并换为 InputSystem（可参考输入系统（InputSystem） 文档）；
补充插件：
2DMarker 算法配置工具：https://gitlab.com/InsightAR/ezxrcore/ezxrtools.git（UPM 方式导入）
V2.5.0
- 【特性】MTP 优化反畸变逻辑，控制点大于 51 或者是采样小于控制点，直接启用控制点作为 mesh；
- 【特性】MTP 新增接受 texturearray 的纹理的接口；
- 【特性】新增接口 getLatestPose_RgbCamera()用于获取对应 Head 最新时刻的 Pose；
- 【特性】为 systemui 添加 crash 重启机制；
- 【特性】新增允许开发者通过调用接口来设定是否允许进入待机模式的接口；
- 【特性】新增新的录屏/投屏/截屏框架，保留旧框架；
- 【特性】恢复右键菜单对 SpatialUl 添加 SpatialEventSystem 和 SpatialUIController；
- 【特性】增加手柄跟踪是 3dof 还是 6dof 的状态事件注册和触发；
- 【特性】NormalRGBCameraDevice 增加 getCameraSize 接口获取尺寸；
- 【修复】修复接收广播时对是否存在指定 key 的检查，避免类似 getlnt 返回无效默认 0 值情况；
- 【修复】补充 m_tracking2dController 的销毁，修复 tracking2d 多场景切换 bug；
- 【修复】修复投屏时手与 camera clearFlags 设置影响不渲染问题；
- 【优化】录屏/投屏/截屏时 RGBCameraPose 使用新增接口 getLatestPose_RgbCamera()
- 【优化】补充 Editor 模式下左右眼及 RGB 的参考信息（FOV，相对位置等）
- 【优化】优化多屏幕管理避免与新系统投屏（OS 0.4.0）冲突
- 【优化】补充对预测 pose 的缓存，减少 CS 通信带来的不稳定
TIP
- OS 版本要求最低为：0.5.1
- 硬件版本要求最低为：DVT2
TIP
版本升级提示：
- 不同版本的 SDK 之间存在不确定性，故而推荐在更新新版 sdk 之前，先删除旧版的 SDK；
- AROS 升级至最新的 0.3.0 版本，可以在连网环境下进入眼镜设置功能的关于本机界面进行 OTA；
- 0.3.0 中将 HandRig 模块和 HandleController 模块整合为了一个 InputSystem 模块，所以需要将场景中的 HandRig 和 HandleController 删除并换为 InputSystem（可参考输入系统（InputSystem） 文档）；
补充插件：
2DMarker 算法配置工具：https://gitlab.com/InsightAR/ezxrcore/ezxrtools.git（UPM 方式导入）
V2.4.0
- 交互整合手柄和手势为 InputSystem，优化手柄，手势，及其他交互相关体验;
- 添加待机响应处理;
- 适配 OS 0.3.0, 删除旧接口，优化共享内存，优化周期管理;
- 移除 SpatialPositioning 模块;
- 修复若干已知问题;
TIP
- OS 版本要求最低为：0.3.0
- 硬件版本要求最低为：DVT2
TIP
版本升级提示：
- 不同版本的 SDK 之间存在不确定性，故而推荐在更新新版 sdk 之前，先删除旧版的 SDK；
- AROS 升级至最新的 0.3.0 版本，可以在连网环境下进入眼镜设置功能的关于本机界面进行 OTA；
- 0.3.0 中将 HandRig 模块和 HandleController 模块整合为了一个 InputSystem 模块，所以需要将场景中的 HandRig 和 HandleController 删除并换为 InputSystem（可参考输入系统（InputSystem） 文档）；
SDK：
补充插件：
2DMarker 算法配置工具：https://gitlab.com/InsightAR/ezxrcore/ezxrtools.git（UPM 方式导入）
V2.3.2
- 优化手柄抖动与延迟；
- 截屏、录屏、投屏功能内置至系统；
TIP
- OS 版本要求最低为：0.2.2
- 硬件版本要求最低为：DVT2
SDK：
补充插件：
2DMarker 算法配置工具：https://gitlab.com/InsightAR/ezxrcore/ezxrtools.git（UPM 方式导入）
V2.3.1
- 新增 Tracking 2D 插件，用于支持 2DMark+6Dof 能力；
- 新增 Spatial Computing 插件，用于替换原有的云定位插件；
TIP
- OS 版本要求最低为：0.2.1
- 硬件版本要求最低为：DVT2
SDK：
补充插件：
2DMarker 算法配置工具：https://gitlab.com/InsightAR/ezxrcore/ezxrtools.git（UPM 方式导入）
V2.3.0
- 新增支持手柄交互
TIP
- OS 版本要求最低为：0.2.1
- 硬件版本要求最低为：DVT2
v2.0.0
View on GitLab
更新日期：2023.6.2 兼容 EZXR OS 版本：v 0.1.0、v 0.1.0 beta6
- 【特性】拆分为 Servicer 和 SDK 两部分
Service
- 【特性(实验)】 暂时关闭手柄功能的调用
- 【特性】 更新手势库为 2.2.2
- 【特性】 为相关库添加加固保护
- 【特性】 添加手势 DSP/GPU 运算模式切换
- 【特性】 更新默认签名为固件 0515 版本系统签名
- 【特性】 增加 RGB 相机运动模糊判断
- 【优化】 初步添加 Server/Client 版本兼容管理
- 【优化】 标定及 SN 优先访问保留分区数据，访问失败则访问 SDCard/insightar 数据
- 【优化】 移除对 Client 查询 Server 的广播监听
- 【优化】 移除 persistent 属性
- 【优化】 对 RGB 相机，启用自动曝光策略
- 【优化】 修改 RGB 固定分辨率为 1280*960（依赖固件及标定）
- 【优化】 对相机服务异常进行监听并在其崩溃后重启整个 Service
- 【优化】 优化共享内存的读写访问
- 【修复】 修复手势算法库关闭时的重复关闭问题
- 【修复】 修复 RGB 定焦设置失败问题
- 【修复】 修复 RGB 关闭再打开不可用异常
- 【修复】 修复 RGB 关闭偶现崩溃问题(可能未完全修复成功)
- 【修复】 修复手势退出时的死锁异常
- 【修复】 修复手势在初始化阶段设置运算模式不生效问题
- 【修复】 在 service 退出时销毁 server 进程，用以保护手势或其他算法的退出异常不影响下一次进入
- 【修复】 修复共享内存及共享锁的崩溃及死锁问题
- 【修复】 修复 NDKIMU 数据遗漏问题
- 【修复】 修复 camera 中设置参数时 id 匹配错误
- 【修复】 修复 Config 传递后计算错误问题
- 【修复】 修复 Service 退出时不能正常释放 IMU 问题
- 【修复】 修复 Camera 和 IMU 代码管理的调用周期错误
SDK
- 【特性（实验）】 新增虚拟键盘功能
- 【特性（实验）】 feat(UnityWarp)：新增 unity 侧实现的初版 warp
- 【特性（实验）】 WristPanel 暂时添加 RemoveListener 接口，允许开发者屏蔽掉系统菜单的显示
- 【特性】 手势新增属性 CurRayGrabbingSpatialObject 和 CurCloseGrabbingSpatialObject
- 【特性】 手势 SpatialObject 增加了 SetPosition、SetRotation 和 SetScale 方法
- 【特性】 手势 SpatialObject 重构了 Inspector 的呈现方式，采用了和 EventTrigger 一致的 Add Event 的方式来添加开发者需要的响应事件
- 【特性】 SpatialUI，新增了几个 SpatialButton 的衍生类，并且给一些 SpatialButton 的衍生类加了自定义 Inspector
- 【特性】 更新投屏渲染逻辑，废弃 commandbuffer 改为 Quad 投影
- 【特性】 新增将场景中物体重置到相机前功能（非相机自身的 Recenter）
- 【特性】 增加了基于 TMP 的空间中显示的 FPS 和 TrackingStatus 这两个 Prefab
- 【特性】 定位库增加平滑功能，重定位后可平滑调整
- 【特性】 为 Server 异常退出情况添加重启机制
- 【特性】 手增加了每个关节点的坐标系显示
- 【特性】 新增了手部射线生效距离，决定了从食指根节点发出，以肩部到食指根节点为方向，射线的起始点位置
- 【特性】 添加了 SystemManager，且将 SystemManager 改为了全局唯一 DontDestroy
- 【特性】 给多个模块添加了 dontdestroy 相关逻辑，且保证即使多场景存在也只使用第一个实例，确保跨场景使用没问题
- 【特性】 SpatialUIBase 新增 interactable，用于控制 UI 是否可交互
- 【特性】 重构了 SpatialButton 的事件触发回调逻辑，以及与 SpatialSelectable 的部分继承关系
- 【特性】 SpatialUIBase 新增 textColor，用于控制 UI 的文字颜色
- 【特性】 SpatialButton 新增 Add New Event Type 来支持处理更多事件，而不是之前的纯粹只有 onClick
- 【特性】 新增获取设备 sn 的接口
- 【特性】 新增 3D 物体跟踪功能
- 【特性】 Recording 功能对外释放
- 【特性】 新增手势热切换（gpu 和 dsp）
- 【特性】 允许 HandsVisualization 组件被关闭的时候隐藏手的显示
- 【优化】 HandSimulator 默认采用右手，主要是因为 UGUI 目前只能用右手交互
- 【优化】 支持录屏和投屏中对分辨率的设置修改
- 【优化】 更新 NativeLib-0524.aar，这个对应了把游戏服务合并进去的 ezhelper，统一 SN
- 【优化】 RecenterUtility 和 ARAbilities 修改了文件位置
- 【优化】 适配 Launcher 包名修改调用
- 【优化】 优化手势射线的开关
- 【优化】 手和 UGUI 的交互只保留了右手，暂时屏蔽了左手
- 【优化】 设置默认帧率为 60
- 【优化】 优化 stereoRenderer 中 RendererState 的状态机管理
- 【优化】 优化共享内存的读写访问
- 【优化】 重构了腕表代码，以多例模式对外给出，开发者可使用 WristPanel.Left 或者 WristPanel.Right 来向指定的腕表添加触发回调
- 【优化】 重构了 SpatialUI 的 GridLayout 功能
- 【优化】 重构了 SpatialButton 的按下弹起逻辑，使响应更正常，尤其是一些临界条件时的触发效果
- 【优化】 针对 Android 线程回调 Unity 主线程做了安全转化，确保 Unity 中注册的回调以线程安全方式被调用
- 【优化】 重新排序了脚本执行顺序
- 【优化】 目录结构更改：将 Keyboard 整体移动到 SystemManager 下
- 【修复】 修复手势与 UI 碰撞触发的不合理
- 【修复】 修复 MiraCast 组件管理
- 【修复】 修复 MTP 在 resume 时因未及时初始化导致崩溃异常
- 【修复】 修复共享内存访问异常导致死锁问题
- 【修复】 修复 Service 重连时的周期管理异常
- 【修复】 手势修复了 isPinching 的判定逻辑
- 【修复】 修复手势 HandRay 中之前所写的的 ExecuteEvents.Execute 触发事件
- 【修复】 修复左手射线会被腕表影响而无法发出
- 【修复】 修复了 SpatialPanel 的包围框的显示错误
- 【修复】 补充 UGUIHandler 的全局唯一实例
- 【修复】 修复了潜在的 SpatialUIController 的 camera 为空的问题
- 【修复】 修复了 SpatialUIElement 设置 Text 的时候并没有改变 Text 的可见性的问题，应该文字为空时隐藏，不为空时显示
- 【修复】 修复录屏和投屏中 CullingMask 不生效问题
- 【修复】 修复录屏和投屏中无 RGB 相机背景的异常
- 【修复】 修复启动 SDK 时过早进行手势切换运算模式不生效问题
Unity Editor
- 【特性】 Eidtor 中的 HandSimulator，新增了左右手的切换接口
- 【特性】 导出模块加入了对 Recording 的导出功能
- 【特性】 去除 EAXRUnityPlayerActivity.java 的第一入口依赖
- 【优化】 优化 Editor 下工程导出管理
- 【修复】 sdk 导出模块没有导出 GlassClient.aar 以及 EZXRUnityPlayerActivityjava
- 【修复】 导出模块缺少对 SystemManager 的导出逻辑
- 【修复】 修复没有 MiraCast 的项目里面导入 sdk 出现的报错
- 【修复】 修复了导出的 sdk 的 WristPanel 为白色
- 【修复】 修复了在 unity2021 以上版本 IssueFix 中 FixGraphicsAPI 无效的问题
- 【修复】 导出模块，Build 模块，IssueFix 模块共同适配了 recommendedAPILevel，以避免在日后工作中由于不同眼镜需要的 api level 不同造成的潜在问题
- 【修复】 bugfix: 修复了 2021 以上不再支持 GLES2 的问题
- 【修复】 sdk 导出模块导出 x1 的单机版的时候没有带出 hand 的 aar
- 【修复】 修复了 SpatialUIController 在 Editor 模式下的 camera 为空报错