AI Development

2026 visionOS 27 WebXR 卡頓:Three.js 如何穩幀並避免崩潰

2026 visionOS 27 WebXR 卡頓:Three.js 如何穩幀並避免崩潰

Safari 26.2 已為 visionOS WebXR 加入 WebGPU 支援,這項能力已由 WebKit 官方說明確認。但這不代表 2026 visionOS 27 WebXR 卡頓只要切換 WebGPU 就會消失。較穩妥的勝出方案是:先量度幀時間,再壓縮紋理並釋放資源,接著降低 Draw Call、像素填充和後處理成本,最後以特性偵測比較 WebGL 與 WebGPU,並保留回退路徑。

這篇適合正在把現有 Three.js 展示頁改造成 Apple Vision Pro WebXR 體驗的前端工程師。
如果團隊需要判斷問題來自資產、渲染管線還是 Safari/WebKit,或缺少穩定的 Mac、Safari 與 visionOS 模擬器測試環境,也適合從本文開始。

更新於 2026 年 9 月 16 日。 版本狀態核對自 Apple 的 visionOS 資訊、WebKit 發布說明與 Three.js 官方文件;Safari 27.x、visionOS 27.x 或 Three.js 渲染器更新後,應重新執行真機驗收。

先比較證據:visionOS 27 WebXR 卡頓究竟是哪一層

不要把所有問題都稱為「Safari 卡頓」。同一個症狀,可能是提交工作過多、GPU 資源持續累積、沉浸模式增加渲染面積,也可能是 WebGL Context Lost。

先建立三組基線:

  • 普通網頁模式:只開啟場景,不進入沉浸式 WebXR。
  • 沉浸模式:記錄進入 session 前後的幀時間和長幀。
  • Apple Vision Pro 真機:用實際裝置重複相同操作,確認模擬器沒有掩蓋視口、追蹤或資源差異。

應保留每次測試的平均幀時間、長幀出現頻率、進入沉浸模式的時間點、重複進出場景的次數,以及錯誤發生前的操作步驟。這些資料比單看「看起來不順」更能區分故障層次。

Vision Pro Safari 執行 Three.js 為何會突然掉幀?
如果 renderer.info.render.calls、triangles 或程式數量在掉幀時同步升高,優先懷疑 CPU 提交和材質切換。如果這些數值沒有明顯改變,但幀時間在進入沉浸模式後突然上升,則應檢查像素填充、雙目渲染、陰影和後處理。若幀時間逐步惡化,並且重複進出場景後仍不回落,資源生命週期更可疑。

Safari Web Inspector 可用來檢查 visionOS 頁面和遠端執行狀態,Apple 的視覺化作業系統檢查工具說明則可作為連線與除錯入口。Three.js 的 renderer.info 適合記錄渲染統計;應用程式自己的日誌則要補上 session 狀態、畫質檔位、後端名稱和錯誤時間戳。

WebXR 出現 WebGL Context Lost 應該先檢查什麼?
先確認是否只在某一個場景、某一種紋理或重複進出 session 後出現。接著檢查紋理、材質、幾何體、RenderTarget 和 ImageBitmap 是否在場景移除時釋放。不要先把它寫成 Safari 的固定顯存限制,因為截至 visionOS 27,Apple 並沒有公布可套用到所有裝置和頁面的單一分頁 GPU 記憶體配額。

第一個取捨:壓縮紋理,還是繼續堆疊原始圖片

紋理的壓力不只取決於檔案下載大小。判斷時至少要拆開四項:

  • 寬度與高度,以及是否為非二次方尺寸。
  • GPU 實際使用的像素格式。
  • Mipmap 是否存在。
  • 同時留在場景中的紋理數量。

因此,不能用一個沒有來源的「固定可用顯存上限」來安排資產預算。應在不同畫質檔位逐項載入,觀察 GPU 資源和幀時間是否同步下降。

Three.js 的 KTX2Loader 可搭配 Basis Universal,將壓縮紋理交給裝置支援的格式處理。官方文件中的初始化方式如下:

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

const texture = await ktx2Loader.loadAsync('/assets/scene_color.ktx2');
material.map = texture;
material.needsUpdate = true;

KTX2 檔案變小,不等於 GPU 記憶體必然按相同比例下降。必須在真機上比較壓縮前後的載入時間、長時間執行狀態和 Context Lost 事件;載入器的能力與限制可參考 Three.js KTX2Loader 官方文件。

KTX2 和 BasisU 能否減少 Vision Pro 網頁場景崩潰?
可以作為降低紋理壓力的候選方案,但不能直接承諾能消除崩潰。若壓縮後只改善下載量,renderer.info 和長時間測試沒有變化,問題可能在 RenderTarget、重複建立 ImageBitmap、過多後處理或未釋放的場景物件。

移除場景時,至少要明確處理以下資源:

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

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

    for (const material of materials) {
      for (const value of Object.values(material)) {
        if (value?.isTexture) value.dispose();
      }
      material?.dispose();
    }
  });
}

RenderTarget 也要單獨釋放。Three.js 的物件釋放指南和 RenderTarget 說明都指出,JavaScript 物件離開作用域,不代表 GPU 資源已經回收。重複進出同一場景後,若 renderer.info.memory 的幾何體或紋理數量只升不降,應先修正生命週期,再談換後端。

第二個取捨:減少 Draw Call,還是只縮小 GLB 檔案

模型檔案體積小,並不代表每幀提交工作少。對 Three.js 場景,應記錄:

  • renderer.info.render.calls:獨立繪製提交的數量。
  • renderer.info.render.triangles:每幀三角形負擔。
  • renderer.info.programs:材質與 Shader 程式切換的線索。
  • 動畫、射線檢測和每幀建立的新物件數量。

對重複幾何體,InstancedMesh 往往比建立大量相同 Mesh 更合理:

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

const transform = new THREE.Object3D();

for (let i = 0; i < instanceCount; i++) {
  transform.position.set(i * 0.4, 0, 0);
  transform.updateMatrix();
  mesh.setMatrixAt(i, transform.matrix);
}

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

靜態物件可評估批次處理或幾何合併,但不能無條件合併。透明材質通常需要特別排序,頻繁切換材質會削弱批次收益,動態陰影則可能增加額外渲染通道。優化後仍要重新檢查可見排序、互動選取和動畫正確性。

若掉幀期間 calls 上升,先處理物件數、材質數和更新迴圈。若 calls 不高但 triangles 很高,應回到幾何細節、LOD 和可見範圍。若兩者都不高,卻因每幀建立 Raycaster、陣列或暫時 Mesh 而令主執行緒繁忙,GPU 優化也不會解決問題。

第三個取捨:清晰度,還是固定最高畫質

雙目 WebXR 場景的像素負擔不能只看桌面瀏覽器的表現。應逐一關閉以下項目,做單因素對照:

  • devicePixelRatio 或渲染比例。
  • 抗鋸齒。
  • 陰影貼圖尺寸和更新頻率。
  • 透明物件疊加。
  • Bloom、景深、色調映射等後處理 Pass。

不要一次把所有效果關掉,否則測試結束後不知道真正有效的是哪一項。更適合交付的做法,是以幀時間驅動畫質檔位:

function updateQuality(frameMs) {
  if (frameMs > 25) {
    renderer.setPixelRatio(Math.max(0.7, renderer.getPixelRatio() * 0.85));
    postProcessingEnabled = false;
  } else if (frameMs < 18) {
    renderer.setPixelRatio(Math.min(window.devicePixelRatio, 1.0));
  }
}

上例的閾值只是產品團隊的初始策略,不是 Apple 或 Safari 的硬性標準。正式版本應以真機量測的幀時間分布決定門檻,並加入冷卻時間,避免畫質在兩個檔位之間來回跳動。陰影、透明疊加和後處理應各自有開關,讓技術負責人能說明每次降級的原因。

WebGL 對 WebGPU:先做條件分支,不要追逐版本名稱

WebXR 在 Safari 18.0 和 visionOS 2 已正式推出;Safari 26.2 起,visionOS WebXR 加入 WebGPU 支援。Safari 27 亦修復了部分 WebXR 視口和模擬器問題,但這些修正不代表每個 Three.js 專案都會自動獲得更高幀率。

visionOS WebXR 應該使用 WebGL 還是 WebGPU?
如果既有專案大量依賴 ShaderMaterial、onBeforeCompile、特定後處理鏈或只在 WebGL 驗證過,先保留 WebGL 會較容易控制風險。若資產、Shader 和後處理已能在 WebGPU 路徑運作,才把 WebGPU 納入真機 A/B 測試。Three.js 的 WebGPURenderer 說明列出的遷移差異,應逐項對照,而不是只修改 Renderer 名稱。

Metal 是 Apple 平台底層圖形 API 的實作方向,不是網頁程式可以直接指定的通用「降級開關」。選擇後端時應使用能力檢測,不要用 User-Agent 猜測:

async function createRenderer(canvas) {
  if (navigator.gpu) {
    try {
      const renderer = new THREE.WebGPURenderer({ canvas });
      await renderer.init();
      return { renderer, backend: 'webgpu' };
    } catch (error) {
      console.warn('WebGPU unavailable, fallback to WebGL', error);
    }
  }

  const renderer = new THREE.WebGLRenderer({
    canvas,
    antialias: true
  });

  return { renderer, backend: 'webgl' };
}

這段分支只能證明環境具備入口,不能證明效能較快。驗收時仍要比較相同資產、相同畫質、相同互動流程下的幀時間、長幀、錯誤和長時間穩定性。

發布前決策:符合條件才切換,否則回退

可用以下條件列表固定團隊判斷,避免把 WebGPU 當成萬用解答:

  • 若紋理壓縮後資源數量可回落、重複進出場景沒有持續增長,則進入 Draw Call 和像素填充優化;否則先修正 dispose 流程。
  • 若calls 明顯偏高,則優先使用 InstancedMesh、批次處理和材質整理;否則檢查三角形、陰影、透明層與後處理。
  • 若普通網頁穩定、沉浸模式才掉幀,則優先降低渲染比例和雙目像素成本;否則檢查資產、動畫與主執行緒更新。
  • 若WebGPU 的自訂 Shader、後處理和互動全部通過真機回歸,且幀時間沒有惡化,則可讓能力檢測通過的裝置使用 WebGPU;否則回退 WebGL。
  • 若只有模擬器通過,則只能視為相容性預檢;最終性能和崩潰驗收必須在 Apple Vision Pro 真機完成。

沒有 Vision Pro 時,可以先使用 Mac、Safari Web Inspector 與 visionOS 模擬器完成 API、視口、載入和錯誤流程檢查。Safari 27 對部分模擬器與 WebXR 問題的修正可參考 WebKit 的相關發布說明。但模擬器不能替代真機的幀率、雙目渲染、追蹤和長時間資源壓力測試。

在團隊缺少固定 Mac 版本矩陣時,可先閱讀 ProxyMac 的支援說明,規劃 Safari、Xcode 和模擬器的遠端測試流程;若需要評估暫時性的 Mac 測試環境,再按 ProxyMac 的方案資訊核對交付條件。這類雲端 Mac 適合資產轉換、模擬器預檢和回歸測試,但不能取代 Apple Vision Pro 真機。

對只依賴 Windows 本機或單一雲端瀏覽器的方案,主要缺點是難以保留 Safari/WebKit 版本矩陣、無法穩定重現 visionOS 模擬器行為,也容易把 WebGL 和 WebGPU 的差異誤判為硬體性能。若目前只是一次性的 Three.js 資產轉換或短期驗收,租用 ProxyMac 的 Mac 環境通常比臨時購置整套測試設備更容易維持版本一致;但長期高負載渲染、需要實體頭戴裝置或必須接駁特殊周邊時,仍應直接配置本地設備與真機測試流程。

用 ProxyMac 遠端 Mac,穩定驗證 WebXR 專案

透過 ProxyMac 租用遠端 Mac,為前端工程師與 3D 團隊提供即時可操作的測試環境。
在接近實際使用情境的環境中檢查幀時間、資源負載與渲染穩定性,及早找出卡頓原因。