GM 오락실
← 프로젝트 회고 · Frontend
RETROSPECTIVE · 회고

그림이 하나씩 붙던 게임 화면: 다 받은 뒤에 여는 공통 로딩 화면

Frontend

격투·포커·디펜스·리듬게임은 그림과 소리 파일이 많다. 빠른 인터넷에서는 티가 안 났지만, 느린 연결에서는 게임 화면이 먼저 뜨고 캐릭터, 배경, 버튼 그림이 하나씩 늦게 붙었다. 효과음도 처음 몇 번은 늦게 났다. 게임마다 따로 고치지 않고, 게임에 쓰는 그림·소리를 다 받은 뒤에 화면을 여는 로딩 화면을 공통 컴포넌트로 만들었다.

할 일 목록 하나로 다 받기

로딩 화면에는 '할 일' 목록을 넘긴다. 할 일 하나가 진행률 한 칸이다.

  1. 그림 주소: Image로 받고 decode()까지 기다린다. 받기만 하고 디코드를 안 하면 화면에 처음 그릴 때 끊긴다. 디코드한 그림은 배열에 붙잡아 두어 메모리 캐시에서 빠지지 않게 했다.
  2. 소리 등 그 밖의 주소: fetch로 받아 HTTP 캐시에 넣어 둔다. 게임이 나중에 같은 주소를 요청하면 바로 온다.
  3. 함수: 게임 자체 로더를 부른다. 격투의 스프라이트 시트나 효과음 디코드처럼 게임 안 캐시까지 채워야 하는 것들이다. 주소만 미리 받으면 HTTP 캐시는 차지만, 게임이 쓰는 형태(잘라 둔 시트, 디코드한 소리)는 여전히 처음 쓸 때 만들어진다.
<GameLoader tasks={menuTasks} title="PIXEL FIGHT" className="aspect-video w-full">
<게임 />
</GameLoader>

// 할 일 = 주소 또는 함수
const tasks = [
"/fight/bg/title.webp", // 그림: 받고 decode까지
keyed("fight:sheet:kai", () => loadSheet("kai")), // 게임 자체 로더
fontTask("1em Jua"), // 글꼴
];

실패한 것도 '끝남'으로 센다. 그림 하나가 404라고 로딩 화면에서 멈추면 안 되고, 없는 그림은 원래 게임이 알아서 처리하고 있었다. 동시에 6개씩 받는다. 새 게임이나 새 에셋을 넣을 때는 그 게임의 목록에도 꼭 넣는 걸 규칙으로 정했다.

다시 들어올 때 깜빡이지 않게

이미 다 받은 게임에 다시 들어올 때도 로딩 화면이 한 번 번쩍이면 오히려 거슬린다. 두 가지를 넣었다.

  1. 받은 주소를 기억하고, 함수는 keyed()로 이름을 붙여 끝난 것을 기억한다. 목록이 전부 끝난 것들이면 처음부터 '준비됨' 상태로 시작해서 로딩 화면 없이 바로 게임을 그린다.
  2. 로딩 화면은 150ms가 지나야 보인다. 그 전에 끝나면 진행률 화면 없이 같은 크기의 빈 칸만 잠깐 있다가 게임이 뜬다.

이름을 일부러 안 붙인 함수도 있다. 격투는 메뉴가 뜬 뒤 고른 캐릭터 시트와 맵 배경을 진행률 없이 뒤에서 받아 두는데, 판이 시작되면 남은 건 건너뛴다. 온라인 대전 중에 회선을 쓰지 않으려는 것이다. 이걸 이름 붙여 기억하면 건너뛴 것까지 '받은 것'이 되어 버린다.

영영 못 들어가는 일은 없게

15초가 지나면 '연결이 느려요 · 받은 것부터 시작' 버튼이 나온다. 파일 하나가 끝없이 안 오는 경우에도 게임에는 들어갈 수 있어야 했다.

처음 한 번, 게임 중간에 한 번 더

처음에 전부 받으면 휴대폰에선 너무 오래 걸린다. 격투만 해도 캐릭터 시트와 스킨을 합치면 15MB가 넘는다. 그래서 문을 두 단계로 나눴다. 처음 들어올 때는 첫 화면에 필요한 것만, 그다음은 판·테이블·곡에 들어가는 순간에 그 판에 필요한 것만 받는다. 중간 로딩도 같은 모양의 진행률 화면을 쓴다.

게임처음 들어올 때중간에
격투타이틀·캐릭터 선택 그림·맵 작은 그림·효과음·글꼴 (약 2.5MB)판 시작: 두 선수 시트·그림 효과·컷인·맵 배경. 다 받을 때까지 판이 멈춰 있다
포커타이틀 첫 장면·로고, 로비 그림·효과음테이블 입장: 그 방 그림·카드·칩·앉은 캐릭터
리듬게임타이틀·메뉴·곡 재킷·도트 그림·효과음곡 시작: 음원(받은 MB 표시)·그 곡의 배경과 무대
디펜스그림 전부·글꼴·효과음없음

리듬게임 곡은 몇 MB씩 해서 '곡 받는 중 · 받은 양 / 전체 MB'로 받은 만큼을 보여 준다. 곡을 고르면 1.5초짜리 시작 연출이 있어서, 그 안에 다 받으면 진행률 화면은 아예 안 나온다. 디펜스는 배경음악을 목록에서 뺐다. 다섯 곡을 합치면 13MB쯤인데, <audio>는 받으면서 틀 수 있고 그림처럼 늦게 붙는 티도 안 난다.

포커: 90MB를 다 받지 않기

포커는 캐릭터 그림이 전부 합쳐 90MB쯤 된다. 다 받을 수는 없어서 지금 화면에 나오는 것만 받는다. 로비에선 내 캐릭터 전신과 캐릭터 고르기 그림, 테이블에선 그 테이블에 앉은 캐릭터와 곧 앉을 나. 로비에 있는 동안엔 테이블 공통 그림과 내 캐릭터의 테이블 그림을 진행률 없이 미리 받아 둬서 테이블 로딩을 줄였다.

로비의 대기 영상(움직이는 webp)은 캐릭터마다 1~4MB라 기다리지 않는다. 전신 그림이 영상의 첫 장면과 같은 자세라서, 그림이 먼저 깔려 있다가 영상이 받아지는 대로 이어받아도 티가 안 난다.

글꼴은 영문 조각만 받고 있었다

글꼴도 할 일에 넣었다. CSS @font-face는 글자가 실제로 쓰일 때까지 파일을 안 받아서, 게임이 뜬 뒤에 글자 모양이 바뀌었다. document.fonts.load(font)로 미리 부르면 될 줄 알았는데 한글은 여전히 늦게 바뀌었다.

한글 웹폰트는 unicode-range로 글자 범위별 조각 파일로 나뉘어 있다. load()는 두 번째 인자로 받은 글자가 든 조각만 받는데, 글자를 안 주면 공백 하나가 기준이라 영문 조각만 받고 끝난다. 자주 쓰는 한글을 같이 넘겨서 해결했다.

const FONT_SAMPLE = "가나다라마바사아자차카타파하게임시작로딩중랭킹설정친구선택확인취소ABCabc0123456789";
document.fonts.load(font, FONT_SAMPLE);

테스트에서 본 가짜 증상

Playwright로 느린 연결을 흉내 내 확인하다가, 로딩이 끝났는데도 그림이 늦게 붙는 듯한 장면을 봤다. 원인은 테스트 쪽이었다. Playwright는 요청 가로채기(route)를 쓰면 브라우저의 HTTP 캐시를 끈다. 로딩 화면이 받아 둔 파일도 게임이 다시 요청할 때마다 네트워크로 새로 받으니, 실제로는 없는 문제가 보였던 것이다.

서버도 캐시를 안 시키고 있었다

Next.js는 public/ 폴더 파일에 max-age=0을 붙여 보낸다. 다시 들어올 때마다 파일마다 서버에 '바뀌었냐'고 물어보니, 느린 연결에서는 받은 적 있는 게임도 로딩이 길었다. 배포 서버에서만 게임 그림·소리 폴더에 캐시 헤더를 붙였다.

async headers() {
if (process.env.NODE_ENV !== "production") return [];
return [{
source: "/:dir(fight|poker|defense|rhythm|sketch)/:path*",
headers: [{ key: "Cache-Control", value: "public, max-age=3600, stale-while-revalidate=604800" }],
}];
}

1시간은 그대로 쓰고, 그 뒤 7일까지는 갖고 있던 걸 바로 쓰면서 뒤에서 새로 받는다. 그림을 바꾸면 다음 방문부터 보인다. 로컬 개발 중엔 그림을 바꾸면 바로 보여야 해서 기본값 그대로 뒀다.

배운 점

  1. '받았다'와 '바로 그릴 수 있다'는 다르다. decode, 게임 안 캐시, 글꼴 조각까지 채워야 첫 화면이 깨끗하다.
  2. 로딩 화면은 보여 주는 것만큼 안 보여 주는 것도 중요하다. 다시 들어왔을 때 0.15초짜리 로딩 화면은 깜빡임일 뿐이다.
  3. 전부 받기와 필요한 것만 받기 사이의 선은 게임마다 다르다. 첫 화면, 판 시작, 뒤에서 미리 받기로 나누니 휴대폰에서도 버틸 만해졌다.
  4. 테스트 도구가 환경을 바꾸는지도 확인해야 한다. 캐시가 꺼진 테스트는 캐시 문제를 만들어 낸다.
Gunmo Lee
since 2021.07
그림이 하나씩 붙던 게임 화면: 다 받은 뒤에 여는 공통 로딩 화면 | GM 오락실