docs: 对接文档 V1.5 — 新增 DataService 基础数据 CRUD 章节
This commit is contained in:
parent
e782062377
commit
6f28704368
@ -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);
|
||||
|
||||
---
|
||||
|
||||
## 五、默认数据
|
||||
## 五、基础数据 CRUD(DataService)
|
||||
|
||||
`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 秒(全部通过)** |
|
||||
|
||||
Loading…
Reference in New Issue
Block a user