《Unityで作るリズムゲーム》學習筆記（七）：「判定功能實現」

NoteProperty

• 為了進行判定，我們需要得到的不是note流動的拍子，而是具體的秒數。因此，在NoteProperty中需要添加secBegin、secEnd來保持note與判定線接觸的時間

• secBegin和secEnd不包含在構造函數中，因為他們是在獲得了速度變化信息和音符beatBegin、beatEnd信息之後才進行設置的。

• public class NoteProperty
  {
      //...
      //用於進行note的判定計算
      //判定哪個note的判定時間與玩家輸入時間最為接近
      public float secBegin; //Note進入判定線，與其重疊的一秒
      public float secEnd; //Note離開判定線，離開前與其重疊的最後一拍
  ​
  }

BmsLoader

• secBegin和secEnd與note的其他屬性一樣，也需要在BmsLoader中賦值。

• public BmsLoader(string filePath)
  {
      //...
      //把不同的速度（BPM）段根據其所發生的具體節拍（beat）從小到大排序
      tempoChanges = tempoChanges.OrderBy(x => x.beat).ToList();
      
      //完成所有變速和變拍的信息讀取後，就可以得到note實際到達和離開判定線的時間
      foreach (NoteProperty note in noteProperties)
      {
          note.secBegin = BeatMap.BeatToSecWithVarTempo(note.beatBegin, tempoChanges);
          note.secEnd = BeatMap.BeatToSecWithVarTempo(note.beatEnd, tempoChanges);
      }
  }

PlayerController

• 判定是對「該軌道上尚沒進行判定後處理的最接近判定線的一個Note」的處理。

• 可以通過一個列表來保存場景中所有沒進行判定後處理的note，進行判定後將其從列表中移除。

• //PlayerController
  //...
  //尚未進行判定處理的Note列表
  public static List<NoteControllerBase> existingNotesList;
  //...
  private void Awake()
  {
      //...
      //未判定Notes初始化
      existingNotesList = new List<NoteControllerBase>();
      //...
      
      //Spawning Notes
      foreach (NoteProperty noteProperty in beatMap.noteDatas)
      {
          //...
          //最開始的時候所有note都還沒被消除，把所有Notes加到未消除note列表中
          existingNotesList.Add(objNote.GetComponent<NoteControllerBase>());
          //...
      }
  }

NoteControllerBase

• 稍後將會創建一個JudgementManager（判定管理器），該管理器會調用Note的OnKeyDown方法（根據判斷結果執行相應的後處理），而具體哪種Note怎麼處理，則由對應的Note自己處理。JudgementManager只負責觸發該方法。

• using UnityEngine;
  ​
  public abstract class NoteControllerBase : MonoBehaviour
  {
      public NoteProperty noteProperty;
      //Note判定後處理
      public virtual void OnKeyDown(JudgementType judgementType) { }
  }

SingleNoteController

• 重載OnKeyDown方法，執行Single Note的判定後處理。主要是在Notes被撃中後或者下落至低於判定線且離開最後的可判定範圍後，把自己的物體以及從PlayerController中的「未消除Notes列表」裡移除

• public class SingleNoteController : NoteControllerBase
  {
      private void Update()
      {
          UpdatePosition();
          CheckMiss();
      }
  ​
      void CheckMiss()
      {
          //該SingleNote的進入判定線時間小於當前曲目播放時間的幅度超過了壞評價的範圍，Miss         
          //同時該判斷確保了只有在判定線以下的note才會被視為miss
          //目前如果玩家在Note還有很久在下落到眼前時進行按鍵輸入，JudgementManager仍然會返回Miss
          //但是由於在OnKeyDown中不處理Miss的Note，因此那些Note才不會被銷毀   
          if (noteProperty.secBegin - PlayerController.currentSec 
              < -JudgementManager.judgementWidth[JudgementType.BAD])
          {
              //消除Miss了的Note
              PlayerController.existingNotesList.Remove(GetComponent<NoteControllerBase>());
              Destroy(gameObject);
          }
      }
  ​
      void UpdatePosition()
      {
          //...
      }
  ​
      //該Note被撃中並消除
      public override void OnKeyDown(JudgementType judgementType)
      {
          Debug.Log(judgementType);
          //Bad範圍以內被撃中的Note
          if(judgementType != JudgementType.MISS)
          {
              PlayerController.existingNotesList.Remove(GetComponent<NoteControllerBase>());
              Destroy(gameObject);
          }
      }
  }

JudgementManager

• JudgementManager用來進行Note的判定。通過得到輸入的軌道上最接近判定線的一個note，調用其判斷後處理方法（OnKeyDown）。JudgementManager需要添加到遊戲場景中。

• JudgementManager主要由以下幾個部分組成

  • 定義評價類型和評價的判定範圍

    • ///
      /// 判定評價
      ///
      public enum JudgementType
      {
          MISS,
          PERFECT,
          GOOD,
          BAD
      }
      ​
      public class JudgementManager : MonoBehaviour
      {
          //各評價判定絕對值範圍
          public static Dictionary<JudgementType, float> judgementWidth = new Dictionary<JudgementType, float>
          {
              { JudgementType.PERFECT, 0.05f },
              { JudgementType.GOOD, 0.20f },
              { JudgementType.BAD, 0.30f },
          };
          //...
      }

  • 遍歷所有軌道和檢測玩家輸入，根據玩家輸入得到對應軌道上的最接近note且進行判定和後處理

    • public class JudgementManager : MonoBehaviour
      {
          //玩家輸入設置
          static KeyCode[] InputSettings = new KeyCode[]
          {
              KeyCode.D,
              KeyCode.F,
              KeyCode.Space,
              KeyCode.J,
              KeyCode.K,
          };
      ​
          private void Update()
          {
              //每幀遍歷所有軌道
              for (int lane = 0; lane < InputSettings.Length; lane++)
              {
                  //得到玩家當前輸入的鍵
                  KeyCode playerInput = InputSettings[lane];
                  //某軌道對應的鍵有輸入時
                  if (Input.GetKeyDown(playerInput))
                  {
                      //嘗試得到玩家輸入對應軌道上的最接近判定線的note
                      NoteControllerBase nearestNote = GetNearestNote(lane);
                      if (nearestNote == null) { continue; }
      ​
                      //得出這個當前時間與該note進入判定線的時間差
                      float noteSec = nearestNote.noteProperty.secBegin;
                      float diffSec = Mathf.Abs(noteSec - PlayerController.currentSec);
      ​
                      //得到這個時間差的評價並讓該note進行判定後處理
                      nearestNote.OnKeyDown(GetJudgement(diffSec));
                  }
              }
          }

    • 得到軌道上最接近的note

      • ///
        /// 得到lane軌道上，與判定線最快接觸的note
        ///
        NoteControllerBase GetNearestNote(int lane)
        {
            //在「未消除note列表」中得到該軌道上的所有note
            var nearNotes =
                PlayerController.existingNotesList
                .Where(note => note.noteProperty.lane == lane);
        ​
            //如果該軌道上存在這些note的時候
            if(nearNotes.Any())
            {
                //找出這些note中最快接觸判定線的第一個note並返回
                return nearNotes
                    .OrderBy(note => 
                             Mathf.Abs(note.noteProperty.beatBegin - PlayerController.currentBeat))
                    .First();
            }
            else
            {
                return null;
            }
        ​
        }

    • 評價判斷

      • ///
        /// 評價判斷
        /// 
        JudgementType GetJudgement(float diffSec)
        {
            if(diffSec <= judgementWidth[JudgementType.PERFECT]) { return JudgementType.PERFECT; }        
            else if(diffSec <= judgementWidth[JudgementType.GOOD]) { return JudgementType.GOOD; }        
            else if(diffSec <= judgementWidth[JudgementType.BAD]) { return JudgementType.BAD; }
            else { return JudgementType.MISS; }        
        }

• 總體代碼

  • public class JudgementManager : MonoBehaviour
    {
        //玩家輸入設置
        static KeyCode[] InputSettings = new KeyCode[]
        {
            KeyCode.D,
            KeyCode.F,
            KeyCode.Space,
            KeyCode.J,
            KeyCode.K,
        };
    ​
        private void Update()
        {
            //每幀遍歷所有軌道
            for (int lane = 0; lane < InputSettings.Length; lane++)
            {
                //得到玩家當前輸入的鍵
                KeyCode playerInput = InputSettings[lane];
                //某軌道對應的鍵有輸入時
                if (Input.GetKeyDown(playerInput))
                {
                    //嘗試得到玩家輸入對應軌道上的最接近判定線的note
                    NoteControllerBase nearestNote = GetNearestNote(lane);
                    if (nearestNote == null) { continue; }
    ​
                    //得出這個當前時間與該note進入判定線的時間差
                    float noteSec = nearestNote.noteProperty.secBegin;
                    float diffSec = Mathf.Abs(noteSec - PlayerController.currentSec);
    ​
                    //得到這個時間差的評價並讓該note進行判定後處理
                    nearestNote.OnKeyDown(GetJudgement(diffSec));
                }
            }
        }
    ​
        ///
        /// 得到lane軌道上，與判定線最快接觸的note
        ///
        NoteControllerBase GetNearestNote(int lane)
        {
            //在「未消除note列表」中得到該軌道上的所有note
            var nearNotes =
                PlayerController.existingNotesList
                .Where(note => note.noteProperty.lane == lane);
    ​
            //如果該軌道上存在這些note的時候
            if(nearNotes.Any())
            {
                //找出這些note中最快接觸判定線的第一個note並返回
                return nearNotes
                    .OrderBy(note => 
                             Mathf.Abs(note.noteProperty.beatBegin - PlayerController.currentBeat))
                    .First();
            }
            else
            {
                return null;
            }
    ​
        }
    ​
        ///
        /// 評價判斷
        ///
        JudgementType GetJudgement(float diffSec)
        {
            if(diffSec <= judgementWidth[JudgementType.PERFECT]) { return JudgementType.PERFECT; }        
            else if(diffSec <= judgementWidth[JudgementType.GOOD]) { return JudgementType.GOOD; }        
            else if(diffSec <= judgementWidth[JudgementType.BAD]) { return JudgementType.BAD; }
            else { return JudgementType.MISS; }        
        }
    }

  • 要注意的是，玩家在Note還有很久在下落到眼前時進行按鍵輸入，JudgementManager仍然會返回Miss，但是由於在OnKeyDown中不處理Miss的Note，因此那些Note才不會被銷毀 ；而Miss Note只有在低於判定線的Bad判定範圍時間後，才會銷毀自己