VRDisplay: depthNear 屬性

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

VRDisplay 介面的 depthNear 屬性用於獲取和設定定義 VRDisplay 視錐體的近平面(即場景最近的可視邊界)的 z 深度。

注意:此屬性是舊的 WebVR API 的一部分。它已被 WebXR Device API 取代。

通常你應該保持預設值不變,但如果你想在較慢的計算機上提高效能,並且/或者你的 UI 在近邊界稍微遠一點時更合理,你可能希望增加該值。

一個雙精度浮點數,表示以米為單位的 z 深度;其初始值為 0.01

示例

js
let vrDisplay;

navigator.getVRDisplays().then((displays) => {
  vrDisplay = displays[0];
  vrDisplay.depthNear = 1.0;
  vrDisplay.depthFar = 7500.0;
});

規範

此屬性是舊的 WebVR API 的一部分,已被 WebXR Device API 取代。它已不再是標準的開發方向。

在所有瀏覽器都實現新的 WebXR API 之前,建議依靠 A-FrameBabylon.jsThree.js 等框架,或 polyfill 來開發可在所有瀏覽器上執行的 WebXR 應用程式。有關更多資訊,請閱讀 Meta 的從 WebVR 移植到 WebXR 指南。

瀏覽器相容性

另見