52 lines
2.6 KiB
C#
52 lines
2.6 KiB
C#
using UnityEngine;
|
||
using Unity.Cinemachine;
|
||
|
||
namespace BaseGames.Camera
|
||
{
|
||
/// <summary>
|
||
/// Cinemachine 扩展：在 Body 阶段之后硬锁定相机某一轴向。
|
||
///
|
||
/// 用途：
|
||
/// - <see cref="LockX"/> = true → 垂直竖井 / 电梯：相机仅上下移动，X 固定于限位区域中心。
|
||
/// - <see cref="LockY"/> = true → 水平走廊：相机仅左右移动，Y 固定于限位区域中心。
|
||
///
|
||
/// 由 <see cref="CameraStateController"/> 在切换区域时自动写入 <see cref="LockedX"/> /
|
||
/// <see cref="LockedY"/>（从 ConfinerCollider.bounds.center 取值）并切换锁定开关。
|
||
/// </summary>
|
||
[AddComponentMenu("Cinemachine/Extensions/Camera Axis Lock")]
|
||
[DisallowMultipleComponent]
|
||
public class CameraAxisLockExtension : CinemachineExtension
|
||
{
|
||
/// <summary>锁定 X 轴（垂直竖井）。</summary>
|
||
[HideInInspector] public bool LockX = false;
|
||
/// <summary>锁定 Y 轴（水平走廊）。</summary>
|
||
[HideInInspector] public bool LockY = false;
|
||
/// <summary>X 轴锁定到的世界坐标（由 CameraStateController 写入）。</summary>
|
||
[HideInInspector] public float LockedX = 0f;
|
||
/// <summary>Y 轴锁定到的世界坐标（由 CameraStateController 写入）。</summary>
|
||
[HideInInspector] public float LockedY = 0f;
|
||
|
||
protected override void PostPipelineStageCallback(
|
||
CinemachineVirtualCameraBase vcam,
|
||
CinemachineCore.Stage stage,
|
||
ref CameraState state,
|
||
float deltaTime)
|
||
{
|
||
if (stage != CinemachineCore.Stage.Body) return;
|
||
|
||
// 通过覆写 PositionCorrection 而非 RawPosition 来锁定轴向。
|
||
// 最终相机位置 = RawPosition + PositionCorrection。
|
||
// 只修改 PositionCorrection 可确保：
|
||
// - 锁定轴：final = RawPos + (LockedVal - RawPos) = LockedVal，无论 Confiner 之前写入了什么修正量
|
||
// - 非锁定轴：保留 CinemachineConfiner3D 已计算好的 PositionCorrection，限位正常生效
|
||
// 若改为修改 RawPosition，在 Confiner 之后运行时会导致
|
||
// final = LockedVal + ConfinementCorrection ≠ LockedVal，使 Confiner 修正量错误叠加。
|
||
var rawPos = state.RawPosition;
|
||
var correction = state.PositionCorrection;
|
||
if (LockX) correction.x = LockedX - rawPos.x;
|
||
if (LockY) correction.y = LockedY - rawPos.y;
|
||
state.PositionCorrection = correction;
|
||
}
|
||
}
|
||
}
|