1. Web
  2. Web APIs
  3. XRMediaBinding
  4. XRMediaBinding()

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

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

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content