WebXR Device API
The WebXR Device API interface XRInputSourcesChangeEvent is used to represent the XRSession.inputsourceschange_event event sent to an XRSession when the set of available WebXR input controllers changes.
Constructor
- XRInputSourcesChangeEvent.XRInputSourcesChangeEvent
- : Creates and returns a new
XRInputSourcesChangeEventobject. The specified type must beinputsourceschange, which is the only event that uses this interface.
- : Creates and returns a new
Instance properties
- XRInputSourcesChangeEvent.added
- : An array of zero or more XRInputSource objects, each representing an input device which has been newly connected or enabled for use.
- XRInputSourcesChangeEvent.removed
- : An array of zero or more XRInputSource objects representing the input devices newly connected or enabled for use.
- XRInputSourcesChangeEvent.session
- : The XRSession to which this input source change event is being directed.
Instance methods
While XRInputSourcesChangeEvent defines no methods of its own, it inherits methods from its parent interface, Event.
Event types
- XRSession.inputsourceschange_event
- : Delivered to the XRSession when the set of input devices available to it changes.
Examples
The following example shows how to set up an event handler which uses inputsourceschange 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 for inputsourceschange events by setting the oninputsourceschange event handler:
xrSession.oninputsourceschange = onInputSourcesChange;
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
