XRSession: метод cancelAnimationFrame()

Метод cancelAnimationFrame() интерфейса XRSession отменяет кадр анимации, который был запрошен ранее вызовом requestAnimationFrame.

handle

Уникальное значение, возвращаемое вызовом requestAnimationFrame(), которое ранее планировало вызов обратного вызова анимации.

None (undefined).

Эта функция не оказывает никакого влияния, если указанный handle не найден.

В примере ниже показан код, который запускает сеанс WebXR, если поддерживается режим виртуальной реальности. После запуска сеанс запланирует первый рендеринг кадра, вызвав requestAnimationFrame().

Функция pauseXR() внизу может быть вызвана для приостановки сеанса WebVR, по сути, путем отмены любого ожидающего вызова обратного вызова кадра анимации. Поскольку каждый вызов обратного вызова кадра планирует следующий, удаление вызова обратного вызова прекращает обновление сцены 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;
  }
}

• Window.cancelAnimationFrame
• XRSession.requestAnimationFrame