通过

在 Unreal 中升级项目

  • 项目

更新到新版本的 Unreal 后，在编译蓝图或打包项目时，已弃用的函数会显示为“警告”。 如果已添加新函数，且应改为使用此函数，那么这些函数会被弃用。

5.0 更改

在 5.0 中，Unreal Engine 附带的 Windows Mixed Reality (WMR) 插件被弃用，取而代之的是 OpenXR 插件（可在 Unreal Marketplace 或 GitHub 上获得）。 WMR 插件将在将来的引擎版本中删除，因此开发人员应迁移到 OpenXR。

OpenXR 与 Microsoft OpenXR

引擎附带的 OpenXR 插件可用于创建应用程序，但任何特定于 MSFT 的 OpenXR 功能（包括 Holographic App Remoting）将仅存在于 Microsoft OpenXR 插件中，因此需要下载它才能创建功能齐全的体验。

更新

Microsoft OpenXR 插件是带外发布到 Unreal 引擎的，因此应该监视插件的新功能。 更新将在开发时提供。 这是 WMR 插件的一个转变，其中每个引擎版本都包含了所有的新功能。

HoloLensAR

HoloLens AR 插件已删除，不应再作为插件依赖项包含在 Unreal Engine 5.0 中。

5.0 警告

由于 UE5 的大世界坐标将精度从 float 提升到了 double，更新后的 Unreal Engine 5.0 项目可能会出现 FVector 和 Shader 的新编译器错误。

4.26 更改

重大更改在于，必须从“编辑”>“项目设置”>“项目”>“说明”>“设置”选择“在 VR 中启动”，才能启动 Windows Mixed Reality 插件。 如果没有该参数，则你不会在设备上看到全息影像。

4.26 警告

在 4.26 版本中，所有 AR 和 VR 平台都已经过重构，添加了常见接口，且仍然与应用程序代码平台无关，因此可能会出现比平常更多的警告。 建议更新到新的 API，使项目能够更轻松地移植到其他平台。

警报消息将显示哪个函数已被弃用，并指出该改用哪个函数。 所有已弃用的函数都将继续适用于此版本，但可能在未来版本中失效。 在蓝图中搜索函数时，也将不再列出已弃用的函数。

Blueprint of the Create Named ARPin function

4.25 版弃用项

弃用的函数 新建函数
CreateNamedARPin Blueprint of the Pin Component function
LoadWMRAnchorStoreARPins Blueprint of the Load ARPins from Local Store function
LoadWMRAnchorSaveARPinToWMRAnchorStoreStoreARPins Blueprint of the Save ARPin to Local Store function
RemoveARPinFromWMRAnchorStore Blueprint of the Remove ARPin from Local Store function
SetEnabledMixedRealityCamera Blueprint of the Set Enabled XRCamera function
ResizeMixedRealityCamera Blueprint of the Resize XRCamera function
StartCameraCapture Blueprint of the Toggle ARCapture function for starting camera capture
StopCameraCapture Blueprint of the Toggle ARCapture function for stopping camera capture
StartQRCodeCapture Blueprint of the Toggle ARCapture function for starting QR code capture
StopQRCodeCapture Blueprint of the Toggle ARCapture function for stopping QR code capture
空间映射之前自动在 4.25 版中启动，但现在 4.26 版中需要进行切换。 Blueprint of the Toggle ARCapture function for enabling spatial mapping
ShowKeyboard 已在 4.26 版中删除，这是因为当焦点在文本小组件上时，会自动显示键盘。
HideKeyboard 已在 4.26 版中删除，这是因为当焦点不在文本小组件上时，将自动隐藏键盘。
SupportsHandTracking Blueprint of the Supports Hand Tracking property
IsDisplayOpaque Blueprint of the IsDisplayOpaque property
GetHandJointTransform、GetPointerPoseInfo、GetControllerTrackingStatus Blueprint of the Get Motion Controller Data function
GetVersionString Blueprint of the Get Version String function
IsTrackingAvailable Blueprint of the IsTrackingAvailable property
IsButtonClicked、IsButtonDown、IsGrasped、IsSelectPressed 使用 Unreal 的输入操作系统。
SetFocusPointForFrame 已在 4.26 版中删除。 之前用于在远程处理时重新投影，而现在支持深度重新投影。