XRInputSourcesChangeEvent.added

Secure context

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

The read-only XRInputSourcesChangeEvent property added is a list of zero or more input sources, each identified using an XRInputSource object, which have been newly made available for use.

Syntax

let addedInputs = xrInputSourcesChangeEvent.added;

Value

An Array of zero or more XRInputSource objects, each representing one input device added to the XR system.

Examples

The example below creates a handler for the inputsourceschange event that processes the lists of added and removed from the WebXR system. It looks for new and removed devices whose targetRayMode is tracked-pointer.

xrSession.oninputsourcescchange = event => {
  for (let input of event.added) {
    if (input.targetRayMode == "tracked-pointer") {
      addedPointerDevice(input);
    }
  }
  for (let input of event.removed) {
    if (input.targetRayMode == "tracked-pointer") {
      removedPointerDevice(input);
    }
  }
};

Specifications

Specification Status Comment
WebXR Device API
The definition of 'XRInputSourcesChangeEvent.added' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser