CesiumforUnreal环境准备

       本文将重点介绍CesiumforUnreal的C++工程编译，当然前提是准备好Unreal的环境，可以通过Epic Games Launcher去安装或甚至直接从unreal官方下载源码进行安装，但本文并不关心这些，笔者是通过Epic Games Launcher安装了Unreal Engine 5.4.4。在此基础上通过下载CesiumforUnreal和cesium-unreal-samples源码进行编译。CesiumforUnreal是Unreal与三方库CesiumNative进行结合的集中体现，笔者想通过研究CesiumforUnreal源码以及官方示例，进一步了解Unreal引入外部开源库的方法，将Unreal与Osg结合，实现大体量倾斜模型、数字地球在Unreal中实时渲染显示。且后续文章不将集中在Unreal材质编辑、蓝图使用、场景设计上面，而是仅仅通过几个简单的C++工程例子来打通Unreal与Osg的结合的关键点，如Unreal显示外部单个osgb文件、Unreal中实时显示推流画面等。

目录

• 1 准备
• 2 编译

正文

1 准备

        通过git clone命令下载cesium-unreal-samples到本地，命令如下，其中命令最后的cesium-unreal-samples2表示本地文件夹路径。

git clone --recursive https://github.com/CesiumGS/cesium-unreal-samples.git cesium-unreal-samples2

        接着按如下cesium-unreal的release路径下载最新的CesiumForUnreal包，如CesiumForUnreal-54-v2.21.1.zip表示针对Unreal 5.4的v2.21.1版本的CesiumForUnreal包。注意此时需将git clone下载好的cesium-unreal-samples切换到同样的版本v2.21.1，如下所示：

        将下载好的CesiumForUnreal包解压到cesium-unreal-samples文件夹中的Plugins文件夹下，当让当Plugins文件夹不存在时则创建，最后文件间的关系如下图所示：

        然后将如下地址中的文件拷贝到cesium-unreal-samples的source文件夹下，同样的，当source文件夹不存在时则创建。

https://github.com/CesiumGS/cesium-unreal/tree/main/Documentation/Source

        此时准备工作已经完毕，接下来进行编译。

2 编译

        首先右键点击CesiumForUnrealSamples.uproject文件，执行Generate Visual Studio project files，生成CesiumForUnrealSamples.sln文件。接着点击CesiumForUnrealSamples.sln文件，解决方案配置设置为Development_Editor，平台设置为x64,设置CesiumForUnrealSamples项目为激活项并执行编译。执行完毕后点击运行VS，可看到如下画面：

        表明环境已配置成功，默认出现的关卡为01_CesiumWorld，用户可导入不同的关卡以供学习， 关卡文件在Content\CesiumSamples\Maps目录下，当前官方供提供了17个样例，样例的介绍可参照如下地址。

https://github.com/CesiumGS/cesium-unreal/blob/main/README.md

总结

     本章通过Unreal C++编译的形式准备了CesiumforUnreal环境，下章将通过借鉴CesiumforUnreal加载3dtiles过程中到Unreal几何体的转换，尝试将单个osgb文件同样转换为Unreal几何体，并在Unreal场景中渲染。