XRCylinderLayer

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

WebXR 裝置 API 的 XRCylinderLayer 介面是一個在虛擬環境中佔據彎曲矩形空間的層。只有層的正面可見。

XRCylinderLayer 要求為 XRSession 啟用 layers 功能。你可以在 XRSystem.requestSession() 中請求它。

要建立新的 XRCylinderLayer,請呼叫以下任一方法:

  • XRWebGLBinding.createCylinderLayer(),用於建立 WebGL 不透明紋理層;或者
  • XRMediaBinding.createCylinderLayer(),用於建立 HTML <video> 播放層。

要將圖層呈現給 XR 裝置,請使用 XRSession.updateRenderState() 將它們新增到 layers 渲染狀態中。

EventTarget XRLayer XRCompositionLayer XRCylinderLayer

例項屬性

繼承其父介面 XRCompositionLayer 的屬性。

XRCylinderLayer.aspectRatio Experimental

一個數字,表示可見圓柱體部分的比例。它是可見圓柱體部分寬度與其高度的比率。寬度透過將 radius 乘以 centralAngle 來計算。

XRCylinderLayer.centralAngle Experimental

一個數字,表示圓柱體可見部分的弧度角。

XRCylinderLayer.radius Experimental

一個數字,表示圓柱體的半徑。

XRCylinderLayer.space Experimental

一個 XRSpace,表示該圖層與使用者物理環境的空間關係。

XRCylinderLayer.transform Experimental

一個 XRRigidTransform,表示相對於 space 的偏移和方向。

例項方法

繼承其父介面 XRCompositionLayerEventTarget 的方法。.

事件

redraw Experimental

當層的底層資源丟失或 XR 合成器無法再重投影該層時,會發送到 XRCylinderLayer 物件。如果傳送此事件,作者應在下一個 XR 動畫幀中重繪該層的內容。

規範

規範
WebXR Layers API Level 1
# xrcylinderayertype

瀏覽器相容性

另見