### 实现悬停效果与投影
#### 悬停效果
对于所有添加了 `Spatial Adapter Hover Effect` 脚本的物体，在被交互（无论是 Touch、Pinch 还是 Indirect Pinch）时都会显示 Hover 效果。当前版本的 Hover 颜色仅支持青色，如需其他颜色，请谨慎使用此功能。
#### 投影
添加了 `Spatial Adapter Grounding Shadow` 脚本的物体可以相互投射阴影。请注意控制场景规模，因为场景大小会影响 `shadowMap` 的尺寸，从而直接影响阴影质量。
## Plane Commander
### 飞行状态
```C#
public enum AirplaneState
{
idle,
takeOff,
flying,
descending,
died,
}
```
* `idle`：飞机在地面上
* `takeOff`：飞机起飞
* `flying`：飞机正常飞行中，会在一定范围内上下来回运动
* `descending`：飞机下落中
* `died`：飞机不再进行任何交互，等待进入下一轮
### 飞机的生命周期
```C#
void Update(){
switch (state)
{
case AirplaneState.idle:
idleTime += Time.deltaTime;
if (idleTime > takeOffDuration) state = AirplaneState.takeOff;
break;
case AirplaneState.takeOff:
transform.localPosition += speedY * Time.deltaTime * Vector3.up;
if (transform.localPosition.y > maxHeight) state = AirplaneState.flying;
break;
case AirplaneState.flying:
flyingStartTime += Time.deltaTime;
transform.localPosition = new Vector3(transform.localPosition.x, maxHeight + Mathf.Sin(flyingStartTime * frequence) * amplitude, transform.localPosition.z);
break;
case AirplaneState.rotating:
transform.localPosition -= speedY * Time.deltaTime * Vector3.up;
if (transform.localPosition.y < defaultPosition.y) state = AirplaneState.died;
break;
default:
break;
}
}
```
* `idle` (待机)：
* `idleTime`：`idleTime` 累加 `Time.deltaTime`，用于计算飞机已经待机的时长。
* 当 `idleTime > takeOffDuration` 条件成立后，将飞机的状态从 `idle` 切换到 `takeOff`，飞机将在下一帧开始执行起飞逻辑。
* `takeOff` (起飞中)：
* 不断增大飞机的本地坐标直到达到最大飞行高度 `maxHeight`。
* 当 `transform.localPosition.y > maxHeight` 条件成立后，将飞机的状态从 `takeOff` 切换到 `flying`。
* `flying` (平飞中)：飞机保持在 `maxHeight` 高度附近，像一个正弦波一样平滑地上下起伏，模拟飞行中的气流颠簸。此状态没有自动退出条件，飞机将永远这样飞下去，除非被 hit。
* `descending` (下落中)：飞机被 hit 后会旋转一周：
```C#
public void Hit()
{
state = AirplaneState.descending;
StartCoroutine(OnHitAmimation());
}
private IEnumerator OnHitAmimation()
{
TogglePlaneAnimation(true);
yield return _waitForSeconds;
TogglePlaneAnimation(false);
}
private void TogglePlaneAnimation(bool state)
{
anim.SetBool(IsHit, state);
anim.SetBool(IsIdle, !state);
}
```
* `Hit`：飞机被 hit 后，立即将飞机的状态机状态切换到 `descending`，并执行 `OnHitAmimation`。
* `OnHitAmimation`：
* 开启动画
* 等待动画播放
* 还原动画状态机
### 随机性
* 通过代码而非手动配置来生成多样化的游戏对象，极大地提高了开发效率和内容的丰富度。
* 通过 `Random.Range() * 缩放因子 + 基准值` 的模式，将随机值限制在一个合理且有意义的范围内。
```C#
void Start()
{
defaultPosition = transform.localPosition;
state = AirplaneState.idle;
maxHeight = Random.Range(-1.0f, 1.0f) * 0.05f - 0.1f;
speedY = Random.Range(.0f, 1.0f) * 0.05f + .1f;
frequency = Random.Range(.1f, 2.0f);
amplitude = Random.Range(-1.0f, 1.0f) * 0.05f;
takeOffDuration = Random.Range(-1.0f, 1.0f) * 1.5f + 2f;
}
```
* `defaultPosition`：保存飞机的初始本地位置。
* `state`：设置飞机的初始状态。
* `maxHeight`：随机化飞机在平飞状态下的最大颠簸高度。
* `speedY`：随机化飞机的垂直飞行速度（用于起飞和下降）。
* `frequency`：随机化飞机在平飞状态下的上下颠簸频率。
* `amplitude`：随机化飞机在平飞状态下的上下颠簸幅度。
* `takeOffDuration`：随机化飞机在地面待机的时间长度。
### 如何升级关卡
使用`AirplaneLevelController` 统一控制：
* 玩家交互与流程控制：监听玩家的空间触摸输入，做出反馈。同时，跟踪当前关卡中所有飞机的状态，判断是否启动重生流程，开始新一轮。
* 难度递增与 UI 更新：负责更新屏幕上显示的当前关卡数。
#### 玩家交互与流程控制
```C#
void Update()
{
transform.eulerAngles += Vector3.up * rotateSpeed;
if (numPopped >= numAirplanes)
{
numPopped = 0;
StartCoroutine(Reborn());
}
foreach (var touch in Touch.activeTouches)
{
GameObject obj = SpatialInputSupport.GetInputState(touch).targetObject;
if (obj != null && touch.phase == TouchPhase.Began)
{
if (obj.transform.TryGetComponent(out AirplaneAnimController aircraft))
{
if (aircraft.IsFlying)
{
numPopped++;
aircraft.Hit();
}
}
}
}
}
```
* 场景旋转：通过 `transform.eulerAngles` 累加，创造飞机旋转的效果。
* 判断结束条件：通过 `numPopped` 与 `numAirplanes` 检查已击落的飞机数量是否大于或等于总数。如果是，说明本轮结束。
* `numPopped = 0;`：立即将计数器清零，防止在 `Reborn` 协程等待的 4.5 秒内，`Update` 每一帧都重复启动协程。
* `StartCoroutine(Reborn());`：启动重生流程。
* 处理玩家逻辑：
* `IsFlying`：只有 “飞行中” 状态的飞机才能被击落。这可以防止玩家在飞机正在起飞、重生或已经坠毁时误触得分。
* `numPopped++;`：击落数量加一。
* `aircraft.Hit();`：调用飞机自身的 `Hit()` 方法，触发飞机的坠毁动画和状态改变。
#### 难度递增与 UI 更新
当所有飞机都阵亡时，启动重生流程并进入下一关：
```C#
private IEnumerator Reborn()
{
yield return _waitForSeconds;
for (int i = 0; i < airplanes.Length; i++)
{
airplanes[i].GetComponent