152 lines
3.9 KiB
Markdown
152 lines
3.9 KiB
Markdown
# QB303设备按battle_unit_code统一标识
|
||
|
||
## 🎯 **功能概述**
|
||
|
||
现在QB303设备数据将根据`battle_unit_code`字段作为设备的唯一标识符，而不是使用`sn`字段。这意味着：
|
||
|
||
- ✅ 相同`battle_unit_code`的设备会被识别为同一个设备并更新数据
|
||
- ✅ 不同`battle_unit_code`的设备会在列表中显示为不同的装备
|
||
- ✅ 设备信息会保留原始的`sn`和`sid`字段供参考
|
||
|
||
## 📋 **数据结构变化**
|
||
|
||
### **设备标识逻辑**
|
||
```javascript
|
||
// 优先使用 battle_unit_code 作为设备ID
|
||
let battleUnitCode = data.host?.battle_unit_code || data.sn || 'QB303_' + Date.now();
|
||
|
||
// 设备信息结构
|
||
{
|
||
equipmentId: battleUnitCode, // 主键：battle_unit_code
|
||
battleUnitCode: battleUnitCode, // 作战单元代码
|
||
sn: data.sn || '', // 原始序列号
|
||
sid: data.host?.sid || '', // 原始设备ID
|
||
equipmentType: 'QB303设备',
|
||
// ... 其他字段
|
||
}
|
||
```
|
||
|
||
### **示例数据**
|
||
```json
|
||
{
|
||
"version": "1.0",
|
||
"timestamp": 1757293532423,
|
||
"data": {
|
||
"host": {
|
||
"battle_unit_code": "dy04", ← 作为设备唯一标识
|
||
"sid": "2",
|
||
"latitude": 28.20648476190476,
|
||
"longitude": 112.8945530952381,
|
||
"altitude": 200,
|
||
"health_status": 1,
|
||
"platform_type": 1
|
||
},
|
||
"sn": "2"
|
||
},
|
||
"biz_code": "qb303_device_status"
|
||
}
|
||
```
|
||
|
||
## 🧪 **测试函数**
|
||
|
||
### **1. 单个设备测试**
|
||
```javascript
|
||
testQB303Data()
|
||
```
|
||
- 发送一个`battle_unit_code: "dy04"`的测试设备
|
||
|
||
### **2. 多设备测试**
|
||
```javascript
|
||
testMultipleQB303Data()
|
||
```
|
||
- 依次发送3个不同`battle_unit_code`的设备：
|
||
- `dy04` (sn: "2")
|
||
- `dy05` (sn: "3")
|
||
- `dy06` (sn: "4")
|
||
|
||
## 🔍 **测试场景**
|
||
|
||
### **场景1：新设备添加**
|
||
```
|
||
发送 battle_unit_code: "dy04" → 添加新设备 [dy04]
|
||
发送 battle_unit_code: "dy05" → 添加新设备 [dy05]
|
||
结果：列表中有2个不同的设备
|
||
```
|
||
|
||
### **场景2：设备数据更新**
|
||
```
|
||
发送 battle_unit_code: "dy04", altitude: 200 → 添加设备 [dy04]
|
||
发送 battle_unit_code: "dy04", altitude: 250 → 更新设备 [dy04]
|
||
结果：列表中只有1个设备，高度更新为250
|
||
```
|
||
|
||
### **场景3：混合场景**
|
||
```
|
||
发送 battle_unit_code: "dy04", sn: "2" → 添加设备 [dy04]
|
||
发送 battle_unit_code: "dy04", sn: "3" → 更新设备 [dy04] (sn改为"3")
|
||
发送 battle_unit_code: "dy05", sn: "2" → 添加新设备 [dy05]
|
||
结果：列表中有2个设备 [dy04] 和 [dy05]
|
||
```
|
||
|
||
## 📊 **预期输出**
|
||
|
||
### **运行 testQB303Data() 后：**
|
||
```
|
||
收到QB303设备状态数据: {...}
|
||
解析的QB303设备数据: {equipmentId: "dy04", battleUnitCode: "dy04", ...}
|
||
使用battle_unit_code作为设备标识: dy04
|
||
新的QB303设备 [dy04] 已添加
|
||
```
|
||
|
||
### **运行 testMultipleQB303Data() 后：**
|
||
```
|
||
发送设备 [dy04] 的测试数据: {...}
|
||
新的QB303设备 [dy04] 已添加
|
||
|
||
发送设备 [dy05] 的测试数据: {...}
|
||
新的QB303设备 [dy05] 已添加
|
||
|
||
发送设备 [dy06] 的测试数据: {...}
|
||
新的QB303设备 [dy06] 已添加
|
||
|
||
所有QB303设备数据发送完成
|
||
最终设备列表长度: X (原有数量 + 3)
|
||
各设备的battle_unit_code: ["dy04", "dy05", "dy06", ...]
|
||
```
|
||
|
||
## 🎨 **UI显示**
|
||
|
||
在其他装备面板中，每个QB303设备会显示：
|
||
|
||
- **设备名称**: `[dy04] QB303设备`
|
||
- **作战单元**: `dy04`
|
||
- **原始SN**: `2`
|
||
- **设备状态**: 基于`health_status`
|
||
- **位置信息**: 经纬度、高度
|
||
- **运动数据**: 速度、姿态角等
|
||
|
||
## 🚀 **开始测试**
|
||
|
||
1. **清理现有数据**（可选）：
|
||
```javascript
|
||
localStorage.removeItem("index-otherEquipmentList");
|
||
location.reload();
|
||
```
|
||
|
||
2. **测试单个设备**：
|
||
```javascript
|
||
testQB303Data()
|
||
```
|
||
|
||
3. **测试多个设备**：
|
||
```javascript
|
||
testMultipleQB303Data()
|
||
```
|
||
|
||
4. **检查结果**：
|
||
- 观察控制台日志
|
||
- 查看其他装备选项卡数量变化
|
||
- 确认设备列表中显示正确的`battle_unit_code`
|
||
|
||
现在您的QB303设备将按照`battle_unit_code`进行正确的分组和标识！
|