탭을 옮겨도, 다른 화면으로 가도 계속 나던 게임 소리: 소리 API를 한 번에 감싸기
게임을 하다가 메뉴에서 다른 페이지로 넘어가도 그 게임의 배경음악이 계속 났다. 이 사이트는 Next.js라 페이지를 옮겨도 문서가 새로 열리지 않는다. 게임 화면 컴포넌트는 사라지지만, 모듈에 만들어 둔 AudioContext와 <audio>는 그대로 살아서 소리를 낸다.
더 이상한 경우도 있었다. 다른 페이지에 있다가 탭을 잠깐 옮겼다 돌아오면, 이미 떠난 게임의 배경음악이 다시 시작됐다.
원인: 게임마다 있는 '탭이 돌아오면 다시 틀기'
포커와 디펜스 같은 게임은 탭을 가리면 소리를 멈추고 돌아오면 다시 트는 처리를 각자 갖고 있었다. 이 처리는 '지금 이 게임 화면에 있나'를 보지 않는다. 문서 전체의 visibilitychange에 걸려 있으니, 게임을 떠난 뒤에도 탭이 돌아올 때마다 불렸다.
게임마다 고치지 않은 이유
소리 코드는 게임마다 따로 짰다. 게임마다 '화면을 떠나면 멈추기'를 넣으면 지금은 고쳐져도, 다음 게임에서 또 빠뜨린다. 그래서 브라우저 소리 API를 사이트에서 한 번 감싸기로 했다. 게임 코드가 소리 엔진을 만들기 전에 감싸야 해서, 레이아웃에 넣는 컴포넌트 파일이 불리는 순간 바로 설치되게 했다. 감싼 것은 이렇다.
AudioContext: 하위 클래스로 바꿔 끼워 새로 만들어지는 엔진을 전부 등록한다.webkitAudioContext도 같이.AudioContext.prototype.resume·suspendHTMLMediaElement.prototype.play·pauseAudioScheduledSourceNode.prototype.start
소리마다 주인 화면을 붙인다
규칙은 하나다. 소리 엔진과 <audio> 하나하나에 만들어질 때의 화면을 '주인'으로 적는다. 주인은 /games/xxx까지만 보고, 게임 밖은 전부 /다. 소리는 탭이 보이고 지금 화면이 주인일 때만 난다.
화면을 옮기거나 탭이 가려지면 주인이 아닌 소리를 전부 멈추고, 돌아오면 다시 튼다. 게임이 화면 밖에서 resume()이나 play()를 부르면 실제로는 아무것도 하지 않고 성공한 약속만 돌려준다. 게임은 소리를 켰다고 믿고, 주인 화면으로 돌아오면 그때 진짜로 켜진다.
내가 멈춘 것만 되돌린다
'돌아오면 전부 다시 켜기'를 하면 게임이 일부러 멈춘 소리까지 켜 버린다. 그래서 두 가지를 따로 적었다.
- 게임이 바라는 상태(intent): 게임이 부른 suspend·resume 기준
- 지킴이가 멈춰 둠(held): 지킴이가 멈춘 것만 표시
돌아올 때는 held인 것만, 그리고 게임이 바라는 상태가 재생일 때만 다시 켠다. 게임이 직접 suspend나 pause를 부르면 held를 지워서 다시는 건드리지 않는다. <audio>는 나오던 중에 멈춘 것은 이어서 틀고, 화면 밖에서 막힌 play()는 반복 곡(loop)일 때만 다시 튼다.
게임 처리가 먼저 돌게 한 박자 늦게
탭이 돌아올 때 게임의 visibilitychange 처리와 지킴이 처리가 둘 다 불린다. 지킴이가 먼저 돌면 그 뒤에 게임이 상태를 또 바꾼다. 그래서 지킴이는 visibilitychange를 받으면 setTimeout(0)으로 한 박자 늦게 돈다. 게임이 먼저 suspend·resume을 부르고 나면, 그 결과를 보고 최종 상태를 맞춘다.
여러 게임이 같이 쓰는 효과음 엔진
한 소리 엔진을 여러 화면이 같이 쓰는 경우가 있었다. 처음 만든 화면이 주인으로 적혀 있으니, 다른 화면에서 버튼 효과음을 내려 하면 '주인이 아님'으로 막혔다. 그래서 사용자가 지금 이 화면에서 방금 누른 직후에 켜는 소리는 이 화면 것으로 다시 붙이게 했다. 멈춰 둔 엔진에서 start()가 불릴 때도 같은 조건이면 깨운다.
'방금 눌렀나'는 브라우저의 navigator.userActivation으로 보면 될 것 같았다. 그런데 이 값은 링크를 누르고 다음 화면으로 넘어간 뒤에도 몇 초 남아 있다. 그러면 게임에서 링크를 누르고 나온 직후, 떠난 게임의 소리가 새 화면 것으로 다시 붙을 수 있다. 그래서 pointerdown·keydown·touchstart를 직접 받아 마지막 입력 시각과 그때의 화면을 적고, 같은 화면에서 1초 안일 때만 인정했다.
배경음악이 두 번 겹쳐 나온 경우
어떤 게임은 화면에 다시 들어오면 배경음악용 <audio>를 새로 만들어 튼다. 지킴이는 떠날 때 멈춰 둔 옛 <audio>를 돌아올 때 이어 트니, 같은 곡이 두 개 겹쳐 나왔다. 그래서 새 <audio>가 같은 주인·같은 주소로 play()를 부르면, 멈춰 둔 옛것은 이어 틀 목록에서 뺐다.
확인한 방법
탭 숨김은 손으로 재현하기 번거롭다. 따로 만든 테스트 페이지에서 visibilityState를 강제로 바꿔 가며 AudioContext와 <audio>의 상태를 확인했고, 실제 사이트에서는 링크로 화면을 옮기는 클라이언트 이동으로 게임을 오가며 소리가 멈추고 이어지는지 봤다.
배운 점
- 같은 버그가 여러 게임에 흩어져 있으면, 하나씩 고치기보다 그 아래 공통 지점에서 막는 게 앞으로 만들 게임까지 지킨다.
- 가로챌 때는 '내가 바꾼 것'과 '원래 코드가 원한 것'을 따로 들고 있어야 한다. 아니면 되돌릴 때 원래 코드의 결정을 덮는다.
- 브라우저가 주는 신호가 내가 원하는 의미와 같은지 확인해야 한다. SPA에서는 '페이지'의 경계가 브라우저가 아는 것과 다르다.