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

浏览器兼容性

另见