VR Beat Saber — 코드 리뷰

// DownloadManager, SongController 공통 경로 — 항상 일치해야 함
Application.temporaryCachePath/beatsaber/
  {songId}/
    {songId}.mp3             ← 오디오
    Map_{songId}_normal.json ← 난이도별 맵 JSON
    Map_{songId}_hard.json
    Map_{songId}_expert.json
    Map_{songId}_expertplus.json

public class NoteData
{
    public float time;          // 초 단위 (비트 → 초 변환 후)
    public int   position;     // 열 0-3
    public int   lineLayer;    // 행 0-2
    public int   colorType;    // 0=빨강, 1=파랑
    public int   cutDirection; // 0-8 (Beat Saber 스펙)
}

public class DifficultyMap
{
    public DifficultyInfo normal;
    public DifficultyInfo hard;
    public DifficultyInfo expert;
    public DifficultyInfo expertplus;

    public DifficultyInfo Get(string key) => key switch   // C# 8 switch expression
    {
        "normal"     => normal,
        "hard"       => hard,
        "expert"     => expert,
        "expertplus" => expertplus,
        _            => null
    };
}

// static container — 씬이 바뀌어도 메모리에 남는다
public static class GameSession
{
    public static SongInfo SelectedSong;
    public static string   SelectedDifficulty;
}

// Beat Saber의 _time은 "비트 단위"
// 실제 시간(초) = 비트 / BPM * 60
time = (note._time * 60f) / bpm,

// 예: BPM=120, _time=4 → 4/120*60 = 2.0초

// 폭탄(type=3), 장애물 등은 스킵
if (note._type != 0 && note._type != 1) continue;

public static SongMetadata ParseInfoDat(string json)
{
    var info = JsonUtility.FromJson<BeatSageInfoDat>(json);
    if (info == null) return null;
    return new SongMetadata
    {
        title  = (info._songName       ?? "").Trim(),   // null 병합 연산자
        artist = (info._songAuthorName ?? "").Trim(),
        bpm    = info._beatsPerMinute,
    };
}

Upload() / UploadFromUrl()
  └─ CreateLevel() / CreateLevelFromUrl()   // [1/4] POST → levelId 획득
  └─ PollAndDownload()                       // 공통 phase 2~4
       ├─ PollHeartbeat() (5초 간격, 최대 300초)  // [2/4] 생성 완료 대기
       ├─ DownloadZip() (최대 3회 재시도)        // [3/4] ZIP 다운로드
       └─ ExtractAndConvert()                   // [4/4] .dat → NoteData

// URL 업로드: audio_url 필드에 문자열
new MultipartFormDataSection("audio_url", audioUrl)

// 파일 업로드: 바이트 배열 + MIME 타입
new MultipartFormFileSection("audio_file", audioBytes, fileName, "audio/mpeg")

float elapsed = 0f;
while (!ready && elapsed < POLL_TIMEOUT)   // 300초 초과 시 탈출
{
    yield return new WaitForSeconds(POLL_INTERVAL);  // 5초 대기
    elapsed += POLL_INTERVAL;
    yield return PollHeartbeat(levelId, status => {
        ready = status == "generated" || status == "done";
        error = status == "error";
    }, onError);
    onProgress?.Invoke(0.15f + Mathf.Clamp01(elapsed / POLL_TIMEOUT) * 0.6f);
}

private static string ParseJsonString(string json, string key)
{
    string search = $"\"{key}\":";     // "id":"  를 찾음
    int start = json.IndexOf(search);
    if (start < 0) return null;
    start += search.Length;
    int end = json.IndexOf('"', start);  // 닫는 " 위치
    return end > start ? json.Substring(start, end - start) : null;
}

// Unity 기본 UnityWebRequest.Post(form) 는 DSM에서 401 반환 → 수동 구성 필요
string boundary = Guid.NewGuid().ToString("N");   // 랜덤 경계 문자열

using var body = new MemoryStream();

// 텍스트 필드
WriteField("path",           nasFolder);
WriteField("create_parents", "true");
WriteField("overwrite",      "true");

// 파일 파트
WriteText($"--{boundary}\r\n");
WriteText($"Content-Disposition: form-data; name=\"file\"; filename=\"{fileName}\"\r\n");
WriteText("Content-Type: application/octet-stream\r\n\r\n");
body.Write(bytes, 0, bytes.Length);
WriteText("\r\n--{boundary}--\r\n");  // 종료 경계

req.uploadHandler   = new UploadHandlerRaw(body.ToArray());
req.SetRequestHeader("Content-Type", $"multipart/form-data; boundary={boundary}");

// 기존 목록 읽기 → 없으면 새로 생성 (null 병합)
list ??= new SongsList { version = "1.0", songs = new List<SongInfo>() };

// 같은 id가 있으면 교체, 없으면 추가 — upsert 패턴
int idx = list.songs.FindIndex(s => s.id == newSong.id);
if (idx >= 0) list.songs[idx] = newSong;
else           list.songs.Add(newSong);

// 1단계: 오디오 (전체의 0% ~ 70%)
yield return DownloadFile(audioUrl, audioPath,
    p => onProgress?.Invoke(p * 0.7f),  // 0.0 ~ 0.7
    err => { ... });

// 2단계: 맵 (전체의 70% ~ 100%)
yield return DownloadFile(mapUrl, mapPath,
    p => onProgress?.Invoke(0.7f + p * 0.3f),  // 0.7 ~ 1.0
    err => { ... });

// 캐시 히트 → 다운로드 건너뜀 (멱등성 보장)
if (!File.Exists(audioPath))
{
    yield return DownloadFile(...);
}

private void SpawnNote(NoteData note)
{
    // 스폰 시점의 실제 남은 시간으로 travelTime을 역산
    // → foreach 순차 처리로 생기는 16ms 프레임 차이를 흡수
    float remaining = note.time - _audio.CurrentTime;
    float travelTime = Mathf.Max(0.05f, remaining);

    var info = new SpawnEventInfo
    {
        travelTimeOverride = travelTime,   // VRBeatsKit이 이 값을 우선 사용
        ...
    };
}

public double PlayClipScheduled(AudioClip clip, double delaySeconds = 0.1)
{
    audioSource.Stop();
    audioSource.clip = clip;
    audioSource.time = 0.0f;

    scheduledDspStartTime = AudioSettings.dspTime + delaySeconds;
    hasScheduledClip = true;
    audioSource.PlayScheduled(scheduledDspStartTime);

    return scheduledDspStartTime;
}

public float CurrentTime
{
    get
    {
        if (hasScheduledClip)
            return (float)(AudioSettings.dspTime - scheduledDspStartTime);
        return audioSource.time;
    }
}

// if-else 체인 대신 배열 인덱스로 O(1) 매핑
private static readonly Direction[] CutDirMap =
{
    Direction.Up, Direction.Down, Direction.Left, Direction.Right,
    Direction.UpperLeft, Direction.UpperRight, Direction.LowerLeft, Direction.LowerRight,
    Direction.Center,  // index 8 = Any/Dot
};

private static Direction MapCutDirection(int cut)
    => (cut >= 0 && cut < CutDirMap.Length) ? CutDirMap[cut] : Direction.Center;

private const float LaneSpacing = 0.42f;
private const float LayerSpacing = 0.38f;
private const float HorizontalCenter = 1.5f;
private const float VerticalCenter = 1f;

private static float MapLaneX(int position)
{
    int lane = Mathf.Clamp(position, 0, 3);
    return (lane - HorizontalCenter) * LaneSpacing;
}

private static float MapLayerY(int lineLayer)
{
    int layer = Mathf.Clamp(lineLayer, 0, 2);
    return (layer - VerticalCenter) * LayerSpacing;
}

private static void Click(Selectable sel)
{
    var es = EventSystem.current;
    var eventData = new PointerEventData(es);

    ExecuteEvents.Execute(sel.gameObject, eventData, ExecuteEvents.pointerDownHandler);
    ExecuteEvents.Execute(sel.gameObject, eventData, ExecuteEvents.pointerUpHandler);
    ExecuteEvents.Execute(sel.gameObject, eventData, ExecuteEvents.pointerClickHandler);

    var btn = sel.GetComponent<Button>();
    if (btn != null) btn.onClick.Invoke();
}

var card = new GameObject(song.title);
card.transform.SetParent(cardContainer, worldPositionStays: false);  // false = 로컬 유지

var bg  = card.AddComponent<Image>();
var btn = card.AddComponent<Button>();

// 클로저 캡처 버그 방지 — foreach 루프 변수를 로컬에 복사
SongInfo captured = song;
btn.onClick.AddListener(() => OnCardClicked(captured));

card
  └─ TitleMask  (RectMask2D)    ← 클리핑 컨테이너
       └─ Title (TMP_Text + MarqueeText)  ← 텍스트가 마스크 밖으로 스크롤
  └─ Artist (TMP_Text)
  └─ Badge  (Image + TMP_Text)  ← 다운로드된 곡에만 표시

downloadManager.FetchSongsList(
    onSuccess: list => {
        SaveCache(list);     // 성공하면 캐시 갱신
        RefreshCards();
    },
    onError: _ => {
        SongsList cached = LoadCache();  // 실패하면 캐시로 폴백
        if (cached != null) RefreshCards();
        else errorOverlay.SetActive(true);  // 캐시도 없으면 에러 표시
    });

using var req = UnityWebRequest.Get(url);
yield return req.SendWebRequest();
if (req.result != UnityWebRequest.Result.Success) { /* 에러 처리 */ }
string text = req.downloadHandler.text;

using var req = UnityWebRequestMultimedia.GetAudioClip("file://" + path, AudioType.MPEG);
yield return req.SendWebRequest();
AudioClip clip = DownloadHandlerAudioClip.GetContent(req);

// 조건이 true가 될 때까지 매 프레임 체크
yield return new WaitUntil(() => _audio.CurrentTime >= spawnAt);

// 자식을 코드로 추가한 뒤 레이아웃 강제 재계산
LayoutRebuilder.ForceRebuildLayoutImmediate(cardContainer);
Canvas.ForceUpdateCanvases();

// 블록 없이 — 변수가 선언된 스코프 끝에서 자동 Dispose
using var req = UnityWebRequest.Get(url);
using var ms  = new MemoryStream(bytes);

// 전통 방식 (C# 7 이하)
using (var req = UnityWebRequest.Get(url)) { ... }

// 이전
FindObjectOfType<AudioManager>();
FindObjectsOfType<Canvas>();
tTmp.enableWordWrapping = false;

// 현재
FindFirstObjectByType<AudioManager>();
FindObjectsByType<Canvas>(FindObjectsSortMode.None);
tTmp.textWrappingMode = TextWrappingModes.NoWrap;

// 버그: Unity 오브젝트에 ?? 연산자 사용 → Destroyed 오브젝트를 null로 인식 못함
var light = _pointLight ?? GetComponent<Light>();  // ← 위험!

// 수정: 명시적 GetComponent만 사용
var light = GetComponent<Light>();
if (light != null) { ... }