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

BCD tables only load in the browser

See also