@threlte/xr/dist/lib/toggleXRSession.js

Tools to more easily create VR and AR experiences with Threlte

import { session, referenceSpaceType, xr } from '../internal/stores';
import { getXRSessionOptions } from './getXRSessionOptions';
/**
 * Starts / ends an XR session.
 *
 * @param sessionMode an XR session mode: 'inline' | 'immersive-vr' | 'immersive-ar'
 * @param sessionInit an XRSessionInit object
 * @param force Whether this button should only enter / exit an `XRSession`. Default is to toggle both ways
 * @returns
 */
export const toggleXRSession = async (sessionMode, sessionInit, force) => {
    const currentSession = session.current;
    const hasSession = currentSession !== undefined;
    if (force === 'enter' && hasSession)
        return currentSession;
    if (force === 'exit' && !hasSession)
        return;
    // Exit a session if entered
    if (hasSession) {
        await currentSession.end();
        session.set(undefined);
        return;
    }
    if (xr.current === undefined) {
        throw new Error('An <XR> component was not created when attempting to toggle a session.');
    }
    // Otherwise enter a session
    const options = getXRSessionOptions(referenceSpaceType.current, sessionInit);
    const nextSession = await navigator.xr.requestSession(sessionMode, options);
    await xr.current.setSession(nextSession);
    session.set(nextSession);
    return nextSession;
};