XRMediaBinding: XRMediaBinding() constructor

Limited availability

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

See full compatibility

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.

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.

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

	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	Chrome – No support Chrome footnote No support	Edge – No support Edge footnote No support	Firefox – No support Firefox footnote No support	Opera – No support Opera footnote No support	Safari – No support Safari footnote No support	Chrome Android – No support Chrome Android footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – No support Opera Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

No support: No support
: Experimental. Expect behavior to change in the future.

XRMediaBinding: XRMediaBinding() constructor

Legend