XRView: isFirstPersonObserver property
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.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The XRView interface's read-only isFirstPersonObserver property is a boolean indicating if the XRView is a first-person observer view.
To create video recordings of AR device cameras, you can't simply use one of the rendered eyes, as there often will be a physical offset. Some devices expose a secondary view, the first-person observer view, which has an eye of none.
To receive a first-person observer view, you need to enable the "secondary-views" feature descriptor explicitly (typically as an optional feature). See XRSystem.requestSession() for details.
The isFirstPersonObserver property then allows you to check which secondary view is a first-person observer view.
Examples
Checking for first-person observer views
// Make sure to enable "secondary-view" navigator.xr .requestSession("immersive-ar", { optionalFeatures: ["secondary-views"], }) .then((session) => { // … session.requestAnimationFrame((frame) => { const views = frame.getViewerPose(space); // Make sure to iterate over all views for (const view of views) { if (view.isFirstPersonObserver) { renderFPO(); } else { render(); } } }); }); Specifications
| Specification |
|---|
| WebXR Augmented Reality Module - Level 1 # dom-xrview-isfirstpersonobserver |
Browser compatibility
Loading…