@vizor-vr/player
v0.2.1
Published
VR video player for the modern web — 360°, VR, live streaming, virtual tours
Maintainers
Readme
@vizor-vr/player
High-performance VR and 360° video player for the web, built on Web Components and Three.js. Embed immersive content with a single HTML tag — no framework required.
<script type="module" src="https://cdn.jsdelivr.net/npm/@vizor-vr/player/dist/vizor.js"></script>
<vz-video src="video.mp4" format="MONO_360" autoplay></vz-video>Install
npm install @vizor-vr/player// Registers all <vz-*> custom elements as a side effect
import '@vizor-vr/player/register';Elements
| Element | Purpose |
|---------|---------|
| <vz-video> | 360°/VR video playback |
| <vz-img> | 360°/VR image display |
| <vz-tour> | Multi-scene virtual tours |
| <vz-cinema> | Flat video in a 3D environment |
| <vz-live> | Live streaming (HLS / DASH) |
| <vz-playlist> | Sequential content playback |
Features
- Multiple projection formats (equirectangular 360/180, cubemap/EAC, fisheye, flat) with mono and stereo variants
- WebXR immersive sessions (via Three.js)
- Adaptive streaming through optional
hls.js/dashjspeer dependencies - Ambisonic spatial audio via the optional
omnitonepeer dependency - Progressive enhancement — degrades gracefully without WebXR
Optional peer dependencies
Install only what you use:
npm install hls.js dashjs omnitoneFramework wrappers
- React —
@vizor-vr/react - Vue 3 —
@vizor-vr/vue - Svelte 5 —
@vizor-vr/svelte - Laravel —
vizor-vr/laravel-vizor
Security
See the monorepo security policy for how to report vulnerabilities ([email protected]).
License
MIT — see LICENSE.
