CesiumforUnrealQuickstart_译

CesiumforUnrealQuickstart_译

这是一个用CesiumWorldTerrain和CesiumOSMBuildings创建CesiumforUnreal应用程序的快速向导。
你会学到怎样：
1）在UnrealEngine安装CesiumforUnreal插件
2）添加一个关卡并且从Cesiumion中输入资产
3）给你的CesiumforUnreal应用程序添加现实光照
预备：
1）一个安装好的UneralEngine版本（至少4.26或者以上）。怎样安装UnrealEngine的提示，看Unreal Engine download page，详细的提示参考Installing Unreal Engine guide。
2）一个流送地形和建筑资产的Ceisumion账号。如果你没有的话，在Sign up免费注册一个。
！）Cesiumion是一个流送和存管3D内容，并且包括你创建自己真实世界应用使用的全球精确数据的开放平台。

步骤1：安装CesiumforUnreal插件并创建你的第一个项目
如果你还没准备好可以从安装CesiumforUnreal插件开始。
1）在UnrealEngine市场打开Ceisum for Unreal plugin page。
2）需要的话登录点击Free按钮给你的UnrealEngine账号安装CesiumforUnreal插件。

步骤2：创建工程和关卡
1）启动UnrealEngine创建一个新的项目。选择Game作为新项目目录，选择Blank作为模板。其他配置也会运行。

选择NoStarterContent关卡内不必要的内容。

2）激活CesiumforUnreal插件。在Editor -> Plugins和插件界面右上角搜索框搜索“Cesium”。确保勾选插件可用选择框。可用插件之后你需要重启UnrealEngine。
3）如果关卡包含其他内容，使用WorldOutliner去移除它们，我们用一个空关卡开始。

4）在File -> SaveCurrent点击并给出名字保存关卡。
5）在Editor -> ProjectSetting搜索“default”。设置你刚保存的关卡为EditorStartupMap和GameDefaulfMap。这样可以保证UnrealEngine重启时你的关卡会自动重新打开。

步骤3：添加一个SunSky lighting和FloatingPawn
CesiumSunSky会给户外场景添加一个漂亮的光照。它扩展了内置的SunSky使全球可见。同理，Cesium的FloatingPawn扩展了内置的FloatingPawn使全球可用并可用鼠标滚轮控制一定速度，移动大距离时非常有用。
！）当飞行器上的相机在Cesium地球上位置变换时，相机应该有个平行地球的曲线路径，而不是一个线性点到点的变化。一个Cesium的FloatingPawn可以实现这些行为。
1）在Editor -> ProjectSettings搜索“luminance”。确保“Extend default luminance range into Auto Expose settings”可用。这个选项不可用时，全太阳光时，有SunSky的关卡光照将完全褪色。

2）点击Window -> ConentBrowser -> ContentBrowser1打开内容浏览器。在右下角点击ViewOption确保ShowEngineContent和ShowPluginsContent选中。

3）仍在ContentBrowser点击Choose a path按钮然后滚动找到CesiumForUnrealContent并点击。


4）拖CesiumSunSky和FloatingPawn到关卡视口添加到关卡。

步骤4：在关卡开始自动拥有FloatingPawn
1）在WorldOutliner选择FloatingPawn。
2）设置FloatingPawn自动拥有Player0，使得在游戏模式下，鼠标键盘可以控制FloatingPawn。在Detail面板，搜索“possess”。选择AutoPossessPlayer下拉框的Player0。

步骤5：连接Cesiumion
1）在工具栏点击图标打开Cesium面板。

Cesium面板会显示在编辑窗口左边。

2）点击Connect连接Cesiumion。会自动弹出一个浏览界面问你允许CesiumforUnreal连接Cesiumion当前登录账号资产。

选择Allow并返回UnrealEngine继续下一步。

步骤6：创建一个地球
这一步，你将用Cesiumion的资产创建一个场景。
1）在工具栏点击按钮打开Cesium面板，点击“CesiumWorldTerrain+BingMapsAerialimagery”（免费添加其他CesiumWorldTerrain+Imangery组合）

这一步会在WorldOutliner生成CesiumWorldTerrain和CesiumGeoreference。

2）可能会有一个黑色条带。选择CesiumGeoference，在Details面板找到SunSky用新的CesiumSunSky初始化修复它。

！）一旦CesiumSunSky连接到CesiumGeoference，它的经纬度变量会自动修改，保持地球和太阳同步。
3）如果场景时黑的或想设置漂亮的场景，在CesiumSunSky调整太阳时属性。你也需要修改时区。

这些属性怎么工作的更多信息可以看Using a Geospatially Accurate Sun和UnrealEngine的SunSky actor documentation。

步骤7：给你的场景添加全球3D建筑
这一步，你将在CesiumWorldTerrain上添加CesiumOSM建筑。和步骤6相似，你使用编辑的CesiumUI添加新的资产。
1）在UnrealEngine导航到CesiumUI。像之前使用QuickAdd窗口，你现在用CesiumionAssets窗口添加CesiumOSMBuildings。在左上角，点击Add转换到CesiumionAssets窗口。在这儿你可以看到你的Cesiumion账号的所有资产。

2）选择CesiumOSMBuildings并点击AddtoLevel。

再次，现在你可以看到CesiumOSMBuildings添加到了WorlsOutliner。
！）CesiumOSMBuildings是不是消失？看CesiumOSMBuildings资产仓库并点击AddtomyAssets。然后返回UnrealEngine，关闭CesiumionAssets面板在Cesium面板点击Add按钮重新打开更新资产列表。
3）如果你看不见建筑，你可能在世界没有建筑的位置。导航到世界的不同位置，在WorldOutliner的CesiumGeoference点击。在Detail面板，在Cesium目录下找到OriginLongitute、OriginLatitute，OriginHeight变量。

调整这些变量到你在的位置可能值。例如，下面的建筑在美国芝加哥：
Longitude = -87.629799,
Latitude = 41.878101,
and Height = 2250.0。
当你设置地理参考原点的时候，编辑相机会立即跳转到这儿。然而尽管变换原点FloatingPawn自身调整以使包含它预定的位置。如果你想要按下Play时从芝加哥开始，在WorldOutliner点击FloatingPawn并设置它的Location为（0，0，0）。
4）在顶部工具栏按下Play按钮，然后使用W,A,S,D键盘键和鼠标去到处飞行检查地球。上下移动鼠标滚轮，根据你试图覆盖的距离来改变摄像机的速度。你也可以在编辑视口右上角使用控件改变编辑的相机的速度。

下步：
现在你准备去添加更多资产和自定义场景！继续去Adding Datasets。

ps:
原文地址：https://cesium.com/learn/unreal/unreal-quickstart/#step-2-create-the-project-and-level