diff --git a/docs/对接文档_Unity前端.md b/docs/对接文档_Unity前端.md index f27b38a..b76fbb6 100644 --- a/docs/对接文档_Unity前端.md +++ b/docs/对接文档_Unity前端.md @@ -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 秒(全部通过)** |