（一）Cesium for Unreal快速入门（译）

原文地址：Cesium for Unreal快速入门（译）

原文请参考Cesium官方文档：Cesium for Unreal Quickstart

Cesium for Unreal官方宣传视频

译者注：如果您做过Web前端可视化、WebGL、GIS相关的开发工作，您肯定听说过Cesium。

Cesium是一个开源的三维GIS平台，用卫星地图、地形、建筑白膜、倾斜摄影、点云等数据还原真实的三维地球。

2020-05-28日，虚幻官方论坛发过From Ants to Outer Space的文章，作者用非常tricky的方式模拟了从地面上的一个小蚂蚁飞到外太空看地球的场景。

早期Cesium提供了Javascript语言的CesiumJS框架，如今Cesium for Unreal于2021-03-30正式发布，让虚幻引擎具有了Google Earth的能力，为模拟真实世界打开了一扇新的大门。

这是一份关于用Cesium World Terrain和Cesium OSM Buildings创建Cesium for Unreal应用的快速入门教程。（译者注：需要您具有基本的虚幻引擎使用技能，懂一点C++更好。关于虚幻引擎的基本技能，请参考官方在线学习教程）：

• 初识虚幻引擎
• 虚幻引擎入门
• 理解项目和文件结构
• 虚幻引擎编辑器基础——编辑器入门
• 蓝图：基础概念
• 虚幻编辑器基础——材质
• 材质：基础概念
• 了解可视化设计中的材质
• 将蓝图转换为C++
  
  

  用Cesium World Terrain和Cesium OSM Buildings创建的韩国首尔在虚幻引擎中的场景
  
  用Cesium World Terrain和Cesium OSM Buildings创建的韩国首尔在虚幻引擎中的场景

您将学会如何：

• 在虚幻引擎中安装Cesium for Unreal插件
• 添加一个关卡并且从Cesium ion导入资产
• 在Cesium for Unreal应用中添加照片级的光照效果

准备工作

• 安装虚幻引擎（至少需要4.26或以上版本）。关于如何安装虚幻引擎，请访问虚幻引擎下载页面。
• 一个Cesium ion帐号，用于将地形和建筑物资产流式传输到虚幻引擎中。如果您还没有免费的Cesium ion帐号，请注册一个。

Cesium ion是一个用于流式传输和托管3D内容的开放平台，并且包含全球的、精准的GIS数据，可用于创建展示真实三维地球的应用程序。

第一步：安装Cesium for Unreal插件

如果尚未安装，请先安装Cesium for Unreal插件。

1. 在虚幻引擎市场上打开Cesium for Unreal插件页面。
   

   

   image

2. 登录虚幻引擎商城，并单击免费按钮，将插件安装在虚幻引擎中。

第二步：创建项目和关卡

1. 启动虚幻引擎，并创建一个新项目。在选择游戏模板界面选择游戏。
   

   

   image
   
   点击下一步，在选择模板界面选择空白。其他模板类型也可以。
   
   

   image
   
   在项目设置中选择不带初学者内容包，以避免不必要的内容使关卡混乱。选择新项目路径，修改项目名称后，点击创建项目。
   
   

   image

2. 激活Cesium for Unreal插件。打开菜单编辑->插件，然后在插件窗口右上角的搜索栏中搜索cesium。确保Cesium for Unreal插件的已启用复选框已勾选。启用插件后，重新启动虚幻引擎。
   

   

   image

3. 打开菜单文件->新建关卡，选择关卡。
   

   

   image

4. 打开菜单文件->保存当前关卡，选择存储路径，将新关卡命名为QuickStart。（译者注：关于命名规则，请参考UE4 Style Guide）
   

   

   image

5. 打开菜单编辑->项目设置，再选择项目->地图和模式。将编辑器开始地图和游戏默认地图设置为刚创建的关卡QuickStart。这样可以确保在重新启动虚幻编辑器时自动重新打开您的关卡。
   

   

   image

第三步：添加SunSky照明和FloatingPawn

CesiumSunSky蓝图给室外场景增加了炫酷的天阳光照明，它扩展了内置的SunSky蓝图，让它跟真实地球上的太阳光一模一样。同样，Cesium的FloatingPawn扩展了内置的FloatingPawn，使其能在地球上任意移动，并允许使用鼠标滚轮控制移动速度，特别是距离地面很远时非常有用（用键盘WSAD前后左右移动，鼠标控制方向，滚轮控制移动速度）。

当视角在Cesium地球上方的不同位置之间飞行时，照相机应遵循与地球表面平行的弯曲路径，而不是线性的点对点飞行轨迹。Cesium的FloatingPawn就是做这个用的，它确保你从地球的一边飞到地球的另外一边时，向上的方向始终从地球的球心指向天空（直观的理解就是：因为地球是园的，不是平的，所以虚幻引擎默认的相机移动方式就不行了）。

1. 打开菜单编辑->项目设置，然后搜索luminance（或者参考下图）。确保启用了扩展自动曝光设置中的默认亮度范围选项。如果未启用此选项，则在阳光直射的情况下，用SunSky照明会完全曝光，界面白茫茫一片。启用此选项后，需要重新启动虚幻引擎。
   

   

   image

2. 单击内容浏览器右下角的视图选项，并确保同时勾选了显示引擎内容和显示插件内容。
   

   

   image

3. 在内容浏览器中，单击选择路径按钮，搜索Cesium，或者向下滚动以查找并单击CesiumForUnreal内容。
   

   

   image

4. 将CesiumSunSky和FloatingPawn蓝图拖动到关卡视口中。

   
   
   

   image

第四步：在关卡开始时自动拥有FloatingPawn

在上面的步骤中，您将FloatingPawn添加到了关卡中，但是玩家还不能控制它，还需要执行下列步骤才能使用它在世界各地移动。

1. 在世界大纲视图中选择FloatingPawn。
2. 设置游戏开始时，玩家0自动控制FloatingPawn：在细节面板中，搜索possess，点击自动控制玩家旁边的下拉菜单，然后选择玩家0。
   
   

   image

第五步：连接到Cesium ion

1. 通过单击工具栏中的Cesium图标来打开Cesium面板。

   
   
   

   image
   
   

   该Cesium面板将显示在编辑器窗口的左侧。

   
   
   

   image

2. 点击Connect按钮，连接到Cesium ion。这时浏览器会自动打开，要求您允许Cesium for Unreal使用Cesium ion中当前登录的帐户访问您的资产：
   

   

   image
   
   选择Allow并返回虚幻引擎以继续下一步。

第六步：创建一个地球

在此步骤中，您将使用Cesium ion的资产填充场景。

1. 通过单击工具栏中的Cesium按钮来打开Cesium面板。在Quick Add中，单击Cesium World Terrain + Bing Maps Aerial imagery右侧的加号（可以随意添加其他Cesium World Terrain + imagery组合之一）。
   

   

   image
   
   此步骤将在世界大纲视图中生成新的Cesium World Terrain和CesiumGeoreference蓝图对象。
   
   

   image

2. 地平线附近可能会有一条黑条。要解决此问题，请选择CesiumGeoreference对象，在细节面板中找到Sun Sky，然后使用刚创建的CesiumSunSky对象对其进行初始化。
   

   

   image

一旦将CesiumSunSky对象连接到CesiumGeoreference对象，便会自动修改其纬度和经度属性，以使地球和太阳保持同步。

3. 如果场景太暗，请调整CesiumSunSky对象上的Solar Time属性，比如设置一个美丽的日落场景。您可能还想更改时区Time Zone。
   
   

   image

有关这些属性如何工作的更多信息，请访问虚幻引擎文档站点上的SunSky对象文档。

第七步：将全球三维白膜建筑（OSM Buildings）添加到场景中

在此步骤中，您将在Cesium World Terrain上面添加Cesium OSM Buildings。与步骤六相似，您将使用编辑器中的Cesium面板添加新资产。

1. 导航回到虚幻引擎中的Cesium面板。您将使用Cesium ion Assets窗口来添加Cesium OSM Buildings ，而不是像上一步那样使用Quick Add窗口。单击左上角的Add按钮以切换到Cesium ion Assets窗口（此窗口默认在左下方，在内容浏览器页签右边）。在这里，您将看到Cesium ion帐户中存在的所有资产。
   

   

   image

2. 选择Cesium OSM Buildings，然后单击Add Add to Level。
   

   

   image
   
   然后您将看到Cesium OSM Buildings现在已添加到世界大纲视图中。

如果Cesium ion Assets中没有Cesium OSM Buildings，请访问Cesium OSM Buildings资产仓库页面，然后单击Add按钮添加到我的资产。然后返回虚幻引擎，关闭Cesium ion Assets面板，然后再次单击Cesium面板上的Add按钮以重新打开并刷新资产列表。

image

3. 如果您看不到建筑物，那么您可能在地球上没有建筑物的地方。要导航到地球的某个地方，请在世界大纲视图中选择CesiumGeoreference对象，在细节面板中，在Cesium类别下找到原点经度Origin Longitude，原点维度Origin Latitude和原点高度Origin Height属性。
   

   

   image
   
   将这些属性调整为您想要的值。例如，以下建筑物位于美国伊利诺伊州芝加哥市，经度-87.629799，纬度41.878101，高度2250.0。
   
   

   image
   
   设置CesiumGeoreference原点后，编辑器相机将立即跳转到那里。但是，尽管原点发生了变化，但FloatingPawn会进行自我调整，以保持其在地球上的先前位置。当你点击运行按钮时，如果您想在芝加哥开始，在世界大纲视图中选中FloatingPawn，设置其位置为（0，0，0）。

4. 点击工具栏运行按钮，然后使用键盘W，A，S和D键以及鼠标在地球上漫游！用鼠标滚轮可以控制飞行速度。当相机离地面近时，往下滚动鼠标滚轮降低飞行速度；当相机离地面远时，向上滚动鼠标滚轮增加飞行速度。在编辑器中，还可以用右上角的控件修改相机移动速度。
   

   

   image

下一步

现在，您可以添加更多资产并自定义场景了！继续添加倾斜摄影资产（敬请期待）。