docs: 对接文档 V1.5 — 新增 DataService 基础数据 CRUD 章节

This commit is contained in:
tian 2026-06-17 15:50:48 +08:00
parent e782062377
commit 6f28704368

View File

@ -1,6 +1,6 @@
# 后端对接文档Unity 前端)
> **版本**V1.4
> **版本**V1.5
> **日期**2026-06-17
> **Unity 版本**2022.3.62f3c1
@ -133,6 +133,7 @@ runner.Engine.SetFireSchedule(fireEvents); // 从推荐方案取
runner.LoadAndStart(taskId);
runner.Engine.TimeScale = 4f;
runner.Engine.State / Drones / Clouds / Munitions / Platforms / DetectionEntities / Events
runner.DataService // 基础数据 CRUD见第五节
runner.Stop();
```
@ -183,7 +184,64 @@ replay.LoadReplay(taskId);
---
## 五、默认数据
## 五、基础数据 CRUDDataService
`SimulationRunner.DataService` 提供 7 类基础数据的增删改查:
```csharp
var ds = runner.DataService;
// 弹药
var ammo = ds.GetAllAmmo();
ds.SaveAmmo(new AmmunitionSpec { Id = "custom", ... });
ds.DeleteAmmo("custom");
// 火力单元规格
ds.GetAllFireUnits();
ds.SaveFireUnit(spec);
ds.DeleteFireUnit(id);
// 无人机规格
ds.GetAllDrones();
ds.SaveDrone(spec);
ds.DeleteDrone(id);
// 传感器规格
ds.GetAllSensors();
ds.SaveSensor(spec);
ds.DeleteSensor(id);
// 环境规格
ds.GetAllEnvironments();
ds.SaveEnvironment(spec);
ds.DeleteEnvironment(id);
// 编队模板
ds.GetAllFormations();
ds.SaveFormation(spec);
ds.DeleteFormation(id);
// 航线模板
ds.GetAllRoutes();
ds.SaveRoute(spec);
ds.DeleteRoute(id);
```
### 规格类命名对照
| 旧名 | 新名 | SQLite 表 |
|------|------|------|
| `TargetPreset` | `DroneSpec` | `DroneSpec` |
| `DetectionPreset` | `SensorSpec` | `SensorSpec` |
| `WeatherPreset` | `EnvironmentSpec` | `EnvironmentSpec` |
| `FireUnitTemplate` | `FireUnitSpec` | `FireUnitSpec` |
| `RoutePreset` | `RouteTemplate` | `RouteTemplate` |
| `FormationTemplate` | 不变 | `FormationTemplate` |
| `AmmunitionSpec` | 不变 | `AmmunitionSpec` |
---
## 六、默认数据
首次运行 `DatabaseManager.OpenMainDb()` 自动从 `data/defaults.json` 种子数据库:
@ -209,7 +267,7 @@ var unit = defaults.FireUnits.First(f => f.Id == "ground-light").ToEquipmentDepl
---
## 、更新后端
## 、更新后端
```bash
cd src/CounterDrone.Core
@ -219,7 +277,7 @@ dotnet publish -c Release -o ../../unity_plugins
---
## 、参考
## 、参考
| 文档 | 位置 |
|------|------|
@ -227,4 +285,4 @@ dotnet publish -c Release -o ../../unity_plugins
| 实体事件映射 | `docs/design/technical/仿真器实体与事件映射.md` |
| 任务跟踪 | `docs/implementation/tasks/实施计划与任务跟踪.md` |
| 测试报告 | `test/reports/`(每次集成测试自动生成) |
| 测试状态 | **243 测试,9 秒(全部通过)** |
| 测试状态 | **243 测试,11 秒(全部通过)** |