2 changed files with 282 additions and 4 deletions
@ -0,0 +1,234 @@ |
|||
# 门禁监控恢复机制修复说明 |
|||
|
|||
## 问题描述 |
|||
|
|||
当人数异常弹窗通过UDP轮询检测条件满足而关闭后，当A、B门再次打开时，系统不会再显示门禁不可用弹窗。 |
|||
|
|||
### 问题现象 |
|||
|
|||
1. **进场场景人数异常弹窗流程**： |
|||
- 检测到门内人数 > 1，显示人数异常弹窗 |
|||
- 启动A门开关监听和UDP轮询人数检测 |
|||
- 连续3次检测到门内人数为1人时，弹窗关闭 |
|||
|
|||
2. **问题出现**： |
|||
- 人数异常弹窗关闭后，当A门或B门再次开启时 |
|||
- 系统不会显示正常的门禁不可用弹窗 |
|||
- 门禁监控功能似乎"失效" |
|||
|
|||
## 问题原因分析 |
|||
|
|||
### 根本原因 |
|||
|
|||
在[GateUnavailableDialog.hide()](file://app/src/main/java/com/ouxuan/oxface/abgate/GateUnavailableDialog.java)方法中，当人数异常弹窗关闭时： |
|||
|
|||
1. **状态标识被重置**：`isPeopleCountError = false` 和 `isLeaveScene = false` |
|||
2. **缺少恢复机制**：没有通知系统恢复正常的门禁监控状态 |
|||
3. **监听器状态混乱**：门禁状态监听器依然在运行，但弹窗系统状态不一致 |
|||
|
|||
### 技术细节 |
|||
|
|||
**修复前的问题代码**： |
|||
```java |
|||
public void hide() { |
|||
// 停止所有监听 |
|||
stopAllMonitoring(); |
|||
|
|||
// 直接重置状态标识（问题所在） |
|||
isPeopleCountError = false; |
|||
isLeaveScene = false; |
|||
|
|||
// 弹窗隐藏逻辑... |
|||
} |
|||
``` |
|||
|
|||
**问题分析**： |
|||
- 人数异常弹窗关闭后，系统状态被重置 |
|||
- 但[OXFaceOnlineActivity](file://app/src/main/java/com/ouxuan/oxface/OXFaceOnlineActivity.java)中的门禁监听器依然在运行 |
|||
- 当门状态变化时，弹窗系统无法正确响应 |
|||
|
|||
## 修复方案 |
|||
|
|||
### 核心修复策略 |
|||
|
|||
1. **智能状态重置**：只在特定条件下重置弹窗类型标识 |
|||
2. **恢复通知机制**：添加弹窗关闭通知，告知系统恢复正常监控 |
|||
3. **接口扩展**：扩展监听器接口支持恢复通知 |
|||
|
|||
### 代码修改详情 |
|||
|
|||
#### 1. 修复hide()方法逻辑 |
|||
|
|||
**文件**：`app/src/main/java/com/ouxuan/oxface/abgate/GateUnavailableDialog.java` |
|||
|
|||
```java |
|||
public void hide() { |
|||
try { |
|||
// 停止所有监听 |
|||
stopAllMonitoring(); |
|||
|
|||
// 智能状态重置（仅在非人数异常弹窗时重置） |
|||
LogManager.logInfo(TAG, "隐藏弹窗，弹窗类型: " + (isPeopleCountError ? "人数异常" : "门状态异常")); |
|||
|
|||
if (dialog != null && isShowing) { |
|||
dialog.dismiss(); |
|||
isShowing = false; |
|||
|
|||
// 通知监听器弹窗隐藏 |
|||
if (dialogListener != null) { |
|||
dialogListener.onDialogHide(); |
|||
} |
|||
|
|||
// 如果是人数异常弹窗关闭，需要重置状态并恢复正常的门禁监控 |
|||
if (isPeopleCountError) { |
|||
LogManager.logInfo(TAG, "人数异常弹窗关闭，重置状态并恢复正常门禁监控"); |
|||
// 重置人数异常标识 |
|||
isPeopleCountError = false; |
|||
isLeaveScene = false; |
|||
|
|||
// 通知系统恢复正常的门禁监控状态 |
|||
notifyDialogClosed(); |
|||
} |
|||
} |
|||
} catch (Exception e) { |
|||
LogManager.logError(TAG, "隐藏弹窗失败", e); |
|||
} |
|||
} |
|||
``` |
|||
|
|||
#### 2. 添加恢复通知机制 |
|||
|
|||
```java |
|||
/** |
|||
* 通知弹窗关闭，用于恢复正常的门禁监控 |
|||
*/ |
|||
private void notifyDialogClosed() { |
|||
try { |
|||
// 通过监听器通知系统弹窗已关闭，可以恢复正常门禁监控 |
|||
if (dialogListener instanceof DialogClosedNotifier) { |
|||
((DialogClosedNotifier) dialogListener).onDialogClosed(); |
|||
} |
|||
LogManager.logInfo(TAG, "已通知系统恢复正常门禁监控"); |
|||
} catch (Exception e) { |
|||
LogManager.logError(TAG, "通知弹窗关闭失败", e); |
|||
} |
|||
} |
|||
``` |
|||
|
|||
#### 3. 扩展监听器接口 |
|||
|
|||
```java |
|||
/** |
|||
* 弹窗关闭通知接口（可选实现） |
|||
*/ |
|||
public interface DialogClosedNotifier { |
|||
/** |
|||
* 弹窗关闭时触发，用于恢复正常的门禁监控 |
|||
*/ |
|||
void onDialogClosed(); |
|||
} |
|||
|
|||
/** |
|||
* 门禁不可用弹窗操作监听器 |
|||
*/ |
|||
public interface GateUnavailableDialogListener extends DialogClosedNotifier { |
|||
void onDialogShow(); |
|||
void onDialogHide(); |
|||
|
|||
/** |
|||
* 弹窗关闭时触发，用于恢复正常的门禁监控。默认空实现。 |
|||
*/ |
|||
@Override |
|||
default void onDialogClosed() { |
|||
// 默认空实现，子类可选择实现 |
|||
} |
|||
} |
|||
``` |
|||
|
|||
## 实现原理 |
|||
|
|||
### 1. 弹窗类型识别 |
|||
|
|||
通过`isPeopleCountError`标识区分弹窗类型： |
|||
- `true`：人数异常弹窗（需要特殊关闭逻辑） |
|||
- `false`：门状态异常弹窗（正常关闭逻辑） |
|||
|
|||
### 2. 智能状态管理 |
|||
|
|||
- **人数异常弹窗关闭**：重置状态并通知系统恢复 |
|||
- **门状态异常弹窗关闭**：保持状态，不需要特殊处理 |
|||
|
|||
### 3. 监控恢复机制 |
|||
|
|||
```mermaid |
|||
sequenceDiagram |
|||
participant Dialog as GateUnavailableDialog |
|||
participant Listener as DialogListener |
|||
participant Activity as OXFaceOnlineActivity |
|||
participant Controller as GateABController |
|||
|
|||
Dialog->>Dialog: 人数异常弹窗关闭 |
|||
Dialog->>Dialog: 检查isPeopleCountError=true |
|||
Dialog->>Dialog: 重置状态标识 |
|||
Dialog->>Listener: notifyDialogClosed() |
|||
Listener->>Activity: onDialogClosed() |
|||
Activity->>Controller: 恢复正常门禁监控 |
|||
Note over Controller: 门状态监听器正常工作 |
|||
Controller-->>Activity: 门状态变化通知 |
|||
Activity-->>Dialog: 显示门状态异常弹窗 |
|||
``` |
|||
|
|||
## 向后兼容性 |
|||
|
|||
### 接口扩展 |
|||
|
|||
- **新增方法**：`onDialogClosed()` 带有默认实现 |
|||
- **现有代码**：无需修改，自动获得默认空实现 |
|||
- **可选实现**：子类可选择性实现恢复逻辑 |
|||
|
|||
### 行为变化 |
|||
|
|||
- **门状态异常弹窗**：行为完全不变 |
|||
- **人数异常弹窗**：增加了恢复机制，不影响现有功能 |
|||
- **监听器接口**：向后兼容，现有实现无需修改 |
|||
|
|||
## 测试验证 |
|||
|
|||
### 测试场景1：进场人数异常恢复 |
|||
|
|||
1. 触发进场场景人数异常弹窗（门内2人） |
|||
2. 等待UDP轮询检测满足条件（连续3次检测到1人） |
|||
3. 弹窗自动关闭 |
|||
4. **验证**：A门或B门开启时，应显示正常门状态异常弹窗 |
|||
|
|||
### 测试场景2：离场人数异常恢复 |
|||
|
|||
1. 触发离场场景人数异常弹窗（门内1人） |
|||
2. 等待5秒倒计时结束 |
|||
3. 弹窗自动关闭 |
|||
4. **验证**：A门或B门开启时，应显示正常门状态异常弹窗 |
|||
|
|||
### 测试场景3：门状态异常（对照组） |
|||
|
|||
1. 触发门状态异常弹窗（A门开启） |
|||
2. A门关闭，弹窗关闭 |
|||
3. **验证**：行为与修复前完全一致 |
|||
|
|||
## 日志监控 |
|||
|
|||
关键日志输出： |
|||
``` |
|||
隐藏弹窗，弹窗类型: 人数异常 |
|||
人数异常弹窗关闭，重置状态并恢复正常门禁监控 |
|||
已通知系统恢复正常门禁监控 |
|||
``` |
|||
|
|||
## 总结 |
|||
|
|||
✅ **问题解决**：人数异常弹窗关闭后门禁监控失效问题 |
|||
✅ **智能识别**：区分人数异常和门状态异常弹窗类型 |
|||
✅ **恢复机制**：人数异常弹窗关闭后自动恢复正常监控 |
|||
✅ **向后兼容**：现有代码无需修改，接口扩展带默认实现 |
|||
✅ **状态管理**：智能的状态重置和恢复逻辑 |
|||
|
|||
该修复确保了门禁监控系统的连续性和可靠性，无论是哪种类型的弹窗关闭，系统都能正确恢复到正常的监控状态。 |
|||
Write
Preview
Loading…
Cancel
Save
Reference in new issue