XRSession: phương thức cancelAnimationFrame()

Khả dụng hạn chế

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.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Phương thức cancelAnimationFrame() của giao diện XRSession hủy một khung hình hoạt ảnh đã được yêu cầu trước đó bằng cách gọi requestAnimationFrame.

Cú pháp

cancelAnimationFrame(handle)

Tham số

handle: Giá trị duy nhất được trả về bởi lệnh gọi requestAnimationFrame() đã lên lịch callback hoạt ảnh trước đó.

Ghi chú sử dụng

Hàm này không có tác dụng nếu không thể tìm thấy handle được chỉ định.

Trong ví dụ bên dưới, chúng ta thấy mã khởi chạy một phiên WebXR nếu chế độ VR nhập vai được hỗ trợ. Sau khi bắt đầu, phiên lên lịch khung hình đầu tiên để kết xuất bằng cách gọi requestAnimationFrame().

Hàm pauseXR() được hiển thị ở cuối có thể được gọi để tạm ngưng phiên WebVR, về cơ bản là hủy bất kỳ callback khung hình hoạt ảnh đang chờ nào. Vì mỗi callback khung hình lên lịch callback tiếp theo, việc xóa callback sẽ chấm dứt việc cập nhật cảnh WebXR.

const XR = navigator.xr;

let requestHandle = null;
let xrSession = null;

if (XR) {
  XR.isSessionSupported("immersive-vr").then((isSupported) => {
    if (isSupported) {
      startXR();
    }
  });
}

function frameCallback(time, xrFrame) {
  xrSession.requestAnimationFrame(frameCallback);

  // Update and render the frame
}

async function startXR() {
  xrSession = XR.requestSession("immersive-vr");

  if (xrSession) {
    stopButton.onclick = stopXR;
    requestHandle = xrSession.requestAnimationFrame(frameCallback);
  }
}

function pauseXR() {
  if (xrSession && requestHandle) {
    xrSession.cancelAnimationFrame(requestHandle);
    requestHandle = null;
  }
}