About
Device Integration — Connect Headsets, Rings & Controllers | Immersia
How to connect any audio headset, notification glasses, display headset, spatial headset, smart ring, or controller to Immersia. Zero SDK needed. Web standards only.
How Immersia connects to devices
Immersia uses standard web APIs. If your device has a modern browser, it already works. No SDK, no app store, no proprietary protocol.
Audio Headsets
Glasses with speakers. Detected automatically. Guests hear the guide's live voice stream — no screen needed. Translated voice available when enabled.
Notification Headsets
Small monochrome display for subtitles. Audio stream plus live translated subtitles rendered on the HUD. Auto-detected by screen dimensions.
Display Headsets
Full color AR glasses. Voice streaming, live subtitles, and full slide sync — images, videos, and diagrams appear directly in the glasses.
Spatial Headsets
6DoF AR with world understanding. All display-headset features plus spatial anchors and world-locked content.
Immersive XR Headsets
Full passthrough VR/AR. All spatial-headset features plus fully immersive spatial UI and hand tracking.
Mobile, Tablet & Desktop
Standard browsers on phones, tablets, and computers. Full Immersia experience — slides, audio, subtitles, QR scan, and all host controls.
For Headset Manufacturers
Your headset already works with Immersia if it includes a standards-compliant browser. Here is what to verify.
Required browser APIs
WebRTC — for live voice streaming to the headset
Web Audio API — for audio playback on the device
DOM / CSS — for subtitle and slide rendering
Service Worker — for offline caching (optional)
URL pattern
Point your headset browser to:
https://app.getimmersia.com/play?s={SESSION_CODE}&audio=1&subtitles=1
The session code is generated when a guide starts a tour. For testing, create a free account and start a tour.
Automatic classification
Immersia classifies your device by what its browser exposes:
Audio headset — no screen. Voice stream only.
Notification headset — screen ≤ 640px. Voice + subtitles on HUD.
Display headset — full color screen. Voice + subtitles + slides + video.
Spatial headset — 6DoF + world mesh. All above + spatial anchors.
Immersive headset — passthrough VR/AR. All above + immersive 3D.
Optional: on-device AI
If your headset browser exposes window.ai.translator or window.translation, Immersia will translate subtitles on-device — reducing cloud API costs and improving latency.
For Smart Ring Makers
Rings work as slide controllers for the tour guide. Two connection methods are supported.
NFC rings
Any ring with an ISO 14443 NFC tag. The guide taps the ring to their phone to advance slides:
Single tap — next slide
Double tap — previous slide
No specific tag content format required. Works with Chrome on Android via the Web NFC API.
BLE rings
Rings with a BLE button service connect via Web Bluetooth:
Press — next slide
Long press (0.8s) — toggle blackout (show/hide QR code)
We recommend exposing a standard GATT button service (UUID 0x1801) for the simplest compatibility.
Presentation Clickers & Game Controllers
Presentation clickers
Any clicker that sends standard keyboard events works automatically:
Arrow Right → next slide
Arrow Left → previous slide
Space → toggle blackout (play/pause)
Logitech Spotlight, DinoFire, Kensington, and most generic USB clickers are compatible.
Game controllers
Controllers detected via the Gamepad API. Useful for museum kiosks and permanent installations.
Xbox Wireless, PlayStation DualSense, and generic HID gamepads are supported via the standard Gamepad API in Chrome and Edge.
API access for deeper integration
If you need native SDK-level integration — custom UI on the headset, offline caching of subtitle data, hardware-specific audio tuning, or a dedicated API key for session management — we offer API access for qualified hardware partners.
Contact us about API access →Free to try · 1 tour, 50 photos, 1 GB · No card required