变更日志

此包的所有重要更改都将记录在这个文件中。

格式基于 Keep a Changelog 并且此项目遵循语义版本控制 (Semantic Versioning)。

[1.0.2] - 2020-06-18

已修复

  • 模拟环境不再影响模拟内容的 3D 物理
  • 当场景中不存在 MARSSession/控制摄像机时，Device View 移动将被锁定。
  • 当场景具有功能用户但没有 MARS 会话时无法模拟场景，但缺少警告
  • 修复了暂时不进行模拟时缩放控件在 Device View 中仍然起作用的问题（该问题可能导致裁剪面出现问题）。
  • 对于新创建的环境，Simulation View 不再停留在“背面”视图模式下
  • 现在，新环境对 PlaneExtractionSettings 使用合理的默认值
  • 地理定位快捷方式按钮可以在 shortcutAction 回调中正确传递经度。
  • 启用 URP 或 Composite Fallback 后，模拟环境游戏对象 (Simulation Environment GameObject) Inspector 不再处于锁定状态。
  • 加载环境后或运行 Editor nUnit 测试后撤消操作时，模拟环境光照不会丢失。
  • 修复了使用 URP 并打开 Simulation View 的情况下启动 Editor 时发生崩溃的问题。
  • 修复了将非根游戏对象移至模拟场景根对象 (Simulation Scene Root) 时出现的错误。

已更改

  • GeneratedPlanesRoot 不再跟踪修改。现在，从模拟中保存平面或提取平面始终会警告用户先前的平面将被销毁，向他们说明可以通过将平面移出根部来保留平面，并要求确认是否继续。

[1.0.1] - 2020-06-02

  • 更新了 Unity MARS 许可证

[1.0.0] - 2020-05-29

已修复

  • 在环境的循环过程中，游戏模板场景会在模拟中留下重复的角色
  • 不会调用代理组更新事件的问题
  • 添加合成图像标记时，模拟选择模式会更改

API 更改

  • 向 EditorOnlyDelegates 添加了公共的 GetSimulatedObjectsRoot 委托

[0.9.16-preview] - 2020-05-27

已修复

  • 在启用调试顶点绘制的情况下发现模拟平面时出现异常
  • 文档目录

[0.9.15-preview] - 2020-05-25

已修复

  • 非合成时间模拟中的性能问题
  • Simulation View 或 Device View 在最大化时会自行关闭的问题
  • 确保 Sim Test Runner 未在运行模式下运行
  • 针对模拟发现的内存/GC 优化
  • 更新了所有文档图像
  • 选择模板时记录异常的问题
  • 打开数据库查看器 (Database Viewer) 时记录异常的问题
  • Templates 窗口中名称被截断的问题

[0.9.14-preview] - 2020-05-22

已修复

  • 权利检查未通过时可能发生的其他问题

[0.9.13-preview] - 2020-05-21

已更改

  • 对包和所有命名空间进行重命名以移除“Labs”
  • 更新了权利逻辑以使用生产服务器
  • 最终文档审查

[0.9.12-preview] - 2020-05-19

已添加

  • 让用户能够手动调整每个视频可播放资源的焦距设置，并将这些更改反映在 Simulation View 中。将回退到实时模式下 SimulationVideoContextSettings 中定义的值。

已更改

  • 正在使用可编程渲染管线 (SRP) 时，复合渲染 (Composite Rendering) 自动进入回退渲染模式。

[0.9.11-preview] - 2020-05-19

已修复

  • 在运行模式下重新加载不再导致复合渲染器 (Composite Renderer) 中出现错误。
  • 现在，在模拟中选择了一段合成录制内容的情况下，按下“record”按钮，即可在手动移动模式下开始模拟，而不是播放录制内容。
  • 现在，生成的平面（通过平面提取方式创建的平面以及从模拟中保存的平面）将添加到 Simulation Environment 层中。
  • UI 提示在 Editor 会话之间保持关闭状态。

已添加

  • 实时模拟模式的摄像机权限对话框 -“Simulation Data Visual Settings”项目设置部分。此部分包含一个设置 Rating Gradient（这是一些用于在比较工具上显示反馈的颜色）的选项。
  • 支持可编程的模拟环境模式。
  • 游戏和培训模板已移至可安装的示例包。

已移除

  • CompositeRenderModule.SetupGameView() 和 CompositeRenderModule.TearDownGameView 已设为私有。

[0.9.10-preview] - 2020-05-15

已修复

  • 指定早期版本的 Timeline 和 TextMeshPro 以在 2019.3 的更高补丁版本中修复包依赖关系错误
  • 从实时或录制环境模式切换到合成模式时，模拟不再停留在时间模式下
  • 修复了在播放器构建后 MarkerCondition Inspector 无法绘制的问题
  • 在运行模式下禁用模拟不会再在进入运行模式时引起错误 - 对模拟的发现提供程序使用 DisallowAutoCreation 标志，这样，除非 SimulatedDiscovery 功能岛台处于激活状态，否则不会创建这些提供程序。
  • Unity MARS 在首次导入时启用 Generate all .csproj files 偏好设置，以解决 IDE 项目无法找到 MARS 类型引用的问题
  • 现在，在时间模拟期间按下“play”按钮来停止模拟会将状态重置为单帧模拟，而不是使模拟处于数据消失但代理仍然匹配的状态。
  • 添加了游戏和培训模板

已添加

  • MARSSession.EnsureSessionConfigured 现在会检查现有摄像机的近平面是否大于最大值，如果是，则记录警告并将近平面设置为最大值。此外，还会将新创建的摄像机的近平面设置为较小的默认值。

[0.9.9-preview] - 2020-05-11

已修复

  • 使用版本定义来处理与 Post Processing 包相关的条件编译 - 修复了删除 Post Processing 包时出现的错误

  • 使用文件系统将默认的 Unity MARS 内容复制到 Assets 文件夹中

  • 将 PostProcessUtils 添加到 Bootstrap 程序集以从播放器定义中剥离 UNITY_POST_PROCESSING_STACK_V2（如果缺少 Post Processing 包）

[0.9.8-preview] - 2020-05-10

已更改

  • 从模拟重启方法中删除了 bool forceTemporal 参数，并替换为 RequestSimulationModeSelection 方法，后者可以显式控制下一个模拟是单帧模拟还是时间模拟。
  • 现在，在编辑模式和运行模式下加载时，环境管理器会自动选择模式。修复了从打开的编辑场景以外的场景退出运行模式时可能会意外覆盖映射到面向照摄像机的模式的问题。

已添加

  • 在模拟中支持面部跟踪和表情数据记录
  • 在模拟中支持循环数据记录
  • 面部跟踪和表情数据已添加到示例录像中

已移除

  • 用户可用层不再用于模拟环境对象。
  • 模拟内容不能再在 Simulation View 显示选项中被隐藏或锁定。

[0.9.7-preview] - 2020-05-06

  • 自动导入迭代修复

[0.9.6-preview] - 2020-05-06

  • 修复了内容示例自动导入

[0.9.5-preview] - 2020-05-06

已添加

  • Create Tool 窗口：“Max Count”选项。一个非 1 值将设置所创建代理的复制器父级。如果禁用了“Max Count”，则复制器计数将是无穷的（无限）。
  • 比较工具现在支持高于地板高度条件 (Height Above Floor Condition)
  • Set Pose Action：“Align with World Up”选项。允许代理使它们的 Y 轴或 Z 轴与世界向上方向对齐。
  • 现在，实时（面部）模拟环境模式允许用户选择要使用的摄像机。
  • 光源估算 (Light Estimation) 可视化工具可以驱动 ARCore/ARKit 光照估算中的光源，并驱动一个简单的对应模拟对象。

已更改

  • 现在，合成图像标记资源会保存到 Assets/SyntheticImageMarkers 中，而不是与激活场景关联的文件夹中。
  • 重新组织了设置资源以减少 Assets 文件夹中的混乱情况
  • Proxy Inspector：“Add MARS Component”菜单现在仅显示所筛选的组件类型，例如，如果选择了“Conditions”作为筛选条件，则按钮将仅显示要添加的条件。

[0.9.4-preview] - 2020-04-23

已修复

  • 已恢复拖放功能
  • Unity 2019.3.10 中的空白“Create”窗口
  • 使用个人 Editor 主题时的“Create”窗口颜色
  • 为从头开始创建的面部代理恢复了面部界标放置目标（通过拖放将内容附加到特定面部区域）功能

[0.9.3-preview] - 2020-04-22

已修复

  • 首次导入时显示未使用的默认环境

[0.9.2-preview] - 2020-04-22

API 更改

  • 向 MarsRuntimeUtils 添加了 GetMarsSessionInScene() 和 GetMarsSessionInActiveScene()

[0.9.1-preview] - 2020-04-16

  • 内部草案

[0.9.0-preview] - 2020-04-16

已添加

  • 模拟环境修改：用户现在可以保存 Simulation View 中对模拟环境执行的编辑。进行更改后，用户将收到提示，要求他们在切换环境或重新编译时保存或放弃更改。
    • 模拟图像标记工作流程：现在，模拟图像标记提供了一个 Inspector，类似于使用标记条件 (Marker Condition) 选择要模拟的库图像。MARS Panel > Create Panel 中添加了一个按钮，用于将新的模拟标记添加到当前环境。
  • 沉浸式语义：如果用户使用平面设备（手机、笔记本电脑等）或空间设备（VR、AR 等），可使用“displayFlat”或“displaySpatial”。
  • 用户类型支持：用户可以选择他们自己的数据特征类型 (class MyCondition : Condition)，然后，后端代码将自动重新生成自身。

API 更改

  • 已将 MARSRuntimeUtils 更名为 MarsRuntimeUtils
    • 已将 MarsRuntimeUtils.GetMainOrSimulatedCamera() 替换为 GetActiveCamera() 和 GetSessionAssociatedCamera()。请参阅查找摄像机文档。
  • 添加了文档以及 Unity.Labs.MARS.Recording 命名空间中的公开数据结构
  • SimulationSettings 属性（EnvironmentMode、EnvironmentPrefab 等）现在是非静态的，需要实例访问权限。

已更改

  • 设置模拟中的视频背景完全在 SimulationVideoContextManager 中进行，从而消除了在模拟中显示视频时对面部跟踪提供程序的依赖
  • 模拟视频成帧通过 MARSCamera 设置摄像机视野进行，且成帧发生在 Device View 中而非 Simulation View 中
  • 将 SimulatedCameraProvider 拆分为 SimulationCameraPoseProvider（仅提供摄像机姿态）和 SimulatedCameraViewProvider（提供摄像机纹理、内在函数和投影矩阵）
  • 更新了颜色偏好设置（菜单：Edit > Project Settings > MARS > User Preferences）：添加了“Condition Fail Text Color”，由比较工具用来在 Inspector 中显示不匹配的数据。删除了不再使用的颜色偏好设置。
  • SimulationSceneModule 已更改为当使用回退复合渲染时对 ContentScene 和 EnvironmentScene 使用相同的场景。
  • 向模拟场景添加了新的根游戏对象：ContentScene 的 ContentRoot 和 EnvironmentScene 的 EnvironmentRoot
    • 从 AddContentGameObject() 或 AddEnvironmentGameObject() 添加到模拟场景的对象将添加到场景的根游戏对象，除非 keepAtRoot 为 true。

已修复

  • WorldScale 现在会影响模拟环境中的所有光源和音频源。
  • 从 Unity 主菜单 GameObject > MARS > Turn Into > ... 访问的“Turn Into”选项现在将按预期正常工作。
  • 在 DX11 图形模式下的运行模式下可能会颠倒显示内容的图形问题。
  • 录制的视频现在可以在没有面部跟踪库的情况下在模拟视图中正确播放。

已移除

  • UnityCloudStorageModule：基于 Google Cloud Storage 的云存储提供商

[0.8.4-preview] - 2020-03-18

已修复

  • macOS 上的 Device View 输入错误

[0.8.3-preview] - 2020-03-18

已添加

  • 添加了在新项目中默认对模拟图像标记的支持
  • 获取和设置用于 Unity MARS 场景评估间隔的 API（请参阅 IUsesMarsSceneEvaluation 接口）
  • 在 [ProviderPriority] 属性上添加了 ExcludedProviders 字段，用于简化平台特定提供程序的用户设置。请参阅选择提供程序文档。

已修复

  • 修复了面罩比例：默认情况下，面部内容的比例现在为 1:1
  • 改进了对于在运行时启用/禁用代理的处理
  • 修复了从脚本实例化 SyntheticObject 时出现的错误
  • 修复了由合成渲染引入的视觉瑕疵
  • 修复了 Forces Editor UI 中的错误
  • 从代理组和复制器中删除了错误的组件选项卡

已更新

  • 更新了所有文档以提高明晰度和一致性
  • Post Processing 包不再需要，但仍受支持
  • 从测试场景中移除了流浪的马

[0.8.2-preview] - 2020-03-03

已添加

MARS 代理系统

  • 力：允许配置类似弹簧和类似磁铁的力以便进行布局调整、多重占用等。
  • 优先级：在代理上添加了一个选项，用于定义与数据 ID 匹配的优先级
  • HeightAboveFloorCondition：一种简便方法用于确保物体不离开地板，还可以选择设置离开地板的距离（使用 SemanticTagCondition 和“地板”可确保物体在地板上）。
  • 改进的筛选功能：在 Proxy Inspector UI 中更好地筛选组件类型。

模拟系统

  • 运行模式下的录制内容：现在可以在运行模式下使用模拟录制内容（在 Simulation Controls 中选择一个录制内容，然后按下正常的 Play 按钮）
  • 时间拖动：可以使用时间轴 (Simulation / Menu / Open Timeline) 拖动录制内容。
  • 模拟复合渲染：
    • 改进了多摄像机渲染，可以显示合成场景内容并遮挡模拟环境。
    • 解决了激活内容场景时在 Simulation View 和 Device View 中进行 Alpha 混合的问题。
    • 改进了对复合视图中渲染和图像效果设置的处理。

[0.8.1-preview] - 2020-02-05

  • 添加了家庭办公室 (Home Office) 和开放办公室 (Open Office) 模拟环境
  • 模拟环境现在支持可播放项
  • 现有模拟环境已更新，拥有更多对象
  • 错误修复：在选择了“All”筛选条件的情况下添加 MARS 组件不会更改筛选条件
  • 添加 Provider Priority 功能

[0.8.0-preview] - 2020-02-12

  • 添加 SpatialDataModule 和对 com.unity.labs.spatial-hash 的依赖：可用于对复杂的场景进行有效的空间查询

[0.7.2-preview] - 2020-02-18

已添加

  • 选项卡式 Proxy Inspector，可筛选显示的 MARS 组件
  • 新增模拟环境
    • 卧室
    • 餐厅
  • 在需要特定设置的平台（包括 Magic Leap）上自动进行配置检测

已更改

  • 新近更新且更易于理解的文档。
  • 创建和比较工作流程

已修复

  • 修复了处理自动重新同步的块模拟
  • 地理定位修复

[0.6.11-preview] - 2020-02-04

已添加

  • 向 MarsTime 添加了时间标度
  • 卧室和餐厅模拟环境
  • 选择性扩展 (Elective Extensions) 功能，有助于 Magic Leap 构建 ### 已更改
  • 更新包依赖关系
  • 改进创建和比较工具

[0.6.10-preview] - 2020-01-30

已修复

  • 修复了代码生成模板中的问题（这些问题会导致导入时发生编译错误）

[0.6.9-preview] - 2020-01-30

已移除

  • 在批处理模式下禁用代码生成以修复依赖 Unity MARS 的包中的 CI 问题

[0.6.8-preview] - 2020-01-29

已添加

  • MARS Content 文件夹

已修复

  • 修复了地板状况问题
  • 修复了多重关系状况问题
  • 修复了地理定位无法重新评估的问题
  • 修复了法线和 UV 加倍的问题
  • 清理并修复了小问题

[0.6.7-preview] - 2020-01-23

已添加

  • 图像标记支持
  • 遮挡物遮罩，适用于具有 4 面墙壁和天花板的模拟环境
  • 新增模拟环境

[0.1.1-preview.1] - 2020-01-10

已更改

  • 更新术语

[0.1.1-preview] - 2020-01-03

已更改

  • 清理并更新了包发布文档
  • Editor UI 更新

[0.1.0-preview] - 2019-11-27

已添加

  • 初始版本