MR Workshop 区域触发系统

区域触发系统是 MR_Workshop 项目的核心游戏机制，通过检测物体在指定区域内的停留时间来触发游戏事件。

系统架构

核心组件

1. ZoneTrigger（区域触发器）

文件: ZoneTrigger.cs

核心功能:

检测物体进入、停留、离开区域
计时器管理（物体停留指定时间触发完成）
完成状态管理
可视化进度反馈

状态机:

未完成 → 物体进入 → 开始计时 → 达到时间 → 完成状态
   ↓         ↓         ↓         ↓         ↓
重置计时 ← 物体离开 ← 清空列表 ← 计时暂停 ← 触发事件

关键字段:

id: 区域唯一标识
requiredSeconds: 所需停留时间
validLayers: 有效物体层级
IsComplete: 完成状态

2. ZoneGameManager（区域游戏管理器）

文件: ZoneGameManager.cs

核心功能:

管理所有区域触发器
检测所有区域完成条件
触发游戏结束事件

工作流程:

场景加载时刷新所有 ZoneTrigger
监听每个区域的完成事件
检查所有区域是否都完成
触发游戏结束逻辑

3. ZoneRuntimeLoader（运行时加载器）

文件: ZoneRuntimeLoader.cs

核心功能:

从 JSON 文件加载区域配置
运行时动态生成区域
支持多场景切换

JSON 数据格式:

{
  "version": 1,
  "zones": [
    {
      "id": "Z001",
      "scene": "PicoBuild01",
      "position": [x, y, z],
      "rotationEuler": [x, y, z],
      "size": [x, y, z],
      "requiredSeconds": 2.0
    }
  ]
}

4. ZoneVisualMPB（区域可视化）

文件: ZoneVisualMPB.cs

核心功能:

使用 MaterialPropertyBlock 控制材质透明度
显示计时进度（从半透明到透明）
完成时隐藏区域

可视化效果:

初始状态: 半透明（startAlpha = 0.6）
计时过程: 逐渐变透明
完成状态: 完全透明（hideOnComplete = true）

5. ZoneAuthoring（区域创作组件）

文件: ZoneAuthoring.cs

核心功能:

编辑器模式下的区域配置
自动配置 BoxCollider
用于静态区域创建

数据流

JSON配置 → ZoneRuntimeLoader → 生成ZoneTrigger → ZoneGameManager
   ↓
物体进入 → ZoneTrigger.StartTimer() → ZoneVisualMPB.SetProgress()
   ↓
计时完成 → ZoneTrigger.Complete() → ZoneGameManager.CheckAllComplete()
   ↓
所有完成 → ZoneGameManager.OnAllZonesCompleted() → 游戏结束

关键算法

1. 计时器管理

void Update()
{
    if (_inside.Count > 0)
    {
        _timer += Time.deltaTime;
        _visual?.SetProgress(_timer / requiredSeconds);
        
        if (_timer >= requiredSeconds)
        {
            IsComplete = true;
            manager?.OnZoneCompleted(this);
        }
    }
}

2. 物体过滤

bool IsValid(Collider col)
{
    int layer = col.gameObject.layer;
    return (validLayers.value & (1 << layer)) != 0;
}

3. 完成后触发

private void OnEnterCompletedZone(Collider other)
{
    EventHandle.CallZoneComplectOnce();
    Debug.Log($"[Zone {id}] completed zone entered by: {other.name}");
}