XRMediaBinding: createEquirectLayer() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Phương thức createEquirectLayer() của giao diện XRMediaBinding trả về đối tượng XREquirectLayer, là một lớp ánh xạ dữ liệu mã hóa hình cầu đều lên bên trong một hình cầu.

Cú pháp

js
createEquirectLayer(video, options)

Tham số

video

Một HTMLVideoElement để hiển thị.

options

Một đối tượng để cấu hình XREquirectLayer. Đối tượng có thể có các thuộc tính sau và space là bắt buộc:

centralHorizontalAngle Optional

Một số chỉ ra góc ngang trung tâm tính bằng radian cho hình cầu. Giá trị mặc định: 6.28318 (2π).

invertStereo Optional

Giá trị boolean chỉ định liệu vị trí tự nhiên của mỗi khung nhìn trong video có nên bị đảo ngược không. Mặc định là false.

layout Optional

Chuỗi chỉ ra bố cục của video. Các giá trị có thể giống như trong createCylinderLayer. Giá trị mặc định là mono.

lowerVerticalAngle Optional

Một số chỉ ra góc dọc thấp hơn tính bằng radian cho hình cầu. Giá trị mặc định: -1.570795 (-π/2).

radius Optional

Một số chỉ ra bán kính của hình cầu. Giá trị mặc định 0.0.

space Bắt buộc

Một đối tượng XRSpace xác định mối quan hệ không gian của lớp với môi trường vật lý của người dùng.

transform Optional

Một đối tượng XRRigidTransform xác định độ lệch và hướng tương đối với space.

upperVerticalAngle Optional

Một số chỉ ra góc dọc cao hơn tính bằng radian cho hình cầu. Giá trị mặc định: 1.570795 (π/2).

Giá trị trả về

Một đối tượng XREquirectLayer.

Ví dụ

Tạo XREquirectLayer để hiển thị video

js
function onXRSessionStarted(xrSession) {
  const xrMediaBinding = new XRMediaBinding(xrSession);
  const video = document.createElement("video");
  video.src = "just-fascination.mp4";

  const videoLayer = xrMediaBinding.createEquirectLayer(video, {
    space: xrReferenceSpace,
  });

  xrSession.updateRenderState({
    layers: [videoLayer],
  });
}

Thông số kỹ thuật

Specification
WebXR Layers API Level 1
# dom-xrmediabinding-createequirectlayer

Tương thích trình duyệt

Xem thêm