Cesium for Unreal快速入门

一、安装Cesium for Unreal插件

1.打开虚幻商场搜索Cesium for Unreal，购买安装即可

二、创建Cesium for Unreal项目

1.创建新项目

2.项目完全加载后，激活 Cesium for Unreal 插件，启用插件后需要重新启动虚幻引擎

3.首次激活 Cesium for Unreal 插件并重新启动编辑器后，可能会看到与Water Body Collision profile相关的错误。单击“将条目添加到 DefaultEngine.ini”链接来修复它

三、准备项目及设置

1.创建一个新关卡（文件 -> 新建关卡），出现提示时，选择“空白关卡”以确保关卡中没有对象

2.禁用场景边界检查。此选项位于世界场景设置（窗口 -> 世界场景设置）中

当“启用世界边界检查”打开时，虚幻引擎将尝试将远离原点的 Pawn 飞回原点。在大多数Cesium应用程序中，远离原点是完全正常的，并且这种自动行为会阻止Pawn到达用户想要它去的地方。

3.CesiumSunSky 使用真实的光强度值，比标准的 Unreal 项目明亮得多。因此，在某些项目设置下，光线会冲淡场景并使它们呈现白色。要解决此问题，请在自动曝光设置选项中启用自动曝光和扩展默认亮度范围。可以通过转到“编辑”->“项目设置”，然后导航到“引擎”->“渲染”并向下滚动到“默认设置”部分来找到这些选项

3.添加环境光照，Cesium for Unreal 附带了一个预制的、全球感知的太阳和大气系统，称为Cesium SunSky

四、连接Cesium

1.点击连接

2.将打开一个弹出浏览器窗口。如果您尚未登录，请登录您的 Cesium ion 帐户。您还可以使用 Epic Games、GitHub 或 Google 帐户登录。
3.登录后，您将看到一条提示，要求您允许Cesium for Unreal 访问您的资源。选择“允许”，然后返回虚幻引擎继续。

4.现在，您将为您的项目创建默认访问令牌。您从 Cesium ion 流式传输的每项资产都需要访问令牌。您将设置一个项目范围的访问令牌，您的所有资产都将使用该令牌。单击Cesium面板顶部的Token按钮，选择默认Token即可，随后点确定

五、创建一个地球仪

 1.单击旁边的按钮添加“Cesium World Terrain + Bing Maps Aerial imagery”。

2.查看右侧的大纲视图。除了您之前添加的CesiumSunSky之外，您还会看到各种 Cesium actor。其中之一，Cesium World Terrain是您刚刚创建的图块集。其他三个-CesiumCameraManager、CesiumCreditSystemBP和CesiumGeoreference是在您第一次将 3D Tileset 或地理参考 actor 添加到关卡时自动创建的。

六、将全球 3D 建筑添加到您的关卡中

1.在大纲中选择CesiumGeoreference actor 。这个actor决定了你在世界的哪个位置。该actor可以更改关卡当前的纬度、经度和高度

2.在“详细信息”面板中，查找Cesium 类别下的Origin Latitude、Origin Longitude和Origin Height变量

3.尝试将这些变量更改为您最喜欢的城市的坐标，或者使用这些坐标前往美国伊利诺伊州芝加哥。
原点纬度 = 41.878101          原点经度 = -87.59201          原点高度 = 1000.0
输入这些坐标后，您会发现水平仪已移动到这个新位置

4.这座城市看起来很平坦。因为Cesium World Terrain 不包括建筑细节。
但Cesium OSM Buildings可以拯救。从Cesium面板中，将Cesium OSM Buildings添加到关卡中。

七、创建Cesium的玩家Pawn

1.如果您运行项目，会注意到默认的相机速度非常慢，且不可调节。考虑到现实世界数据的规模，您将需要不同的Pawn才能在游戏过程中有效地导航关卡。
使用Cesium面板，添加一个Dynamic Pawn。


问：什么是Dynamic Pawn？
答：Cesium 的DynamicPawn actor 通过使其具有全球感知能力来扩展内置的 pawn 类。DynamicPawn还添加了重要的移动功能，例如使用鼠标滚轮调整移动速度的能力以及沿着弯曲路径在全球位置之间飞行的能力。

2.DynamicPawn是一个地理参考角色。它保持相对于地球坐标的位置，而不是相对于标准虚幻引擎世界坐标。这意味着如果您将地理参考原点更改为其他位置，DynamicPawn将保留在后面。如果您想将其移动到新位置，请在大纲视图中选择它，并将其位置 X、Y和Z坐标设置为 0，或使用灰色箭头将其位置重置为原点

结束
备注：官方文档总结学习从而整理成文档