AI Development

2026 visionOS 27 WebXRのカクつき:Three.jsでフレームを安定させクラッシュを防ぐ

2026 visionOS 27 WebXRのカクつき:Three.jsでフレームを安定させクラッシュを防ぐ

SafariでThree.jsのシーンに入った瞬間にフレームが落ち、しばらくするとWebGL Context Lostが出る。

最短の解決策は、先にフレーム時間と資源の増加を測り、次にテクスチャを圧縮して不要なオブジェクトを解放し、その後にDraw Call、ピクセル負荷、後処理を下げることです。最後に機能検出でWebGLとWebGPUを比較し、必ず回退経路を残します。WebGPUへの切り替えだけで速くなるとは判断しません。

この記事は、Apple Vision Pro向けにThree.jsのWebXR体験を作るフロントエンドエンジニア、3Dテクニカルアーティスト、技術責任者向けです。Mac、Safari、Xcode、visionOSシミュレーターを安定して用意できない遠隔チームにも適しています。

※ Last updated:2026年9月16日。バージョン情報はAppleのvisionOS案内、WebKitのSafari 26.2機能説明、Safari Technology PreviewのWebXR関連リリースノートを基に確認しています。

visionOS 27 WebXRのカクつきを測る指標

2026年9月14日にvisionOS 27が提供されました。WebXRはSafari 18.0とvisionOS 2で正式対応し、Safari 26.2ではvisionOSのWebXRにWebGPU対応が追加されています。ただし、Safari 27がすべてのThree.jsページで同じ挙動を示すわけではありません。

Safariがタブ単位で固定されたGPUメモリ上限を持つ、と公式に一般化できる資料はありません。「顕在化したメモリの壁」は、端末、OS、シーン、テクスチャ形式、実行時間を含めて測る仮説として扱います。コミュニティのIssueや個別報告を、Safari全体の仕様とはみなしません。

最初の計測では、次の3条件を分けます。

計測条件 保存する値 判断材料
通常のSafariページ 平均フレーム時間、長いフレーム、コンソール ページ全体やCPU処理の負荷
WebXRの没入モード フレーム時間、描画面積、後処理の有無 双眼描画とピクセル負荷
Vision Pro実機 再現手順、実行時間、Context Lostの発生 実機固有の安定性

Safari Web Inspectorではコンソール、ネットワーク、ページの実行状態を確認できます。visionOSを対象にした接続方法は、AppleのSafari Web Inspector手順で確認できます。

Three.js側ではrenderer.info.render.calls、triangles、programs、textures、geometriesを同じ操作の前後で記録します。平均値だけでは不十分です。没入開始時に一度だけ跳ねるのか、時間とともに増え続けるのかで、原因が変わります。

テクスチャ圧縮と解放処理の分岐

KTX2とBasis Universal

KTX2は、Basis Universalで圧縮したテクスチャをThree.jsへ読み込む一般的な経路です。KTX2Loaderは端末が利用できる圧縮テクスチャ形式を確認し、対応する形式への変換を行います。具体的な初期化方法はThree.jsのKTX2Loaderドキュメントにあります。

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

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

圧縮前後で見るべきなのはファイルサイズだけではありません。次の値を同じシーンで比較します。

  • 読み込み後のrenderer.info.memory.textures
  • mipmapを含むテクスチャの種類と数
  • 没入モードへの移行時間
  • シーン再入場後のメモリカウンター
  • 長時間実行後のContext Lost

圧縮すれば必ずGPU資源が減る、とは限りません。変換後の形式、mipmap、同時に残る古いテクスチャを確認してください。

オブジェクトの寿命

Three.jsでは、シーンからオブジェクトを外すだけではGPU資源が解放されません。Geometry、Material、Texture、RenderTarget、ImageBitmapを所有者ごとに追跡します。

function disposeObject(root) {
  root.traverse((object) => {
    object.geometry?.dispose();

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

    materials.filter(Boolean).forEach((material) => {
      for (const value of Object.values(material)) {
        if (value?.isTexture) value.dispose();
      }
      material.dispose();
    });
  });
}

RenderTargetは画面に表示されていなくてもカラーターゲットや深度バッファを保持します。後処理を切り替える場合は、古いRenderTargetも破棄します。Three.jsのRenderTarget解説とオブジェクト解放の公式マニュアルを基準に実装を確認します。

注意:renderer.infoの数値が完全にゼロへ戻らないケースがあります。内部キャッシュの可能性があるため、単発の値ではなく、同じシーンへの入場と退場を繰り返したときの増加傾向を記録してください。

Draw Callとピクセル負荷の切り分け

GLBのファイル容量が小さくても、独立したMeshやMaterialが多ければCPUからGPUへの提出回数は増えます。callsが多く、trianglesが許容範囲でもフレーム時間が長いなら、オブジェクト数やマテリアル切り替えを疑います。

同じGeometryを多数配置する場合はInstancedMeshを検討します。

const mesh = new THREE.InstancedMesh(geometry, material, count);
const matrix = new THREE.Matrix4();

for (let i = 0; i < count; i++) {
  matrix.setPosition(positions[i].x, positions[i].y, positions[i].z);
  mesh.setMatrixAt(i, matrix);
}
mesh.instanceMatrix.needsUpdate = true;
scene.add(mesh);

静的な部品は、材質が同じならバッチ化やGeometryの統合が候補になります。ただし、透明材質、頻繁なMaterial切り替え、動的シャドウは統合効果を弱めます。アニメーション、毎フレームのレイキャスト、ループ内でのGeometry生成も同時に点検します。

描画面積の負荷は別軸です。devicePixelRatio、アンチエイリアス、シャドウマップ、透明オブジェクト、Bloomなどの後処理を一項目ずつ無効化し、フレーム時間の差を記録します。二眼表示では、画質設定の変更が単眼ページより大きく効く場合があります。

条件分岐で決める画質とバックエンド

固定画質を全端末へ適用するのではなく、フレーム時間を基準に段階的に下げます。急激な変更を避けるため、一定回数のサンプルで判定します。

const quality = {
  high: { pixelRatio: 1.0, shadows: true, post: true },
  mid:  { pixelRatio: 0.8, shadows: false, post: true },
  low:  { pixelRatio: 0.65, shadows: false, post: false }
};

function applyQuality(renderer, composer, level) {
  const q = quality[level];
  renderer.setPixelRatio(q.pixelRatio);
  shadowLight.castShadow = q.shadows;
  composer.enabled = q.post;
}

判断条件は次の順に固定すると、変更の影響を追いやすくなります。

  • フレーム時間が安定し、texturesとgeometriesが増えないなら、現在の画質を維持します。
  • フレーム時間だけが長く、callsとtrianglesが高いなら、InstancedMesh、統合、アニメーション更新を先に見直します。
  • 没入モードでだけ悪化するなら、解像度、影、透明叠加、後処理を一項目ずつ下げます。
  • 時間とともにtexturesやgeometriesが増えるなら、画質変更より先にdispose処理を修正します。
  • WebGPUの機能検出に成功し、自作ShaderMaterial、onBeforeCompile、後処理が検証済みなら比較対象にします。それ以外はWebGLへ回退します。

WebGPURendererは移行時にシェーダー、後処理、Material実装の確認が必要です。Three.jsのWebGPURenderer説明にもある通り、WebGL用コードをそのまま置き換えれば完了する構成ではありません。

WebGLとWebGPUの受け入れ表

WebGPUの判定にユーザーエージェント文字列を使うと、Safariの細かな更新や端末差を取りこぼします。APIと必要な機能を実行時に確認します。

async function selectRenderer(canvas) {
  if ('gpu' in navigator) {
    try {
      const adapter = await navigator.gpu.requestAdapter();
      if (adapter) return 'webgpu';
    } catch (_) {}
  }
  return 'webgl';
}
判定項目 WebGLを優先 WebGPUを比較
既存ShaderMaterial 実装を維持しやすい 移行確認が必要
onBeforeCompile 現行処理を使いやすい 代替実装を検証
後処理チェーン 既存資産を再利用 Passごとの確認
Context Lost対策 解放と回復処理を実装 WebGPU側の失敗経路も記録
性能評価 実機のフレーム時間を基準 同一資産・同一画質で比較

検証順は、資産予算、短時間の描画、長時間実行、シーンの再入場、バックエンド回退、Vision Pro実機回帰です。WebGPUが利用可能でも、CPU更新やテクスチャ解放の問題は自動では消えません。

FAQ:症状別の確認ポイント

Vision ProのSafariでThree.jsが急にカクつく場合

通常ページ、没入モード、実機の3条件を分け、フレーム時間、長いフレーム、calls、triangles、texturesを保存します。没入時だけならピクセル負荷、時間経過で悪化するなら資源解放を優先します。

WebGL Context Lostが出た場合

固定のメモリ上限を前提にせず、KTX2変換後のテクスチャ、RenderTarget、ImageBitmap、再入場後のカウンターを調べます。Safari Web Inspectorのログと再現手順を残し、端末依存の失敗とアプリ側の解放漏れを分離します。

KTX2とBasis Universalを使う場合

ファイル容量だけで成否を決めません。圧縮後の形式、mipmap、GPU資源の残存、長時間実行、再入場を比較します。圧縮テクスチャへ差し替えた後に古いTextureを保持していれば、クラッシュ要因は残ります。

WebGLとWebGPUを選ぶ場合

Safari 26.2以降のWebGPU対応は選択肢を増やしますが、Three.js作品の速度を保証しません。特性検出、Shader、後処理、長時間安定性を同じ資産で比較し、失敗時はWebGLへ戻します。

Vision Proがない場合

シミュレーターではAPIの存在、入出場、コンソールエラー、画面遷移を確認します。実機のフレームレート、発熱、長時間の資源挙動、Context Lostの判定は代替できません。最終受け入れには実機記録が必要です。

実機なしの開発環境と最終検証

Vision Proが常時使えないチームでは、Mac上にSafari、Xcode、visionOSシミュレーターの組み合わせを用意し、Three.jsの固定シーンを毎回同じ手順で起動します。シミュレーターは互換性の事前確認に使い、性能値の合否判定には使いません。

Mac側では、アセット変換、KTX2生成、ソースマップ確認、Web Inspector接続、WebGLとWebGPUのビルド切り替えを自動化します。Safari 27.x、visionOS 27.x、Three.jsのレンダラーが更新された場合は、Context Lost、テクスチャ解放、後処理、再入場の順で再実行します。

チームで作業する場合は、ProxyMacのコンソールで利用環境を確認し、接続や運用上の不明点はProxyMacのヘルプで手順をそろえると、担当者ごとの環境差を抑えられます。

Macを都度用意する方法では、SafariやXcodeの版が揃わない、シミュレーターの状態が残る、アセット変換担当が変わるたびに再現条件が崩れる、という欠点があります。Vision Pro実機も別途必要です。反対に、ProxyMacのMacレンタル環境を資産変換、シミュレーターの事前確認、Safariの回帰作業に割り当てれば、短期の検証環境を保ちやすくなります。ただし、最終的なフレームレートとクラッシュ判定は、Apple Vision Pro実機の記録で確定してください。

WebXRの検証環境をProxyMacで整えませんか

ProxyMacなら、Macを遠隔から利用でき、WebXRのフレームレートや描画負荷を安定した環境で検証できます。
高負荷な3Dコンテンツの動作確認も、手元の端末性能に左右されにくいMac環境で進められます。