前言
本文将重点介绍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表示本地文件夹路径。
cpp
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文件夹不存在时则创建。
cpp
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个样例,样例的介绍可参照如下地址。
cpp
https://github.com/CesiumGS/cesium-unreal/blob/main/README.md
总结
本章通过Unreal C++编译的形式准备了CesiumforUnreal环境,下章将通过借鉴CesiumforUnreal加载3dtiles过程中到Unreal几何体的转换,尝试将单个osgb文件同样转换为Unreal几何体,并在Unreal场景中渲染。