XRMediaBinding: XRMediaBinding() constructor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The XRMediaBinding() constructor creates and returns a new XRMediaBinding object.

Syntax

new XRMediaBinding(session)

Parameters

session: An XRSession object specifying the WebXR session for which to create the media binding.

Exceptions

InvalidStateError DOMException

Thrown if the new XRMediaBinding could not be created due to one of a number of possible state errors:

The XRSession specified by session has already been stopped.
The specified session is not immersive.

Examples

Creating a new `XRMediaBinding`

The following example creates a new media binding for a session to create an XRQuadLayer to display a video layer in the scene.

const xrMediaBinding = new XRMediaBinding(xrSession);

const video = document.createElement("video");
video.src = "just-fascination.mp4";
const layer = xrMediaBinding.createQuadLayer(video);

Specifications

Specification
WebXR Layers API Level 1 # dom-xrmediabinding-xrmediabinding

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
XRMediaBinding() constructor
Experimental