# 02 · 镜头系统

> **命名空间** `BaseGames.Camera`  
> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)  
> **依赖** Cinemachine 3 · `BaseGames.Core.Events`

---

## 目录

1. [设计目标](#1-设计目标)
2. [Cinemachine 3 核心组件](#2-cinemachine-3-核心组件)
3. [虚拟相机架构](#3-虚拟相机架构)
   - 3.1 全局双机（Global A/B）
   - 3.2 房间专用相机（可选）
   - 3.3 特殊状态相机
4. [CameraStateController](#4-camerastatecontroller)
5. [可视区域与触发区域](#5-可视区域与触发区域)
   - 5.1 可视区域（RoomVisibleArea）
   - 5.2 切换触发区域（CameraTriggerZone）
6. [过渡效果：CameraBlendProfileSO](#6-过渡效果camerablendprofileso)
7. [镜头震动：CinemachineImpulse](#7-镜头震动cinemachineimpulse)
8. [像素对齐：Pixel Perfect 集成](#8-像素对齐pixel-perfect-集成)
9. [CameraConfigSO — 配置资产](#9-cameraconfigso--配置资产)
10. [场景搭建规范](#10-场景搭建规范)
11. [编辑器友好设计](#11-编辑器友好设计)
12. [大房间相机处理](#12-大房间相机处理)
    - 12.1 竖向/横向无缝滚动房间
    - 12.2 子区域相机分段
    - 12.3 滚动限制模式

---

## 1. 设计目标

- 镜头行为**完全由 Cinemachine 3 驱动**，不手动操作 `Camera.transform`
- **全局 A/B 双机交替复用**：切换房间时将 inactive 的全局相机预设好新边界再切过去，彻底消除 Confiner 跳变
- **房间专用相机（可选）**：每个房间可配置专属 `VCam_Room`，存在时自动优先使用；不配置则回退到全局双机
- **触发区域驱动切换**：`CameraTriggerZone` Trigger Collider 控制镜头切换时机，可在 Scene 视图中可视化编辑
- **可视区域独立编辑**：`RoomVisibleArea` 的 `PolygonCollider2D` 在 Scene 视图可直接拖拽顶点，Gizmo 实时预览视野
- **过渡效果可配置**：`CameraBlendProfileSO` 资产，可逐触发区域覆盖全局默认混合风格与时长
- 镜头震动通过 `CinemachineImpulseSource` 发布，与 Feel 的 `MMF_CinemachineImpulse` 集成
- 像素艺术风格保持亚像素锁定，防止渲染模糊

---

## 2. Cinemachine 3 核心组件

| 组件 | 挂载位置 | 说明 |
|------|---------|------|
| `CinemachineBrain` | Main Camera | 统一调度所有虚拟相机，同一时刻激活优先级最高者 |
| `CinemachineCamera` | 虚拟相机 GO | Cinemachine 3 的虚拟相机基础组件（取代旧版 `CinemachineVirtualCamera`）|
| `CinemachinePositionComposer` | 虚拟相机组件 | 控制跟随目标偏移与阻尼（探索镜头用）|
| `CinemachineOrbitalFollow` | 虚拟相机组件 | Boss 战镜头围绕目标（可选）|
| `CinemachineConfiner2D` | 虚拟相机组件 | 房间边界约束（每个房间设置独立 `Collider2D`）|
| `CinemachineImpulseSource` | 虚拟相机 GO | 发布震动冲量（与 Feel 集成）|
| `CinemachineImpulseListener` | 虚拟相机组件 | 接收并响应冲量（震屏强度系数）|
| `CinemachinePixelPerfect` | 虚拟相机组件 | 与 `PixelPerfectCamera` 协同，消除亚像素抖动 |

---

## 3. 虚拟相机架构

### 3.1 全局双机（Global A/B）

Persistent 场景中预置两台全局虚拟相机，同一时刻仅一台处于"热"优先级。切换房间时将 inactive 机预配置好新 Confiner，再升高其优先级触发 Blend，Blend 结束后互换角色。

| 虚拟相机 | 默认 Priority | 说明 |
|---------|:---:|------|
| `VCam_Global_A` | 10 | 初始活跃，跟踪玩家 |
| `VCam_Global_B` | 9  | 待机，切换时接管 |

**房间切换时序（无房间专用相机）：**

```
玩家穿过 CameraTriggerZone
        │
        ▼
CameraStateController.SwitchRoom(data)
        │
        ├─ 1. 更新 inactive 机（如 VCam_B）
        │     · BoundingShape2D  ← 新房间 RoomVisibleArea.Collider2D
        │     · FollowTarget     ← 玩家 Transform（不变）
        │     · PositionOffset   ← data.cameraOffset
        │
        ├─ 2. 将 data.blendProfile 写入 CinemachineBrain.DefaultBlend
        │
        ├─ 3. inactiveCam.Priority = activeCam.Priority + 1
        │      → CinemachineBrain 自动开始 Blend
        │
        └─ 4. Blend 结束（CinemachineBrain.BlendFinished 回调）
               activeCam.Priority = 9
               swap _activeCam / _inactiveCam 引用
```

### 3.2 房间专用相机（可选）

每个房间场景可以放置一个带 `RoomCamera` 组件的虚拟相机。若存在，则优先级高于全局双机；全局双机继续在后台保持配置，以便专用相机卸载时无缝接管。

| 情况 | 使用相机 | Priority |
|------|---------|:---:|
| 房间无专用相机 | 全局 A/B 中的 active 方 | 10 |
| 房间有 `RoomCamera` | 房间专用虚拟相机 | 15 |

```csharp
// RoomCamera.cs — 挂在房间场景的 VCam_Room_XXX 上
public class RoomCamera : MonoBehaviour
{
    [SerializeField] CinemachineCamera    _vcam;
    [SerializeField] RoomVisibleArea      _visibleArea;   // 本房间可视区域
    [SerializeField] CameraBlendProfileSO _enterBlend;    // 进入时的过渡（可留空）

    void OnEnable()  => CameraStateController.Instance.RegisterRoomCamera(this);
    void OnDisable() => CameraStateController.Instance.UnregisterRoomCamera(this);

    public CinemachineCamera    Vcam        => _vcam;
    public RoomVisibleArea      VisibleArea => _visibleArea;
    public CameraBlendProfileSO EnterBlend  => _enterBlend;
}
```

> 房间专用相机注册时，`CameraStateController` 同步将全局双机的 Confiner 也设置为同一区域，确保专用相机卸载后全局机能无缝接管。

### 3.3 特殊状态相机

以下相机覆盖所有普通相机，由 `CameraStateController` 响应事件频道激活：

| 虚拟相机 | Priority | 激活条件 | 默认 Blend |
|---------|:---:|---------|---------|
| `VCam_Boss` | 30 | `OnBossFightToggled.Raise(true)` | 0.8 s EaseIn |
| `VCam_Cutscene` | 40 | `OnCutsceneStarted` | 0.0 s Cut |
| `VCam_Death` | 50 | `OnPlayerDied` | 1.0 s EaseIn |

---

## 4. CameraStateController

`CameraStateController`（`MonoBehaviour`，挂在 CameraRig GO 上，`DefaultExecutionOrder(-200)`）负责维护全局双机状态、响应事件频道、协调房间专用相机：

```csharp
public class CameraStateController : MonoBehaviour
{
    public static CameraStateController Instance { get; private set; }

    [Header("全局双机")]
    [SerializeField] CinemachineCamera _globalA;
    [SerializeField] CinemachineCamera _globalB;

    [Header("特殊状态机")]
    [SerializeField] CinemachineCamera _vcamBoss;
    [SerializeField] CinemachineCamera _vcamCutscene;
    [SerializeField] CinemachineCamera _vcamDeath;

    [Header("默认过渡效果")]
    [SerializeField] CameraBlendProfileSO _defaultRoomBlend;

    [Header("事件频道")]
    [SerializeField] BoolEventChannelSO  _onBossFightToggled;
    [SerializeField] VoidEventChannelSO  _onPlayerDied;
    [SerializeField] VoidEventChannelSO  _onCutsceneStarted;
    [SerializeField] VoidEventChannelSO  _onCutsceneEnded;

    CinemachineCamera _activeCam;    // 当前"热"全局机
    CinemachineCamera _inactiveCam;  // 待机全局机
    RoomCamera        _currentRoomCam;

    // 切换到新房间（由 CameraTriggerZone 调用）
    public void SwitchRoom(CameraTriggerZone.SwitchData data) { ... }

    // 房间专用相机注册/反注册（由 RoomCamera.OnEnable/OnDisable 调用）
    public void RegisterRoomCamera(RoomCamera cam)   { ... }
    public void UnregisterRoomCamera(RoomCamera cam) { ... }
}
```

**默认 Blend 查找顺序（优先级从高到低）：**

```
触发区域 CameraTriggerZone._blendOverride    （最高优先）
    ↓ 为空时
目标房间 RoomCamera._enterBlend
    ↓ 为空时
CameraStateController._defaultRoomBlend      （全局兜底）
```

**特殊状态 Blend（固定值，不受 BlendProfile 影响）：**

| 切换 | 时长 | 风格 | 说明 |
|------|------|------|------|
| 任意 → Boss | 0.8 s | EaseIn | 慢推入强调 Boss 出场 |
| Boss → 探索 | 0.5 s | EaseOut | 退场恢复 |
| 任意 → Death | 1.0 s | EaseIn | 慢推营造悲剧感 |
| 任意 → Cutscene | 0.0 s | Cut | 过场硬切 |
| Cutscene → 探索 | 0.3 s | EaseOut | 过场结束柔和恢复 |

---

## 5. 可视区域与触发区域

### 5.1 可视区域（RoomVisibleArea）

定义该房间允许相机移动的边界，驱动 `CinemachineConfiner2D`。每个房间场景（或同房间不同区段）放置一个：

```
Scene: Room_Forest_01
└── [VisibleArea_Main] (GameObject)
    ├── PolygonCollider2D (IsTrigger = false)   ← Confiner 要求非 Trigger
    └── RoomVisibleArea.cs
        ├── [SerializeField] string  areaId         // 唯一 ID（"Room_Forest_01_Main"）
        ├── [SerializeField] Vector2 cameraOffset   // 此区域相机跟随偏移
        └── [SerializeField] bool   hideOnPlay      // 运行时隐藏 Gizmo
```

> **重要**：`CinemachineConfiner2D` 要求 `PolygonCollider2D.IsTrigger = false`。如需同一位置同时做触发检测，在子 GO 上另挂一个 Trigger Collider（`CameraTriggerZone` 使用独立 GO）。

**边界约束参数**（`CameraConfigSO`）：

| 参数 | 推荐值 | 说明 |
|------|:------:|------|
| `ConfinerDamping` | 0.0 | 到达边界时的阻尼（0 = 硬停止）|
| `SlowingDistance` | 0.5 | 靠近边界时开始减速的距离 |

一个大房间可以配置**多个 `RoomVisibleArea`**（如上下层、分支路线），由不同的 `CameraTriggerZone` 分别引用。

---

### 5.2 切换触发区域（CameraTriggerZone）

`CameraTriggerZone` 是驱动相机切换的入口，通过 Trigger Collider 检测玩家进入：

```
Scene: Room_Forest_01
└── [CameraTrigger_Entry] (GameObject)
    ├── BoxCollider2D (IsTrigger = true)        ← 放在入口门洞处，可视化编辑
    └── CameraTriggerZone.cs
        ├── [SerializeField] RoomVisibleArea      _targetVisibleArea  // 切换到哪个可视区域
        ├── [SerializeField] RoomCamera           _targetRoomCamera   // 可留空（使用全局双机）
        ├── [SerializeField] CameraBlendProfileSO _blendOverride      // 可留空（使用全局默认）
        ├── [SerializeField] Vector2              _cameraOffset       // 可覆盖 VisibleArea 的偏移
        └── [SerializeField] bool                 _triggerOnce        // true = 仅触发一次
```

```csharp
public class CameraTriggerZone : MonoBehaviour
{
    public struct SwitchData
    {
        public RoomVisibleArea      visibleArea;
        public RoomCamera           roomCamera;    // null = 使用全局双机
        public CameraBlendProfileSO blendProfile;  // null = 查找上级默认
        public Vector2              cameraOffset;
    }

    void OnTriggerEnter2D(Collider2D other)
    {
        if (!other.CompareTag("Player")) return;
        if (_triggerOnce && _triggered) return;
        _triggered = true;

        CameraStateController.Instance.SwitchRoom(new SwitchData
        {
            visibleArea  = _targetVisibleArea,
            roomCamera   = _targetRoomCamera,
            blendProfile = _blendOverride,
            cameraOffset = _cameraOffset != Vector2.zero
                           ? _cameraOffset
                           : _targetVisibleArea.CameraOffset
        });
    }
    bool _triggered;
}
```

**典型放置方式**：在房间入口门洞处放置细长 `BoxCollider2D`（宽约 0.5 单位，高覆盖整个通道），确保玩家穿越时必然触发。`_triggerOnce = false` 时，玩家来回穿越可双向切换（适合同一大房间内的区段分割线）。

---

## 6. 过渡效果：CameraBlendProfileSO

`CameraBlendProfileSO` 是一个轻量配置资产，封装 `CinemachineBlendDefinition`，可在 Inspector 中独立编辑并在多个触发区域之间复用：

```csharp
[CreateAssetMenu(menuName = "Camera/BlendProfile")]
public class CameraBlendProfileSO : ScriptableObject
{
    [Tooltip("过渡风格：Cut / EaseInOut / EaseIn / EaseOut / HardIn / HardOut / Linear")]
    public CinemachineBlendDefinition.Styles style = CinemachineBlendDefinition.Styles.EaseInOut;

    [Range(0f, 3f)]
    public float duration = 0.4f;

    public CinemachineBlendDefinition ToBlendDefinition()
        => new CinemachineBlendDefinition(style, duration);
}
```

**资产存放路径**：`Assets/ScriptableObjects/Config/Camera/Blends/`

**预置资产（建议创建）：**

| 资产名 | Style | Duration | 典型用途 |
|--------|-------|:--------:|----------|
| `Blend_Room_Default.asset` | EaseInOut | 0.4 s | 普通房间切换（全局兜底）|
| `Blend_Room_Snap.asset` | Cut | 0.0 s | 重生/传送等硬切 |
| `Blend_Room_Slow.asset` | EaseIn | 0.8 s | 进入特殊区域（如 Boss 前厅）|
| `Blend_Room_Fast.asset` | Linear | 0.15 s | 快速连续的密集小房间 |

---

## 7. 镜头震动：CinemachineImpulse

### 震动类型设计

| 类型 | 触发来源 | 强度 | 时长 | 说明 |
|------|---------|------|------|------|
| `Light` | 玩家攻击命中普通敌人 | 0.2 | 0.1s | 轻微点击感 |
| `Medium` | 玩家受击 | 0.5 | 0.25s | 明显震动 |
| `Heavy` | 玩家死亡 / Boss 重击 | 1.0 | 0.4s | 强烈震动 |
| `Parry` | 弹反成功 | 0.7 | 0.2s | 带方向性（从敌人方向弹开）|
| `Landing` | 高空落地 | 0.3 | 0.15s | 垂直向下震动 |

### 震动集成方式

Feel 的 `MMF_CinemachineImpulse` Feedback 内部持有 `CinemachineImpulseSource`：
- 命中时由 `PlayerFeedback` / `EnemyFeedback` 中的 `MMF_Player` 触发
- `CinemachineImpulseListener`（挂在虚拟相机上）响应冲量，配置强度缩放系数

**CinemachineImpulseSource 配置**（Inspector）：

| 参数 | 推荐值 | 说明 |
|------|--------|------|
| `ImpulseDefinition.ImpulseType` | `Uniform` | 各方向均匀（普通）/ `Directional`（带方向性震动）|
| `ImpulseDefinition.ImpulseShape` | 自定义曲线 | 快速衰减曲线（前 20% 满强度，后 80% 指数衰减）|
| `DefaultVelocity` | (0.5, -0.5, 0) | 默认震动方向（右斜下）|

---

## 8. 像素对齐：Pixel Perfect 集成

像素艺术游戏要求相机位置锁定到整数像素，否则 Sprite 会出现模糊/闪烁：

### 组件配置链

```
Main Camera
├── PixelPerfectCamera (com.unity.2d.pixel-perfect)
│   ├── Assets Pixels Per Unit: 32
│   ├── Reference Resolution: 480 × 270 (16:9 基准)
│   ├── Crop Frame X/Y: 关闭（允许缩放而非裁剪）
│   └── Upscale Render Texture: 开启（低分辨率渲染再放大）
│
└── CinemachineBrain
    └── Update Method: Fixed Update（与物理帧同步，消除抖动）
```

### 虚拟相机配置

每个虚拟相机上添加 `CinemachinePixelPerfect` Extension：
- 此 Extension 自动将相机位置对齐到像素网格
- 与 `PixelPerfectCamera` 配合，确保最终渲染无亚像素误差

### Orthographic Size 计算

$$\text{Orthographic Size} = \frac{\text{Reference Resolution Height}}{2 \times \text{PPU}} = \frac{270}{2 \times 32} = 4.21875$$

> 使用 `PixelPerfectCamera` 时，Orthographic Size 由组件自动管理，勿手动设置。

---

## 9. CameraConfigSO — 配置资产

`CameraConfigSO` 集中管理所有可调节的镜头参数，存放于：  
`Assets/ScriptableObjects/Config/Camera/CameraConfigSO.asset`

### 探索镜头参数

| 参数 | 类型 | 推荐值 | 说明 |
|------|------|--------|------|
| `ExploreFollowDamping` | `Vector2` | (0.2, 0.2) | XY 轴跟随阻尼 |
| `ExploreAheadDistance` | `float` | 2.0 | 朝移动方向的前瞻偏移量 |
| `ExploreAheadSmoothing` | `float` | 0.5 | 前瞻平滑时间 |
| `ExploreLookUpOffset` | `float` | 1.5 | 长按上看时的额外 Y 偏移 |
| `ExploreLookDownOffset` | `float` | -1.0 | 长按下看时的额外 Y 偏移 |
| `ExploreFOV` | `float` | 4.22 | Orthographic Size（像素对齐）|

### 战斗镜头参数

| 参数 | 类型 | 推荐值 | 说明 |
|------|------|--------|------|
| `CombatZoomOut` | `float` | +0.5 | 战斗时 Orthographic Size 增量（拉远）|
| `CombatForwardOffset` | `float` | 1.0 | 朝敌人方向额外偏移 |
| `CombatFollowDamping` | `Vector2` | (0.3, 0.3) | 战斗时更高阻尼（稳定）|

### Boss 镜头参数

| 参数 | 类型 | 推荐值 | 说明 |
|------|------|--------|------|
| `BossRoomCenter` | `Vector2` | 由 Boss 房间配置 | Boss 房间固定镜头中心 |
| `BossZoomLevel` | `float` | 6.0 | Boss 战 Orthographic Size |

---

## 10. 场景搭建规范

### Persistent 场景：CameraRig 层级结构

```
[CameraRig] (Prefab — DontDestroyOnLoad，放入 Persistent 场景)
│
├── Main Camera
│   ├── PixelPerfectCamera
│   └── CinemachineBrain
│        └── DefaultBlend ← 运行时由 CameraStateController 动态写入
│
├── [GlobalCameras]        ← 全局双机，永远存在
│   ├── VCam_Global_A (CinemachineCamera, Priority 10)
│   │   ├── CinemachinePositionComposer  (Follow = Player)
│   │   ├── CinemachineConfiner2D        ← BoundingShape2D 运行时设置
│   │   ├── CinemachineImpulseListener
│   │   └── CinemachinePixelPerfect
│   └── VCam_Global_B (CinemachineCamera, Priority 9)
│       ├── CinemachinePositionComposer  (Follow = Player)
│       ├── CinemachineConfiner2D
│       ├── CinemachineImpulseListener
│       └── CinemachinePixelPerfect
│
├── [SpecialCameras]        ← 特殊状态机，默认 Priority 0
│   ├── VCam_Boss (CinemachineCamera)
│   │   ├── CinemachineConfiner2D        ← Boss 房间专属 Confiner（运行时设置）
│   │   └── CinemachinePixelPerfect
│   ├── VCam_Death (CinemachineCamera)
│   │   └── CinemachinePixelPerfect
│   └── VCam_Cutscene (CinemachineCamera)
│       └── CinemachinePixelPerfect
│
├── [ImpulseSources]
│   ├── ImpulseSource_Light
│   ├── ImpulseSource_Medium
│   ├── ImpulseSource_Heavy
│   ├── ImpulseSource_Parry
│   └── ImpulseSource_Landing
│
└── CameraStateController.cs
```

### 房间场景中的标准配置

```
Room_XXX (Scene)
│
├── [VisibleArea_Main] (GameObject)       ← 必须，定义主可视区域
│   ├── PolygonCollider2D (IsTrigger = false)
│   └── RoomVisibleArea.cs
│       └── areaId = "Room_XXX_Main"
│
├── [VisibleArea_Sub] (GameObject)        ← 可选，房间有多段时使用
│   ├── PolygonCollider2D (IsTrigger = false)
│   └── RoomVisibleArea.cs
│
├── [CameraTrigger_Entry] (GameObject)   ← 房间入口触发器
│   ├── BoxCollider2D (IsTrigger = true)    ← 放在入口门洞处
│   └── CameraTriggerZone.cs
│       ├── _targetVisibleArea = VisibleArea_Main
│       ├── _targetRoomCamera  = (留空→使用全局双机)
│       └── _blendOverride     = (留空→全局默认)
│
└── [VCam_Room_XXX] (GameObject)         ← 可选，房间专用相机
    ├── CinemachineCamera (Priority 15)
    │   ├── CinemachinePositionComposer
    │   ├── CinemachineConfiner2D
    │   └── CinemachinePixelPerfect
    └── RoomCamera.cs
        ├── _visibleArea = VisibleArea_Main
        └── _enterBlend  = Blend_Room_Slow  (可选)
```

---

## 11. 编辑器友好设计

### RoomVisibleArea — Scene 视图

- `PolygonCollider2D` 内置**Edit Collider** 按钮，可直接在 Scene 视图拖拽顶点编辑边界形状
- `RoomVisibleArea` 始终绘制 **青色轮廓线 + 半透明青色填充**，表示 Confiner 边界
- 叠加绘制 **白色虚线矩形** 表示当前 Orthographic Size 对应的实际视野范围，方便确认边界是否足够
- Inspector 中自动检测：若 PolygonCollider2D 包围盒小于摄像机视野，显示红色警告：
  `⚠ 可视区域小于摄像机视野，镜头将无法移动！`

### CameraTriggerZone — Scene 视图

- 触发区域 Collider2D 始终绘制 **黄色轮廓**（即使未选中 GO）
- 选中时：绘制从触发区域中心指向 `_targetVisibleArea` 中心的 **橙色箭头**，直观显示切换目标
- 若 `_targetRoomCamera` 不为空，额外绘制 **紫色细线** 指向专用相机位置
- Inspector 中 `_blendOverride` 字段旁显示当前生效的 Blend 描述（含回退链说明）：
  ```
  生效 Blend: [触发区域覆盖] EaseIn 0.8s
             或
  生效 Blend: [全局兜底] EaseInOut 0.4s
  ```

### CameraStateController — 运行时监控

Play Mode 下 Inspector 显示：

```
┌─ CameraStateController ──────────────────────────────────────────┐
│  Active Global  : VCam_Global_A  (Priority 10)                   │
│  Inactive Global: VCam_Global_B  (Priority 9)                    │
│  Room Camera    : VCam_Room_Forest01  (Priority 15)              │
│  Blend Progress : ████████████░░░░  75%                          │
│  Current Area   : Room_Forest_01_Main                            │
│  ─────────────────────────────────────────────────────────────── │
│  [触发房间切换] [触发 Boss] [触发死亡] [强制 Snap]                │
└──────────────────────────────────────────────────────────────────┘
```

### Scene 视图 Gizmos 汇总

| 组件 | Gizmo 颜色 | 内容 |
|------|-----------|------|
| `RoomVisibleArea` | 青色 | Confiner 边界轮廓 + 当前视野矩形 |
| `CameraTriggerZone` | 黄色 | 触发 Collider 轮廓 |
| `CameraTriggerZone`（选中） | 橙色箭头 | 指向目标 VisibleArea |
| `RoomCamera` | 紫色 | VCam 视锥（Frustum）轮廓 |
| `CinemachineImpulseSource` | 红色箭头 | 震动方向，长度表示强度 |
| `LargeRoomBoundary` | 绿色粗线框 | 大房间整体边界 |
| `SubRegionTrigger`（选中） | 青绿箭头 | 指向该子区域激活的 VCam |

---

## 12. 大房间相机处理

银河恶魔城中存在若干**大型房间**（Boss 房、竖井、长廊），单个 Confiner 配合全局相机会导致视野移动范围过大、失去房间感。本节说明三种处理策略。

### 12.1 竖向/横向无缝滚动房间

**适用**：长廊（横向滚动）、竖井（纵向滚动）、Boss 前庭。

做法：创建宽/高尺寸匹配房间的 `RoomVisibleArea`（PolygonCollider2D），全局相机的 Confiner 直接限制在这块大 Confiner 里自由滑动。

```
房间宽度 60 单位、高度 12 单位（横向长廊）:
  RoomVisibleArea:
    PolygonCollider2D 顶点: (-30,-6), (30,-6), (30,6), (-30,6)
  全局相机 Confiner2D → 绑定这个 Collider
  结果: 镜头可以横向自由跟随，纵向锁死在房间高度内
```

**锁轴配置**（在 `RoomVisibleArea` 上附加 `CameraAxisLock`）：

```csharp
public class CameraAxisLock : MonoBehaviour
{
    public enum LockMode { None, LockX, LockY }

    [SerializeField] LockMode _lock = LockMode.None;
    [SerializeField] float    _lockedValue;   // LockX 时为固定 X 坐标，LockY 时为固定 Y 坐标

    // CameraStateController 在读取 RoomVisibleArea 时检查是否挂载了此组件
    // 若存在，则在 LateUpdate 中强制修正相机位置
    public void ApplyLock(CinemachineBrain brain)
    {
        var pos = brain.transform.position;
        switch (_lock)
        {
            case LockMode.LockX: brain.transform.position = new Vector3(_lockedValue, pos.y, pos.z); break;
            case LockMode.LockY: brain.transform.position = new Vector3(pos.x, _lockedValue, pos.z); break;
        }
    }
}
```

### 12.2 子区域相机分段

**适用**：Boss 房（进入 Boss 房后锁定在 Boss 战视角）、多功能大厅（不同区域有不同镜头高度）。

策略：在大房间内放置若干 `SubRegionTrigger`，每个子区域激活专属 `RoomCamera`（更高 Priority）：

```
大房间层级:
├── LargeRoom_BossArena
│   ├── RoomVisibleArea_Global        ← 整体边界（兜底 Confiner）
│   ├── SubRegionTrigger_Entrance     ← 入口区，激活 VCam_Entrance（低焦）
│   ├── SubRegionTrigger_Arena        ← 战斗区，激活 VCam_Arena（剧院视角）
│   └── SubRegionTrigger_Exit         ← 出口区，激活 VCam_Exit（低焦）
```

```csharp
/// <summary>
/// 挂载在子区域触发 Collider 上，玩家进入时激活指定 RoomCamera，离开时还原。
/// 可与 §3.2 RoomCamera 逻辑复用，SubRegionTrigger 本质是 CameraTriggerZone 的轻量别名。
/// </summary>
[RequireComponent(typeof(Collider2D))]
public class SubRegionTrigger : MonoBehaviour
{
    [SerializeField] CinemachineCamera _subCamera;     // 子区域专用 VCam
    [SerializeField] CameraBlendProfileSO _blendIn;   // 进入时的 Blend
    [SerializeField] CameraBlendProfileSO _blendOut;  // 离开时的 Blend（可为 null，用全局兜底）

    void OnTriggerEnter2D(Collider2D other)
    {
        if (!other.CompareTag("Player")) return;
        CameraStateController.Instance.ActivateSubRegion(_subCamera, _blendIn);
    }

    void OnTriggerExit2D(Collider2D other)
    {
        if (!other.CompareTag("Player")) return;
        CameraStateController.Instance.DeactivateSubRegion(_subCamera, _blendOut);
    }
}
```

`CameraStateController` 新增方法：

```csharp
public void ActivateSubRegion(CinemachineCamera subCam, CameraBlendProfileSO blend)
{
    if (blend != null)
        ApplyBlendOverride(subCam, blend);
    subCam.Priority = _roomCameraBasePriority + 5;   // 高于普通房间相机
}

public void DeactivateSubRegion(CinemachineCamera subCam, CameraBlendProfileSO blend)
{
    if (blend != null)
        ApplyBlendOverride(subCam, blend);
    subCam.Priority = 0;
}
```

### 12.3 滚动限制模式

针对特定大型场景需要限制某轴的相机运动：

| 模式 | 典型场景 | 配置 |
|------|---------|------|
| **横向自由 + 纵轴锁定** | 横向长廊、横向 Boss 房 | `CameraAxisLock.LockY` |
| **纵向自由 + 横轴锁定** | 竖井、电梯通道 | `CameraAxisLock.LockX` |
| **双轴自由** | 大型开放场景、探索大厅 | 无 Lock，Confiner 覆盖整个区域 |
| **双轴锁定（静止镜头）** | 剧场演出、特定剧情房间 | 使用固定位置 VCam，Priority 最高 |

**锁轴时的边缘提示**：当房间宽度/高度接近相机视野的 1.5× 以内时，`RoomVisibleArea` 的 Gizmo 会在相应轴方向上绘制红色警告线，提示设计师考虑是否需要 `CameraAxisLock`。