Package org.lwjgl.openxr

Class EXTUserPresence

java.lang.Object
org.lwjgl.openxr.EXTUserPresence
public final class EXTUserPresence extends Object
The XR_EXT_user_presence extension.

This extension introduces a new event to notify when the system detected the change of user presence, such as when the user has taken off or put on an XR headset.

This event is typically used by an XR applications with non-XR experiences outside of the XR headset. For instance, some applications pause the game logic or video playback until the user puts on the headset, displaying an instructional message to the user in the mirror window on the desktop PC monitor. As another example, the application might use this event to disable a head-tracking driven avatar in an online meeting when the user has taken off the headset.

The user presence is fundamentally decoupled from the session lifecycle. Although the core spec for XrSessionState hinted potential correlation between the session state and user presence, in practice, such a connection may not consistently hold across various runtimes. Application should avoid relying on assumptions regarding these relationships between session state and user presence, instead, they should utilize this extension to reliably obtain user presence information.