CasinoGames/Baccarat/Resources/Sounds/README.md

87 lines
2.9 KiB
Markdown

# Sound Effects for Baccarat
## Required Sound Files
Add the following `.mp3` files to this folder:
| Filename | Description | When Played |
|----------|-------------|-------------|
| `chip_place.mp3` | Chip clicking sound | When placing a bet |
| `chip_stack.mp3` | Multiple chips clinking | When stacking chips |
| `card_deal.mp3` | Card sliding/dealing sound | When each card is dealt |
| `card_flip.mp3` | Card flip/reveal sound | When cards are turned face up |
| `card_shuffle.mp3` | Deck shuffling sound | When deck is shuffled (optional) |
| `win.mp3` | Victory/success sound | When player wins |
| `lose.mp3` | Loss sound (subtle) | When player loses |
| `push.mp3` | Neutral/tie sound | When result is a tie/push |
| `big_win.mp3` | Big win celebration | For large payouts |
| `button_tap.mp3` | UI tap feedback | When buttons are tapped |
| `new_round.mp3` | Fresh start sound | When starting a new round |
| `clear_bets.mp3` | Chips sliding/removing | When clearing bets |
| `game_over.mp3` | Sad/failure sound | When player runs out of chips |
## Free Sound Resources
### Casino & Card Game Sounds
1. **Freesound.org** (Free, requires attribution)
- Search: "casino chips", "card dealing", "poker"
- High quality community-contributed sounds
- https://freesound.org
2. **Mixkit** (Free, no attribution required)
- Casino and game sound effects
- https://mixkit.co/free-sound-effects/casino/
3. **Zapsplat** (Free with account)
- Large library of casino sounds
- https://www.zapsplat.com
4. **Soundsnap** (Subscription/paid)
- Professional quality sounds
- https://www.soundsnap.com
5. **Epidemic Sound** (Subscription)
- High-quality licensed sounds
- https://www.epidemicsound.com
### Recommended Search Terms
- "casino chip" or "poker chip"
- "card deal" or "card slide"
- "card flip" or "card turn"
- "win jingle" or "success sound"
- "game over" or "fail sound"
- "casino ambience" (for background)
## Tips for Good Sound Selection
1. **Keep it subtle** - Sounds should enhance, not distract
2. **Short duration** - 0.2-1.5 seconds is ideal for most effects
3. **Consistent volume** - Normalize all sounds to similar levels
4. **High quality** - Use 44.1kHz sample rate minimum
5. **Mobile-friendly** - MP3 format, reasonable file sizes (<500KB each)
## Implementation Notes
- The `SoundManager` class preloads all sounds at app launch
- Missing sound files are handled gracefully (no crash)
- Volume is controllable from Settings
- Sounds respect the user's sound/haptic preferences
## Adding to Xcode Project
1. Add `.mp3` files to this `Sounds` folder
2. In Xcode, ensure files are included in the target
3. Build and run - sounds should work automatically
## Testing
Run the app and:
1. Place a bet hear chip sound
2. Deal cards hear deal/flip sounds
3. See result hear win/lose/push sound
4. New round hear new round sound
5. Clear bets hear clear sound