BeatSaber/md/UnitySceneSetupGuide.md

# Unity 씬 구성 가이드
> VRBeatSaber — 스크립트 연결 및 씬 세팅

---

## 0. 시작 전 — Build Settings

**File → Build Settings → Add Open Scenes**

순서대로 추가:
```
0. Scenes/Intro
1. Scenes/SongSelect     ← 신규 생성
2. Scenes/SongCreator    ← 신규 생성
3. Scenes/Game
4. Scenes/MapEditorScene
```

---

## 1. SongCard 프리팹 생성 (먼저 만들어야 함)

**Project 창 → Assets/Prefab → 우클릭 → Create Empty**
이름: `SongCard`

계층 구조:
```
SongCard (Button 컴포넌트 추가)
├── Background (Image)
├── TitleText   (TextMeshPro - Text(UI))
├── ArtistText  (TextMeshPro - Text(UI))
├── DurationText (TextMeshPro - Text(UI))
└── DownloadedBadge (Image — 초록 원 또는 체크 아이콘)
```

SongCard 루트에 **SongCard.cs** 컴포넌트 추가 후 Inspector 연결:
| 필드 | 연결 대상 |
|------|-----------|
| Title Text | TitleText |
| Artist Text | ArtistText |
| Duration Text | DurationText |
| Downloaded Badge | DownloadedBadge |
| Button | 루트의 Button 컴포넌트 |

완료 후 **Assets/Prefab/SongCard.prefab** 으로 저장

---

## 2. Intro 씬

기존 씬 재활용. 기존 UI 제거 후 아래 구성.

```
[Hierarchy]
├── Main Camera
├── XR Origin (기존 유지)
└── Canvas (World Space)
    └── IntroPanel
        ├── TitleText      "VR BEAT SABER"
        ├── PlayButton     "게임하기"
        └── CreateButton   "노래만들기"
```

**Canvas 설정:**
- Render Mode: `World Space`
- Position: (0, 1.5, 2)
- Width/Height: 600 / 400

**빈 오브젝트 [IntroManager] 생성 → IntroManager.cs 추가:**
| 필드 | 값 |
|------|-----|
| Play Button | PlayButton |
| Create Button | CreateButton |
| Song Select Scene | `SongSelect` |
| Song Creator Scene | `SongCreator` |

---

## 3. SongSelect 씬 (신규)

**File → New Scene → 저장: Assets/Scenes/SongSelect**

### 계층 구조
```
[Hierarchy]
├── Main Camera
├── XR Origin
├── [GameManager]            ← 빈 오브젝트
└── Canvas (World Space)
    ├── TabPanel
    │   ├── TabAllButton     "전체"
    │   └── TabOwnedButton   "보유중"
    ├── ListPanel
    │   └── ScrollRect
    │       └── Viewport
    │           └── CardContainer   ← Content 오브젝트
    ├── DetailPanel              ← SongDetailPanel이 붙는 오브젝트
    │   ├── TitleText
    │   ├── ArtistText
    │   ├── InfoText             (BPM / 길이)
    │   ├── DifficultyPanel
    │   │   ├── EasyButton
    │   │   ├── NormalButton
    │   │   ├── HardButton
    │   │   └── ExpertButton
    │   ├── ActionPanel
    │   │   ├── DownloadButton   "다운로드"
    │   │   ├── DeleteButton     "삭제"
    │   │   └── PlayButton       "▶ 플레이"
    │   └── ProgressGroup
    │       ├── ProgressSlider
    │       └── ProgressText
    ├── LoadingOverlay           ← 전체 덮는 반투명 패널
    │   └── LoadingText          "불러오는 중..."
    └── ErrorOverlay
        └── ErrorText
```

### Canvas 설정
- Render Mode: `World Space`
- Position: (0, 1.5, 2)
- Width: 1200 / Height: 700

### [GameManager] 오브젝트에 컴포넌트 추가
1. **SongLibrary.cs**
2. **CacheManager.cs**
3. **DownloadManager.cs**

DownloadManager Inspector:
| 필드 | 값 |
|------|-----|
| Base Url | `http://whdwo798.synology.me:8180/beatsaber` |

### DetailPanel에 SongDetailPanel.cs 추가
| 필드 | 연결 대상 |
|------|-----------|
| Title Text | TitleText |
| Artist Text | ArtistText |
| Info Text | InfoText |
| Btn Easy | EasyButton |
| Btn Normal | NormalButton |
| Btn Hard | HardButton |
| Btn Expert | ExpertButton |
| Download Button | DownloadButton |
| Delete Button | DeleteButton |
| Play Button | PlayButton |
| Progress Group | ProgressGroup |
| Progress Slider | ProgressSlider |
| Progress Text | ProgressText |
| Game Scene Name | `Game` |

### Canvas 루트에 SongSelectManager.cs 추가
| 필드 | 연결 대상 |
|------|-----------|
| Tab All Btn | TabAllButton |
| Tab Owned Btn | TabOwnedButton |
| Card Container | CardContainer |
| Song Card Prefab | Assets/Prefab/SongCard |
| Detail Panel | DetailPanel |
| Download Manager | [GameManager]의 DownloadManager |
| Loading Overlay | LoadingOverlay |
| Error Overlay | ErrorOverlay |
| Error Text | ErrorText |

### ScrollRect 설정 (ListPanel)
- Scroll Rect → Content: CardContainer
- CardContainer에 **Vertical Layout Group** 추가
  - Spacing: 10
  - Child Force Expand Width: ✓

---

## 4. SongCreator 씬 (신규)

**File → New Scene → 저장: Assets/Scenes/SongCreator**

### 계층 구조
```
[Hierarchy]
├── Main Camera
├── XR Origin
├── [CreatorManager]         ← 빈 오브젝트
└── Canvas (World Space)
    ├── TitleText            "노래 만들기"
    ├── AudioPanel
    │   ├── AudioDropdown    (TMP_Dropdown)
    │   ├── RefreshButton    "새로고침"
    │   └── InputPathHint    (TMP_Text - 경로 안내)
    ├── MetaPanel
    │   ├── TitleInput       (TMP_InputField) Placeholder: "곡 제목"
    │   ├── ArtistInput      (TMP_InputField) Placeholder: "아티스트"
    │   └── BpmInput         (TMP_InputField) Placeholder: "BPM" / Content Type: Decimal Number
    ├── DifficultyPanel
    │   ├── EasyToggle       "Easy"
    │   ├── NormalToggle     "Normal"
    │   ├── HardToggle       "Hard"    (기본값 ON)
    │   └── ExpertToggle     "Expert"  (기본값 ON)
    ├── ActionPanel
    │   ├── GenerateButton   "AI 생성 시작"
    │   └── ManualButton     "직접 만들기 →"  ← 작게
    └── ProgressGroup
        ├── StatusText
        └── ProgressSlider
```

### [CreatorManager] 오브젝트에 컴포넌트 추가
1. **BeatSageUploader.cs**
2. **NasPublisher.cs**
3. **SongCreatorManager.cs**

NasPublisher Inspector:
| 필드 | 값 |
|------|-----|
| Nas Base Url | `http://192.168.55.3:5000` |
| Nas Account | `admin` |
| Nas Password | _(DSM 비밀번호 입력)_ |
| Nas Root Path | `/volume1/web/beatsaber` |
| Static Base Url | `http://whdwo798.synology.me:8180/beatsaber` |

SongCreatorManager Inspector:
| 필드 | 연결 대상 |
|------|-----------|
| Audio Dropdown | AudioDropdown |
| Refresh Btn | RefreshButton |
| Input Path Hint | InputPathHint |
| Title Input | TitleInput |
| Artist Input | ArtistInput |
| Bpm Input | BpmInput |
| Toggle Easy | EasyToggle |
| Toggle Normal | NormalToggle |
| Toggle Hard | HardToggle |
| Toggle Expert | ExpertToggle |
| Generate Button | GenerateButton |
| Manual Editor Button | ManualButton |
| Progress Group | ProgressGroup |
| Status Text | StatusText |
| Progress Slider | ProgressSlider |
| Beat Sage Uploader | [CreatorManager]의 BeatSageUploader |
| Nas Publisher | [CreatorManager]의 NasPublisher |
| Map Editor Scene | `MapEditorScene` |

---

## 5. Game 씬 수정

기존 Spawner 오브젝트에서 `songName` 필드 제거됨.
아래만 확인하면 됨.

**Spawner 오브젝트 Inspector 확인:**
| 필드 | 연결 대상 |
|------|-----------|
| Audio Source | AudioSource 컴포넌트 |
| Cube Prefabs | [0] RED.prefab / [1] BLUE.prefab |
| Spawn Points | 기존 4개 SpawnPoint Transform |
| Note Speed | 2.0 |
| Distance To Hit | 10.0 |
| Song Select Scene Name | `SongSelect` |

> ⚠️ 기존에 AudioSource에 AudioClip이 연결되어 있으면 제거할 것.
> 이제 런타임에 로컬 파일에서 자동 로드됨.

---

## 6. 씬 이름 문자열 일치 확인

스크립트 내 씬 이름과 실제 파일명이 반드시 일치해야 함.

| 스크립트 | 필드 | 반드시 일치해야 할 씬 파일명 |
|----------|------|--------------------------|
| IntroManager | Song Select Scene | `SongSelect` |
| IntroManager | Song Creator Scene | `SongCreator` |
| SongDetailPanel | Game Scene Name | `Game` |
| SongCreatorManager | Map Editor Scene | `MapEditorScene` |
| Spawner | Song Select Scene Name | `SongSelect` |

---

## 7. Quest 음원 파일 넣는 방법 (SongCreator용)

Beat Sage에 보낼 MP3는 기기의 특정 폴더에 넣어야 함.

```bash
# ADB로 파일 복사
adb push life.mp3 /sdcard/Android/data/[패키지명]/files/input/
```

Unity Editor에서는 아래 경로에 넣으면 됨:
```
C:\Users\[유저명]\AppData\LocalLow\[Company]\[Product]\input\
```

---

## 8. 최종 동작 확인 순서

1. NAS 접속 확인: 브라우저에서 `http://whdwo798.synology.me:8180/beatsaber/songs.json` 열기
2. Unity Play → Intro 씬 실행
3. [게임하기] → SongSelect 씬 로드 → 곡 목록 표시 확인
4. 곡 다운로드 → 플레이 진입 확인
5. Intro → [노래만들기] → SongCreator 씬 → MP3 선택 → AI 생성 시도