XRMediaBinding: XRMediaBinding() constructor

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

js
new XRMediaBinding(session)

Parameters

session

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

Return value

A newly-created XRMediaBinding.

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.

js
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

Browser compatibility

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

See also