Flame 게임 오디오와 효과음 완벽 가이드

Flutter Flame 게임 엔진에서 배경 음악과 효과음을 다루는 방법을 알아봅니다. flame_audio 패키지 설정부터 볼륨 조절, 사운드 프리로딩까지 게임 오디오의 모든 것을 다룹니다.

---

목차

1. flame_audio 패키지 추가
2. 배경 음악 재생
3. 효과음 재생
4. 오디오 볼륨 조절
5. 오디오 루프
6. 사운드 프리로딩

---

1. flame audio 패키지 추가

김개발 씨는 첫 번째 모바일 게임을 만들고 있습니다. 캐릭터도 움직이고, 적도 나타나고, 게임 로직도 완성했습니다.

그런데 뭔가 허전합니다. "게임인데 왜 이렇게 조용하지?" 바로 그때 선배 박시니어 씨가 말했습니다.

"소리가 없으면 게임이 아니죠. flame_audio를 추가해봐요."

flame_audio는 Flame 게임 엔진에서 오디오를 쉽게 다룰 수 있게 해주는 공식 패키지입니다. 마치 영화관에 스피커 시스템을 설치하는 것과 같습니다.

이 패키지 하나면 배경 음악, 효과음, 볼륨 조절까지 모든 오디오 기능을 사용할 수 있습니다.

다음 코드를 살펴봅시다.

# pubspec.yaml에 의존성 추가
dependencies:
  flutter:
    sdk: flutter
  flame: ^1.18.0
  flame_audio: ^2.10.2

# 터미널에서 패키지 설치
# flutter pub get

# assets 폴더 구조
# assets/
#   audio/
#     bgm.mp3       # 배경 음악
#     jump.wav      # 점프 효과음
#     coin.wav      # 코인 획득 효과음

김개발 씨는 입사 3개월 차 주니어 개발자입니다. 회사에서 첫 번째 모바일 게임 프로젝트를 맡게 되었습니다.

Flame 엔진으로 열심히 게임을 만들었는데, 테스트할 때마다 뭔가 이상했습니다. 분명히 캐릭터가 점프하고, 동전을 먹고, 적과 부딪히는데 너무 조용한 것입니다.

선배 개발자 박시니어 씨가 다가와 게임을 살펴봅니다. "게임 잘 만들었네요.

그런데 소리가 없으면 반쪽짜리 게임이에요. flame_audio를 추가해볼까요?" 그렇다면 flame_audio란 정확히 무엇일까요?

쉽게 비유하자면, flame_audio는 마치 영화관의 음향 시스템과 같습니다. 영화관에서 영상만 나오고 소리가 없다면 어떨까요?

아무리 멋진 액션 장면도 소리 없이는 감동이 절반으로 줄어듭니다. 게임도 마찬가지입니다.

flame_audio는 게임에 생명을 불어넣는 음향 시스템 역할을 합니다. flame_audio가 없던 시절에는 어땠을까요?

개발자들은 Flutter의 기본 오디오 패키지를 직접 다뤄야 했습니다. 배경 음악 재생, 효과음 재생, 볼륨 조절을 각각 별도로 구현해야 했습니다.

코드가 복잡해지고, 게임 루프와 동기화하기도 어려웠습니다. 더 큰 문제는 Flame 엔진의 생명주기와 맞지 않아 메모리 누수가 발생하기도 했다는 점입니다.

바로 이런 문제를 해결하기 위해 flame_audio가 등장했습니다. flame_audio를 사용하면 단 한 줄의 코드로 음악을 재생할 수 있습니다.

또한 Flame 엔진의 생명주기와 완벽하게 통합되어 메모리 관리도 자동으로 처리됩니다. 무엇보다 게임에 특화된 기능들이 미리 준비되어 있어 개발 시간을 크게 단축할 수 있습니다.

위의 코드를 살펴보겠습니다. 먼저 pubspec.yaml 파일에 flame_audio 의존성을 추가합니다.

버전은 flame 패키지와 호환되는 버전을 사용해야 합니다. 그 다음 터미널에서 flutter pub get 명령어를 실행하면 패키지가 설치됩니다.

중요한 것은 assets 폴더 구조입니다. flame_audio는 기본적으로 assets/audio 폴더에서 음원 파일을 찾습니다.

배경 음악용 mp3 파일과 효과음용 wav 파일을 이 폴더에 넣어두면 됩니다. 실제 현업에서는 어떻게 활용할까요?

게임 개발 초기 단계에서 flame_audio를 먼저 설정해두는 것이 좋습니다. 나중에 추가하려면 기존 코드를 많이 수정해야 할 수 있기 때문입니다.

대부분의 게임 회사에서는 프로젝트 초기에 오디오 시스템을 구축해둡니다. 하지만 주의할 점도 있습니다.

초보 개발자들이 흔히 하는 실수 중 하나는 pubspec.yaml에 assets 경로를 등록하지 않는 것입니다. 의존성만 추가하고 assets 폴더를 등록하지 않으면 파일을 찾지 못해 오류가 발생합니다.

반드시 flutter 섹션에 assets 경로를 추가해야 합니다. 다시 김개발 씨의 이야기로 돌아가 봅시다.

박시니어 씨의 설명을 들은 김개발 씨는 바로 flame_audio를 추가했습니다. "생각보다 설정이 간단하네요!" flame_audio 패키지를 제대로 설정하면 이제 게임에 다양한 소리를 추가할 준비가 완료됩니다.

여러분도 첫 번째 단계를 따라해 보세요.

실전 팁

💡 - flame_audio 버전은 flame 패키지 버전과 호환성을 확인하세요

• 효과음은 wav, 배경 음악은 mp3 형식을 권장합니다
• pubspec.yaml에 assets/audio/ 경로 등록을 잊지 마세요

---

2. 배경 음악 재생

패키지 설정을 마친 김개발 씨는 드디어 첫 번째 소리를 넣어보기로 했습니다. "게임을 시작하면 웅장한 배경 음악이 흘러나오면 좋겠어요." 박시니어 씨가 고개를 끄덕입니다.

"좋은 생각이에요. FlameAudio.bgm을 사용하면 됩니다."

FlameAudio.bgm은 배경 음악 전용 재생 기능입니다. 마치 라디오 DJ가 음악을 틀어놓는 것처럼, 게임이 실행되는 동안 계속해서 음악을 재생합니다.

앱이 백그라운드로 가면 자동으로 일시정지되고, 다시 돌아오면 재생을 이어갑니다.

다음 코드를 살펴봅시다.

import 'package:flame_audio/flame_audio.dart';

class MyGame extends FlameGame {
  @override
  Future<void> onLoad() async {
    await super.onLoad();
    // 배경 음악 재생 시작
    FlameAudio.bgm.play('bgm.mp3');
  }

  @override
  void onRemove() {
    // 게임 종료 시 배경 음악 정지
    FlameAudio.bgm.stop();
    super.onRemove();
  }

  // 일시정지 기능
  void pauseMusic() {
    FlameAudio.bgm.pause();
  }

  // 재생 재개
  void resumeMusic() {
    FlameAudio.bgm.resume();
  }
}

김개발 씨는 flame_audio 설정을 마치고 의기양양해졌습니다. 이제 게임에 소리를 넣을 차례입니다.

가장 먼저 넣고 싶은 것은 배경 음악이었습니다. 게임을 시작하면 웅장한 음악이 흘러나오는 그 느낌, 상상만 해도 설렙니다.

선배 개발자 박시니어 씨가 말합니다. "배경 음악은 FlameAudio.bgm을 사용하면 돼요.

일반 효과음과는 다르게 관리되거든요." 그렇다면 bgm은 왜 따로 분리되어 있을까요? 쉽게 비유하자면, 배경 음악은 마치 카페의 배경 음악과 같습니다.

카페에서 음악은 계속 흘러나오지만, 손님들의 대화 소리나 커피 머신 소리와는 별개로 관리됩니다. 음악 볼륨을 조절해도 다른 소리에는 영향이 없습니다.

게임에서도 마찬가지입니다. 배경 음악과 효과음은 서로 독립적으로 관리되어야 합니다.

배경 음악 관리가 제대로 되지 않으면 어떤 문제가 생길까요? 사용자가 다른 앱으로 전환했는데 게임 음악이 계속 나온다면 매우 불쾌할 것입니다.

또한 전화가 왔을 때도 음악이 멈추지 않는다면 큰 문제입니다. 게임을 종료했는데 음악이 계속 재생된다면 배터리도 낭비됩니다.

바로 이런 문제를 FlameAudio.bgm이 자동으로 해결해줍니다. FlameAudio.bgm을 사용하면 앱이 백그라운드로 전환될 때 자동으로 음악이 일시정지됩니다.

다시 앱으로 돌아오면 이어서 재생됩니다. 개발자가 별도로 생명주기를 관리할 필요가 없습니다.

이것이 일반 오디오 플레이어와 bgm의 가장 큰 차이점입니다. 위의 코드를 한 줄씩 살펴보겠습니다.

먼저 onLoad 메서드에서 FlameAudio.bgm.play('bgm.mp3')를 호출합니다. 파일명만 전달하면 assets/audio 폴더에서 자동으로 찾아 재생합니다.

매우 간단합니다. onRemove 메서드에서는 FlameAudio.bgm.stop()을 호출합니다.

게임이 완전히 종료될 때 음악도 함께 정지시켜야 합니다. 이 부분을 빠뜨리면 메모리 누수가 발생할 수 있습니다.

pause와 resume 메서드는 일시정지 기능을 구현할 때 사용합니다. 게임 내 설정 메뉴를 열거나, 일시정지 버튼을 눌렀을 때 활용할 수 있습니다.

실제 현업에서는 어떻게 활용할까요? 대부분의 게임에서는 스테이지별로 다른 배경 음악을 재생합니다.

메인 메뉴, 게임 플레이, 보스전 등 상황에 따라 음악을 바꿔주면 몰입감이 크게 향상됩니다. FlameAudio.bgm.stop()으로 현재 음악을 멈추고 새로운 음악을 play()하면 됩니다.

하지만 주의할 점도 있습니다. 초보 개발자들이 흔히 하는 실수는 음악 파일 경로를 잘못 지정하는 것입니다.

FlameAudio.bgm.play()에는 전체 경로가 아니라 파일명만 전달해야 합니다. 'assets/audio/bgm.mp3'가 아니라 그냥 'bgm.mp3'입니다.

다시 김개발 씨의 이야기로 돌아가 봅시다. 코드를 작성하고 게임을 실행한 순간, 웅장한 배경 음악이 흘러나왔습니다.

"와, 이제 진짜 게임 같아요!" 배경 음악 하나로 게임의 분위기가 완전히 달라집니다. 여러분도 직접 음악을 넣어 확인해 보세요.

실전 팁

💡 - 배경 음악 파일은 용량 최적화를 위해 128kbps mp3를 권장합니다

• onRemove에서 반드시 stop()을 호출하여 리소스를 정리하세요

---

3. 효과음 재생

배경 음악이 완성되자 김개발 씨는 욕심이 생겼습니다. "캐릭터가 점프할 때 '퐁!' 소리가 나면 좋겠어요.

동전을 먹으면 '찰랑' 소리도요." 박시니어 씨가 웃으며 말합니다. "그건 효과음이에요.

FlameAudio.play()를 쓰면 됩니다. 배경 음악과는 다른 방식이에요."

**FlameAudio.play()**는 짧은 효과음을 재생하는 기능입니다. 마치 피아노 건반을 누르는 것처럼, 호출할 때마다 소리가 한 번 납니다.

동시에 여러 효과음을 재생할 수도 있어서 점프 소리와 동전 소리가 겹쳐 나올 수 있습니다.

다음 코드를 살펴봅시다.

import 'package:flame_audio/flame_audio.dart';

class Player extends SpriteComponent {
  // 점프할 때 효과음 재생
  void jump() {
    FlameAudio.play('jump.wav');
    // 점프 로직 실행
    velocity.y = -jumpForce;
  }

  // 동전 획득 시 효과음 재생
  void collectCoin() {
    FlameAudio.play('coin.wav');
    score += 10;
  }

  // 피격 시 효과음 재생
  void takeDamage() {
    FlameAudio.play('hit.wav');
    health -= 1;
  }

  // 볼륨 조절하여 재생 (0.0 ~ 1.0)
  void playQuietSound() {
    FlameAudio.play('step.wav', volume: 0.3);
  }
}

김개발 씨는 배경 음악에 만족했지만, 아직 뭔가 부족했습니다. 캐릭터가 점프해도, 동전을 먹어도, 적에게 맞아도 아무 소리가 나지 않았습니다.

화면에서는 분명히 일이 벌어지는데, 귀로는 아무것도 들리지 않으니 답답했습니다. 선배 개발자 박시니어 씨가 설명합니다.

"효과음은 배경 음악과 완전히 다른 개념이에요. FlameAudio.play()를 사용해야 해요." 그렇다면 효과음은 배경 음악과 무엇이 다를까요?

쉽게 비유하자면, 배경 음악이 오케스트라 연주라면 효과음은 드럼 스틱으로 심벌즈를 치는 것과 같습니다. 오케스트라는 곡 전체가 이어지지만, 심벌즈는 필요한 순간에만 '챙!' 하고 울립니다.

게임에서도 점프, 충돌, 아이템 획득 같은 순간적인 이벤트에 효과음을 사용합니다. 효과음이 없는 게임은 어떤 느낌일까요?

화면에서 캐릭터가 점프하는데 소리가 없으면 마치 무성 영화를 보는 것 같습니다. 적을 공격해도, 아이템을 얻어도 피드백이 없으니 플레이어는 자신의 행동이 제대로 처리되었는지 확신할 수 없습니다.

효과음은 단순한 장식이 아니라 플레이어와 게임 사이의 소통 도구입니다. 바로 이런 역할을 **FlameAudio.play()**가 담당합니다.

FlameAudio.play()를 호출하면 지정한 음원 파일이 즉시 재생됩니다. 재생이 끝나면 자동으로 정리되므로 별도의 관리가 필요 없습니다.

가장 좋은 점은 동시에 여러 효과음을 재생할 수 있다는 것입니다. 점프하면서 동전을 먹으면 두 소리가 함께 들립니다.

위의 코드를 살펴보겠습니다. jump 메서드를 보면 점프 로직 실행 전에 FlameAudio.play('jump.wav')를 호출합니다.

소리 재생은 비동기로 처리되므로 게임 로직에 지연을 주지 않습니다. 점프 소리가 나면서 동시에 캐릭터가 뛰어오릅니다.

collectCoin 메서드에서도 마찬가지입니다. 동전 획득 효과음을 재생하고 점수를 올립니다.

플레이어는 소리로 즉각적인 피드백을 받습니다. playQuietSound 메서드는 volume 파라미터 사용법을 보여줍니다.

0.0부터 1.0 사이의 값으로 볼륨을 조절할 수 있습니다. 발소리처럼 자주 나지만 크게 들릴 필요 없는 소리에 적합합니다.

실제 현업에서는 어떻게 활용할까요? 모바일 게임에서는 효과음의 종류가 수십 가지에 달합니다.

버튼 클릭음, 메뉴 전환음, 승리음, 패배음 등 모든 인터랙션에 효과음을 넣습니다. 좋은 게임일수록 효과음이 섬세하게 설계되어 있습니다.

하지만 주의할 점도 있습니다. 초보 개발자들이 흔히 하는 실수는 너무 많은 효과음을 동시에 재생하는 것입니다.

총알이 100개 발사되면서 각각 효과음을 재생하면 소리가 뒤섞여 불쾌해집니다. 동시 재생 개수를 제한하거나, 같은 소리는 병합하는 로직이 필요합니다.

다시 김개발 씨의 이야기로 돌아가 봅시다. 효과음을 추가하고 게임을 실행하자, 점프할 때마다 '퐁!' 소리가 났습니다.

"이제 진짜 게임을 하는 느낌이에요!" 효과음 하나하나가 모여 게임의 완성도를 높입니다. 여러분도 다양한 효과음을 추가해 보세요.

실전 팁

💡 - 효과음은 짧고 선명한 wav 파일을 사용하세요

• 자주 재생되는 효과음은 볼륨을 낮게 설정하는 것이 좋습니다
• 동시 재생 시 소리가 겹치지 않도록 적절히 조절하세요

---

4. 오디오 볼륨 조절

김개발 씨의 게임이 점점 완성되어 갑니다. 그런데 테스트를 하던 기획자가 말합니다.

"배경 음악이 너무 커서 효과음이 안 들려요. 그리고 설정에서 볼륨 조절 기능도 있어야 하지 않나요?" 박시니어 씨가 고개를 끄덕입니다.

"볼륨 조절은 필수 기능이에요. 방법을 알려줄게요."

볼륨 조절은 게임 오디오의 핵심 기능입니다. 마치 오디오 믹서처럼 배경 음악과 효과음의 볼륨을 각각 독립적으로 조절할 수 있습니다.

FlameAudio는 배경 음악용 볼륨과 효과음용 볼륨을 따로 관리하여 사용자가 원하는 대로 설정할 수 있게 해줍니다.

다음 코드를 살펴봅시다.

import 'package:flame_audio/flame_audio.dart';

class AudioSettings {
  // 배경 음악 볼륨 조절 (0.0 ~ 1.0)
  static void setBgmVolume(double volume) {
    FlameAudio.bgm.audioPlayer.setVolume(volume);
  }

  // 현재 배경 음악 볼륨 가져오기
  static double getBgmVolume() {
    return FlameAudio.bgm.audioPlayer.volume;
  }

  // 효과음은 재생 시 볼륨 지정
  static void playSfx(String file, double volume) {
    FlameAudio.play(file, volume: volume);
  }

  // 모든 오디오 음소거
  static void muteAll() {
    FlameAudio.bgm.audioPlayer.setVolume(0);
  }

  // 음소거 해제
  static void unmuteAll(double previousVolume) {
    FlameAudio.bgm.audioPlayer.setVolume(previousVolume);
  }
}

김개발 씨는 게임이 거의 완성되어 기뻤습니다. 그런데 테스터들의 피드백이 쏟아지기 시작했습니다.

"배경 음악이 너무 시끄러워요." "효과음이 안 들려요." "볼륨 조절 기능은 어디 있어요?" 선배 개발자 박시니어 씨가 말합니다. "볼륨 조절 기능 없이 게임을 출시하면 안 돼요.

사용자마다 선호하는 볼륨이 다르거든요." 그렇다면 볼륨 조절은 왜 이렇게 중요할까요? 쉽게 비유하자면, 볼륨 조절은 마치 라디오의 다이얼과 같습니다.

같은 방송을 들어도 누군가는 크게, 누군가는 작게 듣고 싶어합니다. 지하철에서 게임하는 사람은 소리를 끄고 싶을 것이고, 집에서 편하게 하는 사람은 스피커로 크게 듣고 싶을 것입니다.

볼륨 조절이 없으면 어떤 문제가 생길까요? 가장 흔한 불만은 "배경 음악 때문에 효과음이 안 들린다"는 것입니다.

또는 반대로 "효과음이 너무 커서 시끄럽다"는 피드백도 있습니다. 공공장소에서 갑자기 큰 소리가 나면 민망한 상황이 벌어지기도 합니다.

볼륨 조절 기능이 없는 게임은 앱스토어에서 낮은 평점을 받기 쉽습니다. 바로 이런 문제를 해결하기 위해 세밀한 볼륨 관리가 필요합니다.

FlameAudio에서는 배경 음악과 효과음의 볼륨을 독립적으로 관리할 수 있습니다. 배경 음악은 FlameAudio.bgm.audioPlayer를 통해 실시간으로 볼륨을 바꿀 수 있고, 효과음은 재생할 때마다 볼륨을 지정합니다.

위의 코드를 살펴보겠습니다. setBgmVolume 메서드는 배경 음악 볼륨을 조절합니다.

FlameAudio.bgm.audioPlayer.setVolume()에 0.0부터 1.0 사이의 값을 전달합니다. 0.0은 무음, 1.0은 최대 볼륨입니다.

게임 설정 화면의 슬라이더와 연결하면 됩니다. getBgmVolume 메서드는 현재 볼륨 값을 가져옵니다.

설정 화면에서 슬라이더의 초기 위치를 설정할 때 유용합니다. playSfx 메서드는 효과음 재생을 위한 래퍼입니다.

효과음 볼륨 설정값을 받아서 FlameAudio.play()에 전달합니다. 이렇게 하면 모든 효과음의 볼륨을 일관되게 관리할 수 있습니다.

muteAll과 unmuteAll은 음소거 토글 기능입니다. 게임 설정에서 음소거 버튼을 만들 때 사용합니다.

이전 볼륨 값을 저장해두었다가 음소거 해제 시 복원하는 것이 좋습니다. 실제 현업에서는 어떻게 활용할까요?

대부분의 게임에서는 설정 화면에 배경 음악 볼륨과 효과음 볼륨을 따로 조절하는 슬라이더를 제공합니다. SharedPreferences나 Hive 같은 로컬 저장소에 설정값을 저장해두면 게임을 재시작해도 설정이 유지됩니다.

하지만 주의할 점도 있습니다. 초보 개발자들이 흔히 하는 실수는 효과음 볼륨을 전역으로 관리하지 않는 것입니다.

효과음은 재생 시점에 볼륨을 지정해야 하므로, 설정 클래스에서 효과음 볼륨 값을 변수로 관리하고 모든 play() 호출에서 참조하도록 해야 합니다. 다시 김개발 씨의 이야기로 돌아가 봅시다.

볼륨 조절 기능을 추가하자 테스터들의 불만이 사라졌습니다. "이제 제가 원하는 대로 소리를 조절할 수 있어요!" 볼륨 조절은 사용자 경험의 기본입니다.

여러분의 게임에도 꼭 추가하세요.

실전 팁

💡 - 볼륨 설정값은 로컬 저장소에 저장하여 앱 재시작 시에도 유지되게 하세요

• 기본 볼륨은 0.7 정도로 설정하는 것이 일반적입니다
• 설정 화면에서 실시간 미리듣기 기능을 제공하면 좋습니다

---

5. 오디오 루프

김개발 씨가 게임을 테스트하다 문제를 발견했습니다. "배경 음악이 한 번 끝나면 다시 안 나와요!" 2분짜리 음악이 끝나면 게임이 조용해지는 것입니다.

박시니어 씨가 말합니다. "당연하죠.

루프 설정을 안 했으니까요. 배경 음악은 계속 반복되어야 해요."

오디오 루프는 음악이나 효과음을 반복 재생하는 기능입니다. 마치 음악 플레이어의 반복 재생 버튼처럼, 곡이 끝나면 자동으로 처음부터 다시 재생합니다.

게임의 배경 음악이나 지속적인 환경음에 필수적인 기능입니다.

다음 코드를 살펴봅시다.

import 'package:flame_audio/flame_audio.dart';

class MyGame extends FlameGame {
  @override
  Future<void> onLoad() async {
    await super.onLoad();
    // 배경 음악 루프 재생 (무한 반복)
    FlameAudio.bgm.play('bgm.mp3', volume: 0.8);
    // bgm.play()는 기본적으로 루프가 활성화되어 있음
  }

  // 환경음 루프 재생 (바람 소리, 물 소리 등)
  void playAmbientSound() {
    FlameAudio.loop('wind.mp3', volume: 0.3);
  }

  // 루프 효과음 정지
  void stopAmbientSound() {
    FlameAudio.bgm.stop();
  }

  // 특정 횟수만큼 반복 재생이 필요한 경우
  void playRepeatingSound() async {
    for (int i = 0; i < 3; i++) {
      await FlameAudio.play('alert.wav');
      await Future.delayed(Duration(milliseconds: 500));
    }
  }
}

김개발 씨는 게임을 오래 테스트하다가 이상한 점을 발견했습니다. 처음에는 웅장한 배경 음악이 흘러나왔는데, 2분쯤 지나니까 갑자기 조용해진 것입니다.

"어? 음악이 왜 멈췄지?" 선배 개발자 박시니어 씨가 코드를 살펴봅니다.

"아, FlameAudio.bgm.play()는 기본적으로 루프가 켜져 있는데, 뭔가 설정이 잘못됐나 보네요. 루프 개념을 제대로 이해해야 해요." 그렇다면 오디오 루프란 정확히 무엇일까요?

쉽게 비유하자면, 오디오 루프는 마치 놀이공원의 회전목마와 같습니다. 회전목마는 한 바퀴를 돌고 나면 멈추지 않고 계속 돕니다.

손님이 내리기 전까지 무한히 반복됩니다. 게임의 배경 음악도 마찬가지입니다.

한 번 시작하면 게임이 끝날 때까지 계속 반복되어야 합니다. 루프가 없으면 어떤 문제가 생길까요?

가장 큰 문제는 게임이 갑자기 조용해지는 것입니다. 플레이어가 집중해서 게임을 하다가 갑자기 음악이 멈추면 "버그인가?" 하고 당황합니다.

또한 매번 음악이 끝날 때마다 수동으로 다시 재생하는 코드를 작성하면 복잡해지고 타이밍도 어긋날 수 있습니다. 바로 이런 문제를 자동 루프 기능이 해결해줍니다.

FlameAudio.bgm.play()는 다행히 기본적으로 루프가 활성화되어 있습니다. 음악이 끝나면 자연스럽게 처음부터 다시 재생됩니다.

끊김 없이 부드럽게 이어지므로 플레이어는 음악이 반복되는지조차 느끼지 못합니다. 위의 코드를 살펴보겠습니다.

onLoad에서 FlameAudio.bgm.play()를 호출하면 자동으로 루프 재생됩니다. 별도의 설정이 필요 없습니다.

이것이 bgm 전용 재생 방식의 장점입니다. playAmbientSound 메서드는 **FlameAudio.loop()**를 사용합니다.

이 함수는 배경 음악이 아닌 효과음을 반복 재생할 때 사용합니다. 예를 들어 숲 스테이지에서 새 소리를 계속 틀어놓거나, 해변 스테이지에서 파도 소리를 반복할 때 유용합니다.

playRepeatingSound 메서드는 특정 횟수만큼 반복 재생하는 예제입니다. 무한 루프가 아니라 3번만 반복하고 싶을 때 for 루프와 await를 조합합니다.

경고음이나 알림음에 적합합니다. 실제 현업에서는 어떻게 활용할까요?

프로 게임 개발에서는 루프 포인트라는 개념도 사용합니다. 음악의 인트로 부분은 한 번만 재생하고, 이후부터는 특정 구간만 반복하는 것입니다.

이렇게 하면 더 자연스러운 배경 음악을 만들 수 있습니다. flame_audio에서는 직접 구현해야 하지만, 기본 루프만으로도 충분히 좋은 결과를 얻을 수 있습니다.

하지만 주의할 점도 있습니다. 초보 개발자들이 흔히 하는 실수는 루프되는 오디오를 제대로 정리하지 않는 것입니다.

FlameAudio.loop()로 시작한 오디오는 반드시 stop()으로 정지시켜야 합니다. 그렇지 않으면 화면이 전환되어도 소리가 계속 재생됩니다.

다시 김개발 씨의 이야기로 돌아가 봅시다. 루프 개념을 이해한 김개발 씨는 환경음도 추가했습니다.

숲 스테이지에서는 새 소리가, 동굴 스테이지에서는 물방울 소리가 반복됩니다. "이제 정말 몰입감이 살아나네요!" 오디오 루프를 적절히 활용하면 게임의 분위기가 한층 풍부해집니다.

실전 팁

💡 - bgm.play()는 기본 루프이므로 별도 설정이 필요 없습니다

• FlameAudio.loop()로 시작한 오디오는 반드시 정지 처리를 해주세요
• 루프 음원은 시작과 끝이 자연스럽게 이어지도록 편집하세요

---

6. 사운드 프리로딩

김개발 씨가 게임을 출시 직전 최종 테스트를 하다가 문제를 발견했습니다. 게임 시작 직후 점프를 하면 소리가 약간 늦게 나오는 것입니다.

"처음 한 번만 그러고 그 다음부터는 괜찮은데..." 박시니어 씨가 원인을 알려줍니다. "프리로딩을 안 해서 그래요.

사운드 파일을 미리 메모리에 올려놔야 해요."

사운드 프리로딩은 게임 시작 전에 오디오 파일을 미리 메모리에 로드하는 기술입니다. 마치 요리사가 요리 전에 재료를 미리 손질해두는 것처럼, 소리가 필요할 때 즉시 재생할 수 있도록 준비해둡니다.

첫 재생 시 발생하는 지연을 완전히 제거할 수 있습니다.

다음 코드를 살펴봅시다.

import 'package:flame_audio/flame_audio.dart';

class MyGame extends FlameGame {
  @override
  Future<void> onLoad() async {
    await super.onLoad();

    // 게임 시작 전 모든 오디오 파일 프리로딩
    await _preloadAllAudio();

    // 프리로딩 완료 후 배경 음악 시작
    FlameAudio.bgm.play('bgm.mp3');
  }

  Future<void> _preloadAllAudio() async {
    // 배경 음악 프리로딩
    await FlameAudio.audioCache.load('bgm.mp3');

    // 효과음 프리로딩
    await FlameAudio.audioCache.loadAll([
      'jump.wav',
      'coin.wav',
      'hit.wav',
      'gameover.wav',
      'victory.wav',
    ]);
  }

  // 프리로딩된 사운드 즉시 재생
  void playJumpSound() {
    FlameAudio.play('jump.wav');
  }
}

김개발 씨는 게임을 거의 완성하고 최종 테스트에 들어갔습니다. 그런데 이상한 현상이 발견되었습니다.

게임을 처음 시작하고 점프를 하면 소리가 조금 늦게 나왔습니다. 두 번째 점프부터는 정상이었습니다.

"이건 뭐지? 버그인가?" 선배 개발자 박시니어 씨가 설명합니다.

"버그가 아니에요. 첫 번째 재생 때 파일을 디스크에서 읽어오느라 시간이 걸리는 거예요.

프리로딩으로 해결할 수 있어요." 그렇다면 프리로딩이란 정확히 무엇일까요? 쉽게 비유하자면, 프리로딩은 마치 레스토랑 주방에서 재료를 미리 손질해두는 것과 같습니다.

손님이 스테이크를 주문하면 그때부터 고기를 꺼내고 자르고 양념하면 시간이 오래 걸립니다. 하지만 미리 손질해둔 고기가 있다면 바로 굽기만 하면 됩니다.

사운드 프리로딩도 마찬가지입니다. 미리 메모리에 올려두면 재생 명령이 떨어지는 즉시 소리가 납니다.

프리로딩을 하지 않으면 어떤 문제가 생길까요? 가장 큰 문제는 첫 재생 지연입니다.

처음 소리를 재생할 때 파일을 디스크에서 읽고, 디코딩하고, 메모리에 올리는 과정이 필요합니다. 이 과정이 수십 밀리초에서 수백 밀리초까지 걸릴 수 있습니다.

액션 게임에서 이 정도 지연은 치명적입니다. 플레이어가 버튼을 눌렀는데 반응이 느리면 게임이 버벅인다고 느낍니다.

바로 이런 문제를 FlameAudio.audioCache가 해결해줍니다. audioCache를 사용하면 게임 시작 전에 모든 오디오 파일을 메모리에 미리 올려둘 수 있습니다.

로딩 화면에서 이 작업을 수행하면 플레이어가 기다리는 동안 모든 준비가 완료됩니다. 게임 플레이 중에는 지연 없이 즉시 재생됩니다.

위의 코드를 살펴보겠습니다. onLoad 메서드에서 _preloadAllAudio()를 await로 호출합니다.

모든 오디오 파일이 로드될 때까지 기다린 후에 게임을 시작합니다. 이 시간은 로딩 화면에 포함시키면 됩니다.

_preloadAllAudio 메서드 내부를 보면 두 가지 방법이 있습니다. **load()**는 단일 파일을 로드하고, **loadAll()**은 여러 파일을 한 번에 로드합니다.

loadAll()은 리스트를 받아 병렬로 처리하므로 더 효율적입니다. 프리로딩 후에 playJumpSound를 호출하면 이미 메모리에 있는 사운드가 즉시 재생됩니다.

디스크 접근이 필요 없으므로 지연이 없습니다. 실제 현업에서는 어떻게 활용할까요?

모든 게임에서 프리로딩은 필수입니다. 보통 스플래시 화면이나 로딩 화면에서 에셋 로딩과 함께 오디오 프리로딩을 수행합니다.

파일 개수가 많으면 로딩 진행률 표시와 연동하기도 합니다. "로딩 중...

50%" 같은 화면이 바로 이런 프리로딩 작업을 하고 있는 것입니다. 하지만 주의할 점도 있습니다.

초보 개발자들이 흔히 하는 실수는 너무 많은 파일을 한 번에 프리로딩하는 것입니다. 오디오 파일이 많고 용량이 크면 메모리를 많이 차지합니다.

모바일 기기에서 메모리 부족으로 앱이 강제 종료될 수 있습니다. 현재 스테이지에서 필요한 사운드만 로드하고, 스테이지가 바뀔 때 이전 사운드를 해제하는 것이 좋습니다.

다시 김개발 씨의 이야기로 돌아가 봅시다. 프리로딩을 적용하자 첫 번째 점프 소리도 즉시 재생되었습니다.

"이제 완벽해요! 소리가 바로바로 나와요!" 프리로딩은 게임 품질의 마지막 퍼즐 조각입니다.

여러분의 게임에도 반드시 적용하세요.

실전 팁

💡 - 로딩 화면에서 프리로딩을 수행하면 사용자 경험이 자연스럽습니다

• 메모리 절약을 위해 필요한 사운드만 선택적으로 로드하세요
• 스테이지 전환 시 이전 스테이지 사운드는 캐시에서 제거하는 것이 좋습니다

---

이상으로 학습을 마칩니다. 위 내용을 직접 코드로 작성해보면서 익혀보세요!