AppleEvent

2026 visionOS 27 WebXR 버벅임: Three.js로 프레임 안정화와 충돌 방지

2026 visionOS 27 WebXR 버벅임: Three.js로 프레임 안정화와 충돌 방지

Safari 26.2부터 visionOS WebXR에 WebGPU 지원이 추가됐습니다. WebKit의 Safari 26.2 변경 사항도 이 범위를 설명하지만, WebGPU 전환이 항상 빨라진다는 뜻은 아닙니다. visionOS 27 WebXR 버벅임의 우선 해법은 고정된 Safari 메모리 한도를 추측하는 것이 아닙니다. 먼저 프레임 시간을 측정하고, 텍스처와 폐기 자원을 줄인 뒤, 드로 콜과 픽셀 부하를 낮추고, 마지막에 기능 감지로 WebGL과 WebGPU를 비교해야 합니다.

이 글은 기존 Three.js 전시 페이지를 Apple Vision Pro WebXR 경험으로 바꾸는 프론트엔드 엔지니어를 위한 내용입니다. Safari와 WebKit의 문제인지, 자산과 렌더링 파이프라인의 문제인지 구분해야 하는 기술 책임자에게도 적합합니다. 안정적인 Mac, Safari, Xcode와 visionOS 시뮬레이터를 확보하기 어려운 원격 팀도 테스트 순서를 참고할 수 있습니다.

같은 버벅임처럼 보여도 측정 층위는 다릅니다

먼저 같은 장면을 일반 웹 페이지, 몰입형 세션, Apple Vision Pro 실기기에서 각각 재현합니다. 기록할 항목은 평균 프레임 시간이 아니라 다음 네 가지입니다.

  • 프레임 시간이 계속 높은지
  • 특정 장면 진입 뒤 긴 프레임이 반복되는지
  • 장시간 실행할수록 자원 사용량이 증가하는지
  • 세션 재진입 뒤 WebGL Context Lost가 발생하는지

일반 페이지에서는 괜찮지만 몰입형 세션에서만 급격히 느려지면 양안 렌더링 면적, XR 프레임버퍼, 후처리 또는 시점별 드로 콜을 의심해야 합니다. 시간이 지날수록 느려지면 Texture, Material, Geometry, RenderTarget, ImageBitmap의 수명 관리가 먼저입니다. 컨텍스트 손실은 단순한 저프레임과 다릅니다. 복구 절차와 자원 재생성까지 별도로 확인해야 합니다.

Safari Web Inspector는 실제 페이지의 콘솔 오류, 메모리 변화, 렌더링 상태를 확인하는 출발점입니다. Apple의 visionOS 검사 안내를 따라 연결 환경을 구성할 수 있습니다. Three.js에서는 renderer.info.render.calls, triangles, programs와 텍스처·기하 수의 변화량을 함께 저장합니다. 로그에는 기기, 운영 체제, 브라우저 버전, 장면 진입 순서와 재현 시점을 남겨야 합니다.

주의: 공식 자료는 모든 기기와 페이지에 공통으로 적용되는 단일 탭별 GPU 메모리 한도를 공개하지 않습니다. 따라서 “Safari의 고정 메모리 벽”은 측정해야 할 가설이지 확정된 원인으로 쓰면 안 됩니다.

텍스처 압축과 해제가 장시간 안정성을 좌우합니다

장면의 파일 크기만 보고 메모리 문제를 판단하면 안 됩니다. 실제 부담은 텍스처의 가로세로 크기, 픽셀 형식, 밉맵 단계, 동시에 GPU에 남아 있는 개수에 따라 달라집니다. 같은 이미지 파일이라도 GPU 업로드 형식과 밉맵 생성 여부가 달라지면 점유량이 달라질 수 있습니다.

KTX2Loader와 Basis Universal은 장치가 지원하는 압축 텍스처 형식을 선택하는 경로입니다. Three.js의 KTX2Loader 문서처럼 트랜스코더 경로와 지원 형식을 초기화하고, 압축 전후의 실제 렌더링 결과와 자원 지표를 비교해야 합니다. KTX2를 사용했다는 사실만으로 충돌이 사라졌다고 결론 내리면 안 됩니다. 브라우저가 해당 형식을 그대로 사용했는지 확인해야 합니다.

const loader = new KTX2Loader()
  .setTranscoderPath('/basis/')
  .detectSupport(renderer);

const texture = await loader.loadAsync('/assets/scene.ktx2');
material.map = texture;

장면을 나갈 때는 참조를 제거하는 것만으로 부족합니다. Three.js의 객체 해제 안내처럼 텍스처, 재질, 기하, 렌더 타깃을 각각 순회해 dispose()를 호출해야 합니다. ImageBitmap을 만들었다면 사용이 끝난 뒤 close()도 확인합니다.

function releaseMesh(mesh) {
  mesh.geometry?.dispose();

  const materials = Array.isArray(mesh.material)
    ? mesh.material
    : [mesh.material];

  for (const material of materials) {
    for (const key of ['map', 'normalMap', 'roughnessMap', 'metalnessMap']) {
      material[key]?.dispose();
    }
    material.dispose();
  }
}

반복해서 장면에 들어갔다 나오는 테스트에서 renderer.info의 텍스처와 기하 수가 기준선으로 돌아오지 않으면 누수를 의심합니다. RenderTarget은 후처리 체인과 함께 남기 쉽습니다. Three.js 렌더 타깃 설명을 참고해 교체 시점과 폐기 시점을 한곳에서 관리해야 합니다.

첫 번째 비교: 드로 콜을 줄이는 장면과 픽셀을 줄이는 장면

renderer.info.render.calls가 높고 삼각형 수보다 프로그램 수와 독립 오브젝트 수가 빠르게 늘면 CPU 제출 비용이 병목일 가능성이 큽니다. 반복되는 동일 메시에는 InstancedMesh를 우선 검토합니다.

const mesh = new THREE.InstancedMesh(
  geometry,
  material,
  transforms.length
);

const matrix = new THREE.Matrix4();

transforms.forEach((transform, index) => {
  matrix.compose(transform.position, transform.quaternion, transform.scale);
  mesh.setMatrixAt(index, matrix);
});

mesh.instanceMatrix.needsUpdate = true;
scene.add(mesh);

정적 자산은 배치 처리나 기하 병합을 검토할 수 있습니다. 다만 모든 메시를 합치면 개별 가시성 제어와 충돌 판정이 어려워집니다. 다음 요소도 별도로 기록해야 합니다.

  • 투명 재질의 겹침 순서
  • 재질 전환 횟수
  • 동적 그림자와 그림자 맵 갱신
  • 매 프레임 생성되는 객체와 배열
  • 애니메이션 계산량
  • 레이캐스팅 대상 수

드로 콜을 줄였는데도 프레임 시간이 그대로라면 GPU 픽셀 부하가 남았을 수 있습니다. 양안 장면에서는 렌더링 면적이 커지고, 투명 레이어와 후처리 패스가 겹치면 비용이 더 커집니다. 이때는 모델 파일 용량보다 devicePixelRatio, 안티앨리어싱, 그림자 해상도, 블룸과 색 보정 패스를 먼저 끄고 단일 항목 대조 테스트를 진행합니다.

두 번째 비교: 영구 저화질과 조건부 동적 화질

모든 기기의 화질을 처음부터 낮추는 방식은 안전하지만 제품 품질을 불필요하게 제한합니다. 반대로 프레임 시간이 특정 기준을 넘을 때만 단계적으로 낮추면 여유가 있는 장치에서는 선명도를 유지할 수 있습니다.

동적 화질은 다음 순서가 안전합니다.

  • 프레임 시간과 긴 프레임 빈도를 일정 구간 기록합니다.
  • 후처리를 하나씩 끕니다.
  • 그림자와 투명 효과를 다음 단계에서 줄입니다.
  • 마지막에 렌더링 비율을 낮춥니다.
  • 회복 구간에서는 즉시 원복하지 않고 안정성을 다시 확인합니다.
const quality = {
  budget: frameBudget,
  level: 0
};

function updateQuality(frameTime) {
  if (frameTime > quality.budget) {
    quality.level = Math.min(quality.level + 1, qualitySteps.length - 1);
  } else if (frameTime < quality.budget * recoveryFactor) {
    quality.level = Math.max(quality.level - 1, 0);
  }

  applyQualityStep(qualitySteps[quality.level]);
}

위 코드의 frameBudget, recoveryFactor, qualitySteps는 프로젝트의 측정값으로 정해야 합니다. 임의의 프레임 수치를 모든 Vision Pro 장치에 적용하면 안 됩니다. 한 번에 여러 설정을 바꾸면 원인과 효과를 구분할 수 없으므로, 변경 로그에 항목과 이전 값을 남겨야 합니다.

Vision Pro Safari에서 Three.js가 갑자기 느려지는 원인은 무엇입니까?

장면 진입 직후 하락하면 XR 프레임버퍼, 후처리, 그림자와 같은 렌더링 비용을 확인합니다. 일정 시간 뒤 하락하면 자원 해제와 이미지 디코딩 큐를 확인합니다. 특정 모델에서만 하락하면 텍스처 형식, 투명 재질, 애니메이션 본 수와 레이캐스팅 대상을 분리해 봅니다.

Safari 27에서는 일부 WebXR 시점과 시뮬레이터 관련 문제가 수정된 것으로 안내됐지만, 이 사실이 모든 페이지의 성능을 보장하지는 않습니다. Safari 기술 프리뷰 변경 기록을 확인한 뒤, 실제 배포 버전과 실기기에서 다시 검증해야 합니다.

WebGL Context Lost와 KTX2·Basis Universal은 어떻게 확인합니까?

컨텍스트 손실이 발생하면 우선 다음을 확인합니다.

  1. 반복 진입 테스트에서 텍스처와 렌더 타깃 수가 계속 증가하는지 확인합니다.
  2. 큰 텍스처가 동시에 업로드되는 순간을 기록합니다.
  3. 장면 교체 시 dispose()와 ImageBitmap.close()가 호출되는지 확인합니다.
  4. 손실 이벤트 뒤 렌더러와 자원을 재생성할 수 있는지 확인합니다.
  5. 압축 텍스처가 실제 지원 형식으로 로드됐는지 확인합니다.

KTX2와 Basis Universal은 자원 압력을 낮출 가능성이 있지만, 장면의 모든 문제를 해결하는 만능책은 아닙니다. 압축 해제 과정, 트랜스코더 파일 경로, 지원 형식 감지 실패도 함께 검사해야 합니다.

WebGL과 WebGPU 중 어느 쪽을 선택해야 합니까?

Safari 26.2 이후 visionOS WebXR에서 WebGPU 경로를 시험할 수 있습니다. 그러나 WebGPU가 자동으로 더 빠르다고 말할 수는 없습니다. WebGPURenderer는 셰이더 작성 방식과 후처리 구조에 영향을 줍니다. 사용자 정의 ShaderMaterial, onBeforeCompile, 기존 후처리 패스가 있다면 이식 비용부터 산정해야 합니다. Three.js WebGPURenderer 안내를 기준으로 지원 범위를 확인합니다.

Metal은 웹 코드가 직접 선택하는 일반적인 하위 백엔드 스위치가 아닙니다. WebGL과 WebGPU를 Metal로 수동 전환하는 식의 구현은 피해야 합니다.

기능 감지 기반 선택은 다음처럼 구성합니다.

const canUseWebGPU =
  typeof navigator.gpu !== 'undefined' &&
  rendererCapabilities.webgpuPipelineReady;

const renderer = canUseWebGPU
  ? await createWebGPURenderer()
  : createWebGLRenderer();

실제 코드에서는 사용자 에이전트 문자열이 아니라 필요한 기능, 셰이더 경로, 후처리 지원 여부를 검사해야 합니다. WebGPU 초기화 실패, 필수 기능 부재, 회귀 테스트 실패 시 WebGL로 돌아가는 경로를 남겨야 합니다.

결정 조건: 어느 경로로 회귀 테스트를 진행할까요?

  • 텍스처 수와 자원 수가 반복 진입마다 증가한다면
    먼저 자원 해제와 장면 수명 관리를 수정합니다. WebGPU 전환은 뒤로 미룹니다.

  • 드로 콜과 프로그램 수가 높고 CPU 사용이 두드러진다면
    InstancedMesh, 정적 배치, 재질 그룹화를 적용합니다. 투명 재질과 그림자도 별도로 비교합니다.

  • 드로 콜은 낮지만 프레임 시간이 픽셀 효과와 함께 증가한다면
    후처리, 그림자, 렌더링 비율을 단계적으로 낮춥니다.

  • WebGL만 실패하고 기능 감지와 셰이더 변환이 완료됐다면
    WebGPU를 별도 실험군으로 검증합니다. 기존 후처리와 사용자 정의 셰이더가 같다는 전제는 두지 않습니다.

  • 시뮬레이터에서는 통과하지만 실기기에서 실패한다면
    시뮬레이터를 성능 인증에 사용하지 않습니다. 실기기에서 장시간 실행, 반복 진입, 컨텍스트 복구를 다시 기록합니다.

비교표로 정리하는 테스트 환경과 승인 기준

항목 시뮬레이터 Apple Vision Pro 실기기
주된 용도 호환성, 화면 흐름, 기본 API 확인 프레임 시간, 발열에 따른 변화, 충돌과 최종 화질 확인
WebGL·WebGPU 비교 초기 회귀 확인 배포 승인에 필요한 최종 비교
자원 누수 검사 반복 흐름의 예비 확인 장시간 실행과 실제 세션 재진입
결론 범위 문제 재현 가능성 제품 성능과 안정성

사이트에 실제 장비와 버전별 측정 기록이 확보되지 않은 상태에서는 특정 Mac 구성, Safari 버전, Xcode 버전, visionOS 시뮬레이터 결과를 임의로 제시하면 안 됩니다. 시뮬레이터는 호환성 사전 점검용으로만 두고, 프레임률과 충돌 승인은 Apple Vision Pro 실기기에서 진행해야 합니다.

승인 순서 확인할 지표 실패 시 되돌릴 조치
자산 예산 텍스처 형식, 동시 상주 수, 밉맵 KTX2 재변환과 자원 분리
장면 제출 드로 콜, 삼각형, 프로그램 수 인스턴싱과 정적 배치
픽셀 부하 그림자, 투명 레이어, 후처리 효과별 단계적 비활성화
장시간 실행 프레임 시간과 자원 수 추세 dispose와 이미지 비트맵 해제
후단 선택 WebGL·WebGPU 기능 감지와 회귀 지원되는 백엔드로 즉시 회귀
최종 확인 실기기 반복 진입과 컨텍스트 손실 배포 보류 후 재현 로그 분석

팀에 장기간 보관할 Mac, Safari, Xcode 버전 조합이 부족하다면 ProxyMac의 도움말 안내와 콘솔 이용 방법을 먼저 확인할 수 있습니다. 클라우드 Mac은 텍스처 변환, 시뮬레이터 사전 점검과 브라우저 회귀 테스트에 적합합니다. 다만 현재 환경의 단점은 실기기 XR 입력과 실제 GPU 거동을 완전히 재현하지 못한다는 점, 원격 연결 지연이 측정에 섞일 수 있다는 점, 장기 실행 중 장비 상태를 직접 통제하기 어렵다는 점입니다. 이런 범위에서는 Mac을 별도로 구매하는 것보다 필요한 기간만 ProxyMac으로 테스트 환경을 확보하는 편이 운영 부담이 낮을 수 있지만, 최종 프레임과 충돌 판정은 반드시 Apple Vision Pro 실기기 기록으로 마무리해야 합니다.

원격 맥에서 웹 삼차원 장면을 안정적으로 점검해 보세요

ProxyMac의 원격 맥 환경에서 웹 삼차원 장면의 화면 흐름과 자원 사용량을 편리하게 확인할 수 있습니다.
그림 자료와 장면 구성을 바꿔 가며 끊김이 발생하는 조건을 반복해서 재현하고 비교할 수 있습니다.