linkong/planet

Fork 0

Files

rayd1o e7033775d8 first commit

2026-03-05 11:46:58 +08:00

3.4 KiB

Raw Blame History

UE5 项目快速启动指南

已配置内容

✅ Cesium ion Token - 已配置

Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

项目结构

unreal/
├── Config/
│   └── PlanetConfig.ini          # Cesium ion 配置
├── Content/
│   ├── Blueprints/               # 蓝图文件 (在 UE5 中创建)
│   ├── Materials/                 # 材质文件
│   ├── Widgets/                  # UI 控件
│   └── Levels/                   # 关卡文件
└── Source/
    └── PlanetAPI/                # C++ 源码 (在 UE5 中编译)

启动步骤

1. 创建 UE5 项目

# 方式一: 从 Epic Games Launcher
# 1. 打开 Epic Games Launcher
# 2. 选择 Unreal Engine 5.3+
# 3. 点击 "Games" → "Blank" → "Blueprint"
# 4. 创建名为 "Planet" 的项目
# 5. 将项目保存到 /home/ray/dev/linkong/planet/unreal/

2. 安装 Cesium 插件

在 UE5 编辑器中:

打开 Edit → Plugins
搜索 Cesium for Unreal
点击 Enable
重启编辑器

3. 配置 Cesium ion Token

方式 A: 通过 UE5 编辑器

打开 Edit → Project Settings
搜索 Cesium

在 Cesium ion 部分输入 Token:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI4YWFhYTQ5Zi02YTBlLTRhNmYtOTYyZC02NjgyYzQwMWY1YmMiLCJpZCI6Mzg5NDMzLCJpYXQiOjE3NzA3ODE1ODN9.yF-06K39B_8SkwMCQVuztAwdXDlRlumT33TVOYhQGqs

方式 B: 通过配置文件

配置文件已保存到: Config/PlanetConfig.ini

4. 创建主场景

在 UE5 中创建新关卡: File → New Level → Default
从 Cesium 面板拖入 Cesium World Terrain
添加 Cesium Sun Sky
保存为 Content/Levels/Main.umap

5. 创建数据可视化蓝图

创建以下蓝图类 (在 UE5 中):

蓝图类	用途
BP_GlobeController	地球控制器，管理 Cesium
BP_Supercomputer	TOP500 超算标记
BP_GPUCluster	GPU 集群标记
BP_SubmarineCable	海缆连接线
BP_DataFlow	数据流向粒子

6. 连接后端 API

在蓝图中使用 HTTP 请求获取数据:

// HTTP 请求示例 (在 UE5 蓝图中使用 HTTP Client 节点)
GET http://localhost:8000/api/v1/collected?source=top500

WebSocket 实时更新:

ws://localhost:8000/ws

数据格式

TOP500 超算数据

{
  "id": "top500_1",
  "name": "Frontier",
  "location": {
    "latitude": 33.7756,
    "longitude": -84.3962,
    "altitude": 0
  },
  "performance": 1682.65,
  "cores": 8730112,
  "country": "US"
}

海缆数据

{
  "id": "cable_1",
  "name": "SEA-ME-WE 4",
  "path": [
    {"latitude": 1.3521, "longitude": 103.8198},
    {"latitude": 3.1390, "longitude": 101.6869}
  ],
  "bandwidth": 1000
}

快速测试

启动后端服务:

cd /home/ray/dev/linkong/planet
docker restart planet_backend_new

打开 UE5 项目
在蓝图中添加 HTTP 请求获取数据
在场景中放置数据标记
运行并测试

注意事项

⚠️ Token 安全:

你的 Cesium ion token 已保存在配置文件中
建议不要将 token 上传到公开的代码仓库
可以通过环境变量管理敏感信息

⚠️ UE5 系统要求:

Windows 10/11 64-bit
16GB RAM (建议 32GB+)
支持 DirectX 12 的显卡
100GB SSD 存储

下一步

详细开发文档: docs/ue5_development_plan.md

3.4 KiB Raw Blame History