# 공식 자료와 구현 결정

확인일: 2026-11-16. 런타임 Three는 **r170 고정**입니다. 최신 Three의 WebGPU/TSL 예제를 r170 WebGL 프로젝트와 섞지 않습니다. 아래는 구현 판단에 사용한 1차 자료입니다.

| 자료 | 확인 내용 / 실제 적용 |
|---|---|
| [Three r170 WebXR basics](https://github.com/mrdoob/three.js/blob/r170/manual/en/webxr-basics.html) | WebXR 활성화, XR animation loop, HMD가 camera pose/projection을 결정. HTTPS로 다른 기기에서 접속. 일반 requestAnimationFrame 게임 카메라를 XR에 강제로 적용하지 않음 |
| [Three r170 pointing / controllers](https://github.com/mrdoob/three.js/blob/r170/manual/en/webxr-point-to-select.html) | target-ray와 grip 용도 구분. 무기는 target-ray 방향, 반대손 글러브는 grip 사용 |
| [Three r170 WebXRManager](https://github.com/mrdoob/three.js/blob/r170/docs/api/en/renderers/webxr/WebXRManager.html) | getController, getControllerGrip, XR ArrayCamera, local-floor, framebuffer scale / foveation. 배율은 세션 전에만 설정 |
| [현재 Three WebXRManager 문서](https://threejs.org/docs/pages/WebXRManager.html) | 최신 설명을 교차 확인. 실제 호환성 기준은 위 r170 소스·문서 |
| [WebXR input sources — MDN](https://developer.mozilla.org/en-US/docs/Web/API/XRInputSource) | handedness, targetRaySpace, gripSpace, XR session 안의 gamepad. navigator.getGamepads 대신 session input source |
| [WebXR input guide — MDN](https://developer.mozilla.org/en-US/docs/Web/API/WebXR_Device_API/Inputs) | target ray −Z 방향, 장치별 입력 유효성. unsupported gamepad는 이동시키지 않음 |
| [Meta controller / WebXR mapping](https://developers.meta.com/vr/documentation/web/webxr-pro-controller/) | xr-standard trigger 0, squeeze 1, thumbstick 3, face buttons 4/5, stick axes 2/3. X/A jump, Y/B/L3 slide를 명시 매핑 |
| [Meta WebXR performance hub](https://developers.meta.com/vr/documentation/web/webxr-perf/) | 성능은 실기기에서 재현 가능하게 측정해야 함. 에뮬레이션 결과를 실제 Quest FPS로 보고하지 않음 |
| [Meta rendering best practices](https://developers.meta.com/vr/documentation/web/webxr-perf-bp/) | fill rate·텍스처 대역폭·실시간 조명/그림자·투명 overdraw 주의. 작은 배치 수, 단순 셰이딩, 불투명 입자, 후처리 제외 |
| [Meta fixed foveated rendering](https://developers.meta.com/vr/documentation/web/webxr-ffr/) | 주변부 해상도 저하로 fragment 비용 절감. Three setFoveation을 사용하되 실제 layer 지원에 따름 |
| [Meta app framerate control](https://developers.meta.com/vr/documentation/web/webxr-frames/) | supportedFrameRates와 updateTargetFrameRate를 확인한 뒤 요청. Quest 2 기본 주사율을 단정하지 않고 기본 프로필에서 지원 시 72Hz 요청 |
| [Meta WebXR hosting](https://developers.meta.com/vr/documentation/web/web-hosting/) | HTTPS 정적 호스팅·장치 브라우저 접속·실기기 확인. 정적 dist를 제공하고 사이트 계정에 자동 게시하지 않음 |
| [Meta Quest Browser capabilities](https://developers.meta.com/vr/documentation/web/browser-specs/) | 버전·기기별 기능 차이. isSessionSupported / supportedFrameRates / optional haptics를 런타임 확인 |
| [Meta IWER repository](https://github.com/meta-quest/immersive-web-emulation-runtime) | 개발용 Quest 2/3 preset, 양안 세션·컨트롤러·추적 변경 테스트. **배포 의존성이 아님** |
| [IWER getting started](https://meta-quest.github.io/immersive-web-emulation-runtime/getting-started.html) | 런타임 에뮬레이션과 외부 입력 방법. 설치한 2.8.0의 타입/소스에서 installRuntime({forceInstall:true}), updateButtonValue, updateAxis API를 함께 확인 |

Meta의 성능 문서는 권장 방향이며 개별 장면의 속도 보증이 아닙니다. 기본 프로필의 수치와 per-eye 셰이더 조정, 실루엣 내부 잉크는 이 데모의 설계 판단입니다. 공식 Three/Meta가 이 게임의 성능·호환성을 인증한 것으로 해석하면 안 됩니다.

Cloudflare 준비에서 추가 확인: [Workers Static Assets 구성](https://developers.cloudflare.com/workers/static-assets/binding/), [정적 파일 헤더](https://developers.cloudflare.com/workers/static-assets/headers/), [배포 시작](https://developers.cloudflare.com/workers/static-assets/get-started/), [Cloudflare Drop의 ZIP 업로드·Claim](https://developers.cloudflare.com/changelog/post/2026-07-08-cloudflare-drag-and-drop/). Wrangler 4.162.0을 고정하고 실제 계정 배포 없이 dry-run과 로컬 Workers 런타임을 검사합니다.

원작 음원은 새 인터넷 다운로드가 아니라 사용자가 이미 수집한 `mm3/runtime-validated` 묶음입니다. 사용자의 2026-11-16 지시에 따라 오디오와 manifest만 복사했습니다. 기존 출처·변환·루프·권리자 정보는 새 `assets/audio/`에도 보존합니다.
