The WebXR Device API interfaceXRInputSourcesChangeEvent is used to represent theinputsourceschange event sent to anXRSession when the set of available WebXR input controllers changes.

Constructor

XRInputSourcesChangeEvent()

Creates and returns a newXRInputSourcesChangeEvent object. The specified type must beinputsourceschange, which is the only event that uses this interface.

Instance properties

addedRead only

An array of zero or moreXRInputSource objects, each representing an input device which has been newly connected or enabled for use.

removedRead only

An array of zero or moreXRInputSource objects representing the input devices newly connected or enabled for use.

sessionRead only

TheXRSession to which this input source change event is being directed.

Instance methods

WhileXRInputSourcesChangeEvent defines no methods of its own, it inherits methods from its parent interface,Event.

Event types

inputsourceschange

Delivered to theXRSession when the set of input devices available to it changes.

Examples

The following example shows how to set up an event handler which usesinputsourceschange events to detect newly-available pointing devices and to load their models in preparation to display them in the next animation frame.

xrSession.addEventListener("inputsourceschange", onInputSourcesChange);function onInputSourcesChange(event) {  for (const input of event.added) {    if (input.targetRayMode === "tracked-pointer") {      loadControllerMesh(input);    }  }}

You can also add a handler forinputsourceschange events by setting theoninputsourceschange event handler:

xrSession.oninputsourceschange = onInputSourcesChange;

Specifications

Browser compatibility