# 临时群组界面状态缓存与前端接口回调设计规约 (Design Spec)

## 1. 需求概述
为 StandAPP 临时呼叫功能增加群组锁定状态的缓存与回调机制：
1. **创建界面**：缓存当前的临时群十六进制 GID，并通知前端页面，调用 JS 接口 `startPullGroupLock(gid)`。
2. **销毁界面**：清除缓存的临时群 GID，并通知前端页面，调用 JS 接口 `endPullGroupLock()`。
3. **查询接口**：提供一个新的原生桥接方法 `getTempGroupId` 供前端 JS 主动查询当前在临时群的十六进制 GID。
4. **演示页面**：修改 `print_demo.html` 演示接收回调通知，并添加按钮演示查询当前临时群 GID。

## 2. 方案设计

### 2.1 临时群 GID 缓存逻辑 (`TempCallActivity.kt`)
* **静态成员变量**：在 `TempCallActivity.Companion` 中定义 `@Volatile var currentTempGroupId: String = ""`。
* **创建逻辑 (`onCreate`)**：
  * 获取 `intent.getStringExtra("group_name")`（即临时群组名称，如 "临时群组1" ）。
  * 将名称使用 `SendAtUtil.str2HexStr(name)` 转为十六进制字符串（如 `"D5E1CAE6..."`），并存入 `currentTempGroupId`。
  * 如果 `intent` 直接传了 `group_id`，可以直接使用；如果没有，则使用上述十六进制 GID 作为 fallback。
  * 调用：
    ```kotlin
    MainActivity.executeJs("if(window.startPullGroupLock){ window.startPullGroupLock('$currentTempGroupId'); }")
    ```
* **销毁逻辑 (`onDestroy` / `clearMinimizedState`)**：
  * 销毁时如果 `!isMinimized`，则清除 `currentTempGroupId = ""`。
  * 发生真实销毁时调用：
    ```kotlin
    MainActivity.executeJs("if(window.endPullGroupLock){ window.endPullGroupLock(); }")
    ```

### 2.2 原生桥接接口增加 (`AndroidInterface.kt`)
* 在 `dispatch` 方法的 `when(method)` 分支中增加：
  * `"getTempGroupId" -> getTempGroupId()`
* 实现 `getTempGroupId` 接口：
  ```kotlin
  fun getTempGroupId(): String {
      return TempCallActivity.currentTempGroupId
  }
  ```

### 2.3 演示页面修改 (`print_demo.html`)
* **注册回调方法**：
  ```javascript
  window.startPullGroupLock = function(gid) {
      showPttResult("收到临时群锁定回调 startPullGroupLock, GID: " + gid);
  };
  window.endPullGroupLock = function() {
      showPttResult("收到临时群解锁回调 endPullGroupLock");
  };
  ```
* **新增主动查询按钮**：
  * 在 PTT 功能区域内添加一个按钮 “查询临时群 GID”：
    ```html
    <button onclick="queryTempGroupId()" class="ws-btn">查询当前临时群 GID</button>
    ```
  * JS 触发逻辑：
    ```javascript
    function queryTempGroupId() {
        var gid = window.android.getTempGroupId();
        showPttResult("当前在临时群的 GID: " + (gid || "无"));
    }
    ```