게임 음악은 플레이 테스트가 끝나고 조용해질 때까지 아무도 예산에 포함시키지 않는 항목입니다. 게임 개발자라면 작곡을 하지 않을 경우 보통 두 가지 선택지밖에 없습니다. 1년 동안 화성학을 배우거나, 루핑 트랙 세 개를 사서 QA 과정에서 수백 번씩 듣는 것입니다. 이 글에서는 게임 음악을 만드는 세 번째 방법을 소개합니다. 바로 생성형 음악을 활용하는 것입니다. API 게임 상태(메뉴, 탐험, 전투, 보스전)를 기반으로 점수가 플레이어와 함선에 반응하도록 조정됩니다. 선택한 라이선스 플랜에 따라 상업적 출시가 승인된 함선도 포함됩니다. 그다음에는 코드 스케치, 솔직한 장단점 비교, 그리고 처음에 잘못 이해했던 부분들을 살펴봅니다.


작곡을 배우지 않고 게임 음악을 만드는 방법
'적응형 음악'이란 플레이어의 행동에 따라 배경 음악이 변하는 것을 의미합니다. 플레이어가 탐험할 때는 잔잔한 음악이 흐르다가, 무언가가 플레이어를 공격하려 들면 더욱 복잡해집니다. 게임 개발사들은 작곡가, 드럼, 베이스, 멜로디 등을 각각 녹음한 스템 파일, 그리고 이러한 레이어들을 서서히 변화시키는 미들웨어를 사용하여 적응형 음악을 제작합니다.
아마 여러분은 작곡 프로그램도 없고, 트랙 파일도 없을 겁니다. 대신 상태 머신과 마감일만 있을 거예요.
그래서 업무가 바뀝니다. 비디오 게임 음악 작곡법을 배우는 대신, 음악 연출법을 배우게 되는 거죠. 어떤 순간에 어떤 에너지가 필요한지 결정하면, 다른 무언가가 음표를 만들어냅니다. 몇 프레임마다 코드가 "지금은 전투 상황이야"라고 말하면, 음악이 그에 맞춰 반응하는 겁니다.
생성적인 API 글쓰는 부분을 담당합니다. Mubert API 문서 트랙 생성과 음악 스트리밍을 앱, 게임 또는 서비스에 통합하는 방법이라고 설명할 수 있습니다. 음악은 사람이 만든 샘플에서 가져오고, 그 음악이 사용될 때마다 아티스트는 수익을 얻기 때문에, 여기서는 음악가를 대체하는 것이 아닙니다. 오히려 수천 명의 음악가를 고용하는 것과 마찬가지이며, 스케줄 관리도 필요 없습니다. 따라서 게임에 필요한 음악이 있는데 음악 이론에 대해 전혀 모른다면, 이 부분을 아웃소싱하면 됩니다.
당신의 게임에는 이미 점수가 있고, 그것을 상태 기계라고 부릅니다.
HTTP 호출을 하기 전에 상태를 기록하고 각 상태가 어떤 느낌이어야 하는지 적어두세요. 10분이면 충분하고 일주일의 시간을 절약할 수 있습니다.
| 게임 상태 | 에너지 | 전달 | |—|—|—| | 메뉴 | 낮음, 인내심 | 사전 생성된 반복 재생 | | 탐험 | 중간 | 실시간 스트림, 강도 "중간" | | 전투 | 높음 | 동일 스트림, 강도 "높음" | | 보스 | 높음, 명확함 | 사전 생성된 트랙, 크로스페이드 | | 승리/사망 | 짧은 효과음 | 사전 생성된 징글 |
게임 음악을 제공하는 두 가지 방식이 여기에 소개되어 있으며, 이 글에서는 두 방식 중 어떤 것을 선택할지에 대해 다룹니다. 스트리밍 방식 은 끊임없이 생성되는 음악 스트림으로, 재생 중에 원하는 대로 제어할 수 있습니다. 사전 생성 방식은 완성된 파일을 한 번 요청하여 저장해 두고 전송하는 방식입니다.
둘 중 하나만으로도 게임 전체를 만들 수 있습니다. 하지만 대부분의 게임은 결국 둘 다 사용하게 되는데, 메뉴와 보스전이 인터넷을 어떻게 활용해야 하는지에 대한 개념이 매우 다르기 때문입니다.
게임용 음악 스트리밍: 하나의 스트림, 세 가지 음량 조절
스트리밍 과정은 링크 요청으로 시작됩니다. 먼저 채널(a)을 선택합니다. playlist_index, Mubert장르 또는 분위기 사전 설정의 ID), 비트 전송률, 시작 강도 및 전송 방식을 지정합니다.
curl -X GET "https://music-api.mubert.com/api/v3/public/streaming/get-link" \
-H "customer-id: CUSTOMER_ID" -H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"playlist_index": "1.0.0", "bitrate": 320, "intensity": "medium", "type": "webrtc"}'
교통수단은 다음과 같습니다. http or webrtc비트 전송률은 32에서 320까지입니다. v3 참조에 따르면. Mubert WebRTC의 지연 시간이 1초 미만이라고 명시되어 있습니다. API 페이지게임 음악에서는 재생 목록보다 지연 시간이 훨씬 중요합니다. 검을 휘두르는 소리와 드럼 소리가 동시에 들려야 하기 때문입니다. HTTP는 더 간단하며 메뉴에는 적합합니다.
한 가지 작은 함정: 이것은 JSON 본문을 사용하는 GET 요청입니다. 브라우저 fetch GET 요청 시 본문을 전송하지 않으므로 백엔드 또는 네이티브 HTTP 클라이언트에서 해당 호출을 수행해야 합니다. (한밤중에 TypeError를 통해 이 사실을 알게 되는 건 누구에게도 즐거운 일이 아닙니다.)
재시작 없이 스트림 도중에 강도 변경
이 부분이 바로 적응성을 가능하게 하는 부분입니다. set-intensity 호출은 편곡의 혼잡도를 변화시킵니다. 참고 자료에 따르면, 프리셋은 동시에 더 적거나 더 많은 악기를 사용하며, 스트림을 끊지 않고 강도를 변경할 수 있습니다. 또한 두 번째 호출은... streaming/restart같은 URL에서 다른 멜로디가 시작되도록 합니다. 이것이 바로 "새 영역" 버튼입니다.
const API = "https://music-api.mubert.com/api/v3/public";
const headers = { "customer-id": CUSTOMER_ID, "access-token": ACCESS_TOKEN, "Content-Type": "application/json" };
export const setIntensity = (level: "low" | "medium" | "high") =>
fetch(`${API}/streaming/set-intensity`, { method: "POST", headers, body: JSON.stringify({ intensity: level }) });
export const newArea = () =>
fetch(`${API}/streaming/restart`, { method: "POST", headers });
설명서에는 루프 모드(켜기/끄기, 그리고 선택적으로 재생 시간 매개변수 포함)에 대한 설명도 있습니다. 퍼즐 방에서 특정 구절이 계속 이어지도록 해야 할 때 유용합니다.
음악 감독은 악보가 당황하는 것을 막는다.
우리는 가장 뻔한 방법부터 시도해 봤습니다. 공격 강도를 "사거리 내 적"에 바로 연결해 봤는데, 결과는 좋지 않았습니다. 박쥐 한 마리가 공격 범위 가장자리에서 플레이어 주위를 맴돌았고, 배경 음악은 마치 의견이 바뀌는 연기 감지기처럼 분위기가 오락가락했습니다.
따라서 게임에 적응하는 음악에는 심판이 필요합니다. 게임 플레이와 오디오 사이에 아주 작은 계층이 존재하는 것이죠. 이를 음악 감독이라고 부르겠습니다. 음악 감독은 새로운 상태가 충분히 오래 지속될 때까지 변화를 보류하는데, 이 과정은 비대칭적입니다. 전투에 진입하는 것은 빨라야 하지만, 전투에서 벗어나는 것은 느려야 합니다. 왜냐하면 2초 동안의 평온함은 평온함이 아니라 재장전이기 때문입니다.
type GameState = "menu" | "explore" | "combat";
type Level = "low" | "medium" | "high";
const LEVEL: Record<GameState, Level> = { menu: "low", explore: "medium", combat: "high" };
let current: Level = "medium";
const ENTER_MS = 1500, LEAVE_MS = 8000; // enemies must stick around; calm must be real calm
let pendingSince: number | null = null;
export function tick(state: GameState, now: number) {
const wanted = LEVEL[state];
if (wanted === current) { pendingSince = null; return; }
pendingSince ??= now;
const wait = wanted === "high" ? ENTER_MS : LEAVE_MS;
if (now - pendingSince >= wait) {
current = wanted;
pendingSince = null;
setIntensity(wanted); // fire and forget, never block the frame
}
}
저 임계값들은 표준이 아니라 추측일 뿐이니, 플레이 테스트를 통해 조정해 보세요. 또한 호출 속도에도 제한을 두세요. 버그로 인해 매 프레임마다 상태가 바뀌는 경우, 디렉터가 분당 수백 건의 요청이 발생하는 것을 막아줍니다.
세 가지 강도 조절 단계는 대략적인 다이얼 방식입니다.
우리는 한계를 인정해야 합니다. 세 가지 강도 조절은 차분함, 활동적임, 시끄러움을 제공할 뿐, 12단계의 부드러운 음악 조절을 제공하지 않습니다. 대부분의 인디 게임에서는 세 가지 강도 조절이면 충분합니다.
하지만 디자인에 정말 세밀한 레이어링이 필요하다면, 플레이어가 물속에 있을 때나 대화 아래로 몸을 숙일 때처럼, 자신만의 믹서 효과를 위에 얹으세요. 그런 다음 나머지는 그대로 두세요. API 큰 변화를 처리하는 데 능숙하기 때문입니다.


오프라인으로 출시되는 게임용 사전 생성 음악
스트리밍에는 인터넷 연결이 필요하지만, 게임용 오프라인 음악 파일은 빌드 시점에 게임 파일과 함께 제공되어야 합니다. 콘솔, 비행기, 그리고 호텔 와이파이 상태가 좋지 않은 곳에서는 인터넷 연결이 불가능하기 때문입니다. 따라서 게임 빌드 시점에 음악 파일을 생성하여 게임과 함께 배포하는 것이 좋습니다.
문서의 빠른 시작 가이드에는 요청 내용과 함께 다음 내용이 표시됩니다. loop 이 모드는 바로 이러한 목적으로 존재합니다.
curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" -H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"playlist_index": "PLAYLIST_INDEX", "duration": 30, "format": "mp3", "mode": "loop", "intensity": "medium"}'
다른 모드는 다음과 같습니다. track, jingle mix그리고 소요 시간은 15초에서 25분까지 다양합니다 (이것은 API (페이지에도 해당). 징글은 승리와 죽음의 순간을, 풀 트랙은 보스전을 위해 제작되었으며, 3분짜리 파일에서 페이드 아웃되는 대신 전투 시간만큼 길게 재생됩니다. "음산한 성, 느린 북소리"와 같은 텍스트 프롬프트도 채널 ID를 검색하는 것보다 편리합니다.
다음 네 가지 세부 사항만 알면 리팩토링을 피할 수 있습니다.
- 생성된 링크는 만료됩니다(각 생성마다 만료 기간이 있습니다).
expired_at그러므로 파일을 다운로드하여 커밋하고, 핫링크를 걸지 마세요. - 라이선스에 있는 웹훅을 사용하여 생성이 완료되었는지 알림을 받으세요. 루프를 돌며 확인하는 것보다 훨씬 효율적입니다.
- 편집 종료 지점은 기존 트랙의 강도를 변경하므로, 한 곡의 차분한 버전과 더 복잡한 버전을 얻을 수 있습니다. 크로스페이드를 적용하기 전에 두 버전이 잘 맞는지 귀로 확인하세요.
- 빠른 시작 가이드에서 한 세대를 투자하기 전에 먼저 엄선된 라이브러리를 확인하라고 안내하므로, 먼저 해당 라이브러리를 검색해 보세요.
보스전으로 이어지는 게임 음악 크로스페이드 기능
크로스페이드는 게임 음악에서 가장 오래된 기법 중 하나이며, 보스전 전환에도 이러한 기법이 활용됩니다. 라이브 스트림을 1~2초에 걸쳐 서서히 페이드 아웃시킨 다음, 두 번째 오디오 소스에서 보스 트랙을 시작하고 서서히 페이드 인합니다. 두 플레이어, 한 번의 크로스페이드, 그리고 게임 엔진의 믹서가 이미 이 기능을 제공하고 있습니다.
전투가 끝나면, 이를 되돌리세요. 보스전 배경 음악을 서서히 줄이고 재시작을 호출하여, 문을 열기 전과 같은 멜로디가 다시 재생되지 않도록 하세요.
(여담이지만, 우리는 오후 내내 보스전 음악이 문이 열리는 순간부터 시작해야 할지, 아니면 첫 공격 순간부터 시작해야 할지를 놓고 논쟁을 벌였습니다. 결국 문이 열리는 순간부터 시작하자는 의견이 이겼는데, 플레이어들이 전투를 제대로 즐기려면 잠시 동안의 공포감이 필요하기 때문입니다.)
라이선스 토큰을 플레이어의 기기 위에 올려놓지 마십시오.
게임 음악에서 보안은 지루한 부분이며, 바로 그 점 때문에 주말에 만든 프로토타입이 결국 과태료 부과로 이어지는 것입니다. API 두 개의 디렉토리가 있습니다. 예배 엔드포인트는 귀하의 것을 사용합니다. company-id license-token그리고 그것이 바로 귀사가 라이선스와 고객을 관리하는 방식입니다. 공공 영역 엔드포인트는 다음을 사용합니다. customer-id access-token그리고 그것이 음악을 재생하는 장치입니다.
라이선스 토큰은 서버에만 저장되고 다른 곳에는 저장되지 않습니다. 백엔드 시스템은 서비스 엔드포인트를 통해 고객(모델에 따라 플레이어당 또는 설치당 한 명)을 등록하고 클라이언트에게 공개 자격 증명을 제공합니다. 누군가 빌드를 디컴파일하더라도 회사 계정이 아닌 특정 고객의 음악 접근 권한만 얻게 됩니다.
동일한 백엔드는 또한 만들기에 좋은 장소입니다. get-link 디렉터 섹션에서 호출, 채널 ID 캐시 및 속도 제한을 적용할 수 있습니다. 이러한 선택 사항에 대한 자세한 내용은 다음에서 다룹니다. 음악을 작곡하기 전에 내려야 할 다섯 가지 결정 사항 API 암호캐싱이 스트리밍보다 나은 경우를 포함하여.
판매하는 게임에 사용할 음악 라이선스 취득
무료 에셋 팩은 게임잼에는 사용할 수 있지만, 게임용 상업용 음악은 상업적 출시를 보장하는 라이선스가 필요합니다. 기술적인 부분은 간단하지만, 라이선스 문제는 변호사의 도움을 받아야 하는 부분입니다.
그러니 면허증을 꼼꼼히 읽어보세요. API 그 위에 무엇을 구축하기 전에, 문서의 첫 번째 단계는 GET 요청을 보내는 것입니다. service/licenses이 함수는 활성화된 기능(트랙, 텍스트 음악 변환, 이미지 음악 변환, 스트리밍), 허용된 모드, 최대 트랙 재생 시간 및 남은 할당량을 반환합니다. streaming 해당 목록에 없는 항목으로 인해 적응형 점수가 매우 확신에 찬 메뉴 루프가 되었습니다.
용량 및 권한은 플랜에 따라 조정됩니다. Mubert해당 사용 사례 페이지에는 라이선스 범위가 명시되어 있습니다. 월 100~30,000회 이용권 및 스트리밍 시간일부 등급에는 서브라이선싱과 같은 추가 혜택이 포함됩니다. 계획 페이지 또한 서브라이선스 및 배포를 기능으로 나열합니다. API 해당 페이지에서 체험판은 테스트용 등급으로 설명되어 있으며, 정식 제품으로 전환할 경우 서브라이선스가 적용됩니다. 가격은 변동될 수 있으므로 정확한 가격은 안내해 드리지 않고 실시간 가격 페이지를 확인해 주세요.
플레이어가 음악을 내보내거나 공유할 수 있는 경우, 예를 들어 사용자가 만든 음악 트랙을 저장하는 레벨 에디터의 경우 서브라이선싱이 중요합니다. 음악 서브라이선싱 에 대한 쉬운 설명은 저희 가이드에서 확인하실 수 있습니다. 하지만 실제로 적용되는 범위는 이 블로그의 내용이 아니라 가입하신 플랜에 따라 달라집니다.
그리고 인트로에 나오는 반복 재생되는 세 곡은요? 하나는 남겨두세요. 훌륭한 일시 정지 메뉴가 될 거예요.
적응형 게임 점수 시스템을 처음 사용할 때 참고할 체크리스트
- 게임의 상태 테이블을 작성하세요. 각 상태, 에너지 레벨, 스트림 또는 파일 이름을 명시하십시오.
- 게임플레이 후크를 작성하기 전에 라이선스 엔드포인트를 호출하여 스트리밍, 모드 및 할당량을 확인하십시오.
- 라이선스 토큰을 백엔드로 옮기고 플레이어를 고객으로 등록하세요.
- 하나의 스트림을 프로토타입으로 구현하세요
set-intensity탐험과 전투에 최적화되어 있다. - 느린 종료 디바운싱과 통화 횟수 제한이 있는 음악 감독 기능을 추가하세요.
- 메뉴 루프, 스팅어 및 보스 트랙을 미리 생성한 다음 파일을 다운로드하고 커밋합니다.
- 라이브 스트림과 보스 트랙 사이에 크로스페이드를 하나 만들고, 문 트리거를 사용하여 테스트해 보세요.
- 음악 내보내기 기능을 추가하기 전에 플랜의 하위 라이선스 및 배포 약관을 읽어보세요.



