179 lines
4.3 KiB
Markdown
179 lines
4.3 KiB
Markdown
# 🎵 SOUND EFFECTS - TESTING GUIDE
|
|
|
|
**Phase 23 Implementation** - 12.12.2025
|
|
|
|
---
|
|
|
|
## 🚀 **KAKO ZAGNATI IGRO:**
|
|
|
|
### **Način 1: Web Server (Priporočeno)**
|
|
```bash
|
|
node server.js
|
|
```
|
|
Nato odpri: `http://localhost:3000`
|
|
|
|
### **Način 2: Electron**
|
|
```bash
|
|
npm start
|
|
```
|
|
|
|
### **Način 3: Direktno (index.html)**
|
|
Odpri `index.html` v brskalniku (Chrome/Firefox)
|
|
|
|
---
|
|
|
|
## 🔊 **TESTIRANJE ZVOČNIH EFEKTOV:**
|
|
|
|
### **1. FARMING SOUNDS** 🌾
|
|
|
|
#### **DIG Sound** (Till Soil)
|
|
1. Hodi po zeleni travi
|
|
2. Pritisni `SPACE` tipko
|
|
3. **Zvok:** Low thud (80Hz → 10Hz, 150ms)
|
|
4. **Vizualno:** Zemlja postane obdelana (tilled soil)
|
|
|
|
#### **PLANT Sound** (Plant Seeds)
|
|
1. Stopi na obdelano zemljo (tilled soil)
|
|
2. Pritisni `SPACE` tipko
|
|
3. **Zvok:** Soft triangle wave (300Hz, 120ms)
|
|
4. **Vizualno:** Seme se posadi (crop stage 0)
|
|
|
|
#### **HARVEST Sound** (Harvest Crops)
|
|
1. Počakaj, da rastlina zraste (ali uporabi time speed 5x)
|
|
2. Stopi na zrelo rastlino
|
|
3. Pritisni `SPACE` tipko
|
|
4. **Zvok:** Dual-tone melody (523Hz + 659Hz, 160ms)
|
|
5. **Vizualno:** Rastlina izgine, dobiš gold
|
|
|
|
---
|
|
|
|
### **2. BUILD SOUNDS** 🏗️
|
|
|
|
#### **UI CLICK Sound** (Building Selection)
|
|
1. Pritisni `B` za build mode
|
|
2. Pritisni `1`, `2`, `3`, `4`, ali `5`
|
|
3. **Zvok:** Pleasant click (800Hz sine, 50ms)
|
|
4. **Vizualno:** Izbrana stavba se spremeni
|
|
|
|
#### **BUILD Sound** (Place Building)
|
|
1. V build mode-u premakni miško
|
|
2. Klikni na zeleno območje (valid placement)
|
|
3. **Zvok:** Deep square wave (80Hz, 200ms)
|
|
4. **Vizualno:** Stavba se postavi
|
|
|
|
**Hotkeys:**
|
|
- `1` - Fence Post
|
|
- `2` - Fence Horizontal
|
|
- `3` - Fence Vertical
|
|
- `4` - Fence Corner
|
|
- `5` - Barn
|
|
|
|
---
|
|
|
|
### **3. AMBIENT MUSIC** 🎶
|
|
|
|
**Avtomatsko predvajanje:**
|
|
- Glasba se začne ob zagonu igre
|
|
- **Stil:** C Minor Pentatonic (proceduralno)
|
|
- **Frekvence:** 130.81Hz, 155.56Hz, 174.61Hz, 196.00Hz, 233.08Hz, 261.63Hz
|
|
- **Interval:** Vsake 2 sekundi (40% chance za noto)
|
|
- **Trajanje note:** 2 sekunde (long decay)
|
|
|
|
**Kontrole:**
|
|
- `M` - Mute/Unmute (če je implementirano)
|
|
|
|
---
|
|
|
|
## 🎮 **VSI ZVOČNI EFEKTI:**
|
|
|
|
| # | Akcija | Tipka | Zvok | Frekvenca | Trajanje |
|
|
|---|--------|-------|------|-----------|----------|
|
|
| 1 | Till Soil | `SPACE` | Dig | 80Hz → 10Hz | 150ms |
|
|
| 2 | Plant Seed | `SPACE` | Plant | 300Hz | 120ms |
|
|
| 3 | Harvest Crop | `SPACE` | Harvest | 523Hz + 659Hz | 160ms |
|
|
| 4 | Select Building | `1-5` | UI Click | 800Hz | 50ms |
|
|
| 5 | Place Building | `Click` | Build | 80Hz | 200ms |
|
|
| 6 | Background | Auto | Music | C Minor | Continuous |
|
|
|
|
---
|
|
|
|
## 🐛 **TROUBLESHOOTING:**
|
|
|
|
### **Ni zvoka?**
|
|
1. **Preveri volume:** Zvok računalnika ni na mute
|
|
2. **Preveri brskalnik:** Chrome/Firefox podpirata Web Audio API
|
|
3. **Preveri konzolo:** Odpri Developer Tools (F12) → Console
|
|
4. **Preveri SoundManager:** V konzoli vpiši `gameScene.soundManager.isMuted`
|
|
|
|
### **Zvok je pretiho?**
|
|
V konzoli vpiši:
|
|
```javascript
|
|
gameScene.soundManager.sfxVolume = 1.0; // Povečaj na 100%
|
|
```
|
|
|
|
### **Zvok je preglasn?**
|
|
V konzoli vpiši:
|
|
```javascript
|
|
gameScene.soundManager.sfxVolume = 0.3; // Zmanjšaj na 30%
|
|
```
|
|
|
|
### **Izklopi glasbo:**
|
|
V konzoli vpiši:
|
|
```javascript
|
|
gameScene.soundManager.stopMusic();
|
|
```
|
|
|
|
### **Vklopi glasbo:**
|
|
V konzoli vpiši:
|
|
```javascript
|
|
gameScene.soundManager.startMusic();
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 **TEHNIČNE PODROBNOSTI:**
|
|
|
|
### **Web Audio API:**
|
|
- Vsi zvoki so **proceduralno generirani**
|
|
- Ni potrebe po zunanjih .mp3/.wav datotekah
|
|
- Deluje v vseh modernih brskalnikih
|
|
|
|
### **Oscillator Types:**
|
|
- **Sine:** Mehak, čist zvok (UI click, harvest, music)
|
|
- **Triangle:** Mehak, topel zvok (dig, plant)
|
|
- **Square:** Oster, retro zvok (build)
|
|
- **Sawtooth:** Hrapav, agresiven zvok (attack)
|
|
|
|
### **Volume Control:**
|
|
- `musicVolume`: 0.3 (30%)
|
|
- `sfxVolume`: 0.5 (50%)
|
|
- `isMuted`: false
|
|
|
|
---
|
|
|
|
## ✅ **CHECKLIST ZA TESTIRANJE:**
|
|
|
|
- [ ] Dig sound deluje (till soil)
|
|
- [ ] Plant sound deluje (plant seeds)
|
|
- [ ] Harvest sound deluje (harvest crops)
|
|
- [ ] UI click sound deluje (building selection)
|
|
- [ ] Build sound deluje (place building)
|
|
- [ ] Background music se predvaja
|
|
- [ ] Volume je primeren
|
|
- [ ] Ni napak v konzoli
|
|
|
|
---
|
|
|
|
## 🎯 **NASLEDNJI KORAKI:**
|
|
|
|
Po uspešnem testiranju:
|
|
1. **Phase 24:** Inventory Hotbar (Q/E tool swap)
|
|
2. **Phase 25:** Stamina System
|
|
3. **Phase 26:** Advanced Build Mode (rotate, confirm, cancel)
|
|
|
|
---
|
|
|
|
**Datum:** 12.12.2025
|
|
**Verzija:** Phase 23 Complete
|
|
**Status:** ✅ Ready for testing!
|