fix 9.1

Fix9_实时门禁监听修复验证.md

@@ -0,0 +1,121 @@
+# Fix 9 - 实时门禁监听修复验证
+
+## 问题回顾
+**原始问题**：当处于OrderSelectionActivity页面进行订单选择核销时，检测到A门打开了，但app没有立即关闭选择核销弹窗。
+
+**根本原因**：之前只实现了静态检查（用户点击时检查），缺少实时监听门禁状态变化的机制。
+
+## 修复方案
+
+### 🔧 核心改动
+
+#### 1. 实现 GateUnavailableListener 接口
+```java
+public class OrderSelectionActivity extends AppCompatActivity implements GateABController.GateUnavailableListener
+```
+
+#### 2. 添加实时监听器注册
+```java
+private void initGateStatusCheck() {
+    // 获取GateABController实例并设置监听器
+    gateController = GateABController.getInstance();
+    if (gateController != null) {
+        // 设置本 Activity 为门禁状态监听器
+        gateController.setGateStateListener(this);
+        LogManager.logInfo(TAG, "Fix 9 - 门禁状态实时监听初始化完成");
+    }
+}
+```
+
+#### 3. 实现关键回调方法
+```java
+@Override
+public void onGateUnavailable(String reason) {
+    LogManager.logWarning(TAG, "Fix 9 - 检测到门禁不可用，立即关闭订单选择页面。原因: " + reason);
+    
+    runOnUiThread(() -> {
+        // 停止倒计时
+        stopCountdown();
+        // 设置结果为取消并关闭Activity
+        setResult(RESULT_CANCELED);
+        finish();
+    });
+}
+```
+
+#### 4. 资源清理
+```java
+@Override
+protected void onDestroy() {
+    // Fix 9: 清理门禁状态监听器
+    if (gateController != null) {
+        gateController.setGateStateListener(null);
+    }
+}
+```
+
+### 🚀 工作流程
+
+1. **Activity启动**：OrderSelectionActivity创建时注册为门禁状态监听器
+2. **实时监听**：GateABController实时监听UDP门禁状态变化
+3. **状态检测**：当A门或B门状态变为开启时，GateABController触发onGateUnavailable回调
+4. **立即响应**：OrderSelectionActivity接收回调后立即关闭Activity
+5. **资源清理**：Activity销毁时清理监听器
+
+### 📊 验证要点
+
+#### 测试场景1：A门开启
+- **预期**：OrderSelectionActivity立即关闭
+- **验证**：日志中应显示"Fix 9 - 检测到门禁不可用，立即关闭订单选择页面"
+
+#### 测试场景2：B门开启  
+- **预期**：OrderSelectionActivity立即关闭
+- **验证**：同上
+
+#### 测试场景3：UDP连接断开
+- **预期**：根据场景判断是否关闭（离场设备可能不关闭）
+- **验证**：查看VenueSceneUtils.isLeaveScene()的判断逻辑
+
+#### 测试场景4：门禁状态恢复正常
+- **预期**：如果Activity已关闭，不会重新打开
+- **验证**：onGateAvailable被调用但Activity已销毁
+
+### 🔍 关键技术点
+
+1. **多层检查机制**：
+   - 静态检查（用户点击时）
+   - 实时监听（状态变化时）
+
+2. **线程安全**：
+   - 使用runOnUiThread确保UI操作在主线程执行
+
+3. **资源管理**：
+   - 注册监听器时保存引用
+   - onDestroy时清理监听器
+
+4. **异常处理**：
+   - 所有关键操作都有try-catch保护
+
+### ✅ 修复验证
+
+根据用户提供的日志：
+```
+2025-09-14 19:46:58.397 GateUnavailableDialog: 更新门状态异常弹窗内容: 检测到A门开启，请先关闭A门
+2025-09-14 19:46:58.399 GateUnavailableDialog: 弹窗已显示，仅更新内容
+```
+
+**修复前**：只有GateUnavailableDialog更新了内容，OrderSelectionActivity没有响应
+**修复后**：OrderSelectionActivity会通过onGateUnavailable回调立即关闭
+
+### 🎯 预期效果
+
+当用户在订单选择页面时，如果A门打开：
+1. GateABController检测到A门状态变化
+2. 触发updateGateState方法
+3. 调用OrderSelectionActivity的onGateUnavailable
+4. OrderSelectionActivity立即关闭
+5. 用户返回到主界面，看到门禁不可用弹窗
+
+## 总结
+
+Fix 9 现在提供了完整的实时门禁状态监听机制，确保当门禁状态在OrderSelectionActivity显示期间发生异常时，能够立即响应并关闭Activity，从而提升用户体验和系统安全性。

app/src/main/java/com/ouxuan/oxface/orderOX/OrderSelectionActivity.java

@@ -27,6 +27,7 @@ import com.ouxuan.oxface.data.LoginDataManager;
 import com.ouxuan.oxface.data.DeviceSelectDataManager; // 添加设备数据管理器导入
 import com.ouxuan.oxface.abgate.GateUnavailableDialog; // 门禁不可用弹窗
 import com.ouxuan.oxface.utils.VenueSceneUtils; // 场景工具类
+import com.ouxuan.oxface.device.GateABController; // AB门控制器
 import com.blankj.utilcode.util.NetworkUtils; // 网络工具类
 import com.bumptech.glide.Glide;
 import com.bumptech.glide.load.resource.bitmap.CircleCrop;
@@ -41,7 +42,7 @@ import java.util.Locale;
  * 订单核销选择页面
  * 用于显示人脸验证后返回的订单列表，供用户选择要核销的订单
  */
-public class OrderSelectionActivity extends AppCompatActivity {
+public class OrderSelectionActivity extends AppCompatActivity implements GateABController.GateUnavailableListener {
     
     private static final String TAG = "OrderSelectionActivity";
     public static final String EXTRA_ORDER_DATA = "order_data";
@@ -70,6 +71,7 @@ public class OrderSelectionActivity extends AppCompatActivity {
     
     // 门禁状态检查相关变量
     private GateUnavailableDialog gateUnavailableDialog;
+    private GateABController gateController;
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -587,6 +589,12 @@ public class OrderSelectionActivity extends AppCompatActivity {
         super.onDestroy();
         stopCountdown();
         
+        // Fix 9: 清理门禁状态监听器
+        if (gateController != null) {
+            gateController.setGateStateListener(null);
+            LogManager.logInfo(TAG, "Fix 9 - 已清理门禁状态监听器");
+        }
+        
         // 释放门禁弹窗资源
         if (gateUnavailableDialog != null) {
             gateUnavailableDialog.release();
@@ -689,11 +697,23 @@ public class OrderSelectionActivity extends AppCompatActivity {
     
     /**
      * 初始化门禁状态检查
+     * Fix 9: 添加实时门禁状态监听机制
      */
     private void initGateStatusCheck() {
         try {
             // 初始化门禁不可用弹窗实例（仅用于检查，不显示）
             gateUnavailableDialog = new GateUnavailableDialog(this);
+            
+            // 获取GateABController实例并设置监听器
+            gateController = GateABController.getInstance();
+            if (gateController != null) {
+                // 设置本 Activity 为门禁状态监听器
+                gateController.setGateStateListener(this);
+                LogManager.logInfo(TAG, "Fix 9 - 门禁状态实时监听初始化完成");
+            } else {
+                LogManager.logWarning(TAG, "GateABController实例为空，无法设置监听器");
+            }
+            
             LogManager.logInfo(TAG, "门禁状态检查初始化完成");
         } catch (Exception e) {
             LogManager.logError(TAG, "门禁状态检查初始化失败", e);
@@ -756,6 +776,63 @@ public class OrderSelectionActivity extends AppCompatActivity {
         }
     }
     
+    // ==================== GateUnavailableListener 接口实现 ====================
+    
+    /**
+     * Fix 9: 门禁状态变化时触发
+     * 这是 GateABStateListener 的基础方法
+     */
+    @Override
+    public void onGateStateChanged(GateABController.GateABState state) {
+        LogManager.logInfo(TAG, "Fix 9 - 门禁状态变化: " + state.toString());
+    }
+    
+    /**
+     * Fix 9: 门禁变为不可用状态时触发 - 立即关闭Activity
+     * 这是实现门禁实时检查的核心方法
+     */
+    @Override
+    public void onGateUnavailable(String reason) {
+        LogManager.logWarning(TAG, "Fix 9 - 检测到门禁不可用，立即关闭订单选择页面。原因: " + reason);
+        
+        // 在主线程中执行关闭操作
+        runOnUiThread(() -> {
+            try {
+                // 停止倒计时
+                stopCountdown();
+                
+                // 设置结果为取消并关闭Activity
+                setResult(RESULT_CANCELED);
+                finish();
+                
+                LogManager.logInfo(TAG, "Fix 9 - 订单选择页面已关闭");
+            } catch (Exception e) {
+                LogManager.logError(TAG, "Fix 9 - 关闭Activity时发生异常", e);
+            }
+        });
+    }
+    
+    /**
+     * Fix 9: 门禁恢复可用状态时触发
+     * 当前Activity关闭后不再需要处理此事件
+     */
+    @Override
+    public void onGateAvailable() {
+        LogManager.logInfo(TAG, "Fix 9 - 门禁恢复可用状态");
+        // 订单选择页面不需要响应门禁恢复事件，因为一旦检测到异常就会关闭页面
+    }
+    
+    /**
+     * Fix 9: 门状态实时更新时触发（用于更新弹窗中的门状态显示）
+     * 订单选择页面主要关心门禁异常检测，状态更新仅用于日志记录
+     */
+    @Override
+    public void onGateStatusUpdate(boolean gateAOpen, boolean gateBOpen, boolean udpConnected) {
+        LogManager.logDebug(TAG, "Fix 9 - 门状态更新: A门=" + (gateAOpen ? "开启" : "关闭") + 
+                                 ", B门=" + (gateBOpen ? "开启" : "关闭") + 
+                                 ", UDP=" + (udpConnected ? "正常" : "异常"));
+    }
+    
     @Override
     public void onBackPressed() {
         super.onBackPressed();