AR

## Unreal Engine

### OpenVR 支持

> 参考：[Setting Up a Standing Camera with SteamVR](https://docs.unrealengine.com/4.27/en-US/SharingAndReleasing/XRDevelopment/VR/VRPlatforms/SteamVR/HowTo/StandingCamera/)

云应用需要集成 OpenVR 支持。在 Unreal 中可按以下步骤操作：

1. 确保已启用 **SteamVR** 插件。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/e62f9ca4a1a749b897f86f74c1357f34.png)

2. 确保启动时启用 **VR 模式**。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/c187fe3059524f598007c80e17715e81.png)

3. 设置站立相机（Standing Camera）：
   - 创建 **VRPawn** 蓝图，并添加 **Scene Component** 与 **Camera**。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/7a29127749654640b1d2ad38aacbd20f.png)

- 在该蓝图中，添加游戏开始运行时设置 **Tracking Origin** 的事件。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/4fa379807929430984cb7158b3e5b669.png)

- 将该 Pawn 加入场景，并设置为自动Possess玩家。
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/28082fe053694fe2a2aeef6f18113f4c.png)

### 设置背景透明

在云渲染 AR 模式下，需要将画面与摄像头图像叠加。要在 Unreal 中设置透明背景：

1. 禁用天空盒、雾效等背景元素，并勾选 **Hidden in Game**。
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/e7d712ccc18c408088a3fbc35eddd848.png)

2. 在设置中搜索 `alpha`，启用允许通过 **Post Process Volume** 进行 Color Grading 的选项。  
   启用后需重启工程并重新编译 Shader。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/268057b013d24184a7de43c3c4b31b0e.png)

### 发布

上传到 LarkXR 4.0 平台时，请确保已启用允许 Color Grading 的选项，并与平台中的 **Alpha Mask（透明遮罩）** 功能对应。  
若未勾选透明遮罩，客户端会叠加反向的透明通道。
![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/ae60cd91622d43549ed124a5cae1000c.png)

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/4b669c74f8a24f889592631be9209171.png)

### 客户端访问效果

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/7bee5aef159c4080b17f1eb96e7d1865.png)

---

## Unity

### OpenVR 支持

云应用需要集成 OpenVR 支持。在 Unity 新版 XR System 中启用 OpenVR 的方式有所不同，具体请参考 Unity 官方文档。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/ee26f3541b044e79be72887aa1c37fa4.png)

### 设置背景透明

设置场景中的主 Camera：移除 Skybox，并将背景设置为 `rgba(0,0,0,0)`。这样在与客户端合成时即可获得透明背景。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/e617793a480c4a979a365cb8c95e9b45.png)

### Demo

[SampleScene.unity](https://github.com/pingxingyun/larkar_demos/tree/main/cloudapp_unity/ar_dragon/Assets/Scenes/SampleScene.unity) 演示了在 AR 场景中添加动画模型。

动画模型由脚本 [Controller.cs](https://github.com/pingxingyun/larkar_demos/tree/main/cloudapp_unity/ar_dragon/Assets/Scenes/Controller.cs) 控制。

### 发布

将打包后的应用上传到 LarkXR 4.0 平台的应用管理中，并确保类型选择为 **并行云 AR 方案**。

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/4a92f23822b24e9bb77dc1f0001d06af.png)

### 客户端访问效果

![](https://immershare-images.oss-cn-beijing.aliyuncs.com/images/2026/08/19/b2f2bc3811144c21993f9d918c25a7b9.png)