Babylon Lite analytics

The Babylon Lite connector. Babylon Lite is a functional / data-oriented, WebGPU-only Babylon engine — no classes, no scene observables. Because the app owns the canvas and drives the render loop, this connector mirrors the three.js adapter’s shape: pass the scene, camera, and canvas explicitly.

@babylonjs/lite is an optional peer dependency — the connector reads your existing instance and never bundles its own.

Install

npm install @uptimizr/babylon-lite @babylonjs/lite

Usage

import {
  createEngine,
  createSceneContext,
  createArcRotateCamera,
  attachControl,
} from "@babylonjs/lite";
import { trackScene } from "@uptimizr/babylon-lite";

const engine = await createEngine(canvas);
const scene = createSceneContext(engine);
const camera = createArcRotateCamera(-Math.PI / 2, Math.PI / 2.5, 16, { x: 0, y: 1, z: 0 });
attachControl(camera, canvas, scene);

// The app owns the canvas and render loop, so pass scene + camera + canvas explicitly.
const client = trackScene(scene, camera, canvas, {
  projectId: "your-project",
  endpoint: "https://collect.example.com",
});

// later, on teardown
await client.stop("manual");

trackScene returns the @uptimizr/sdk-core UptimizrClient. Read client.sessionId, emit custom events with client.track(...), or stop the session early.

trackSceneAsync(scene, camera, canvas, options) is the same call, awaited. It resolves the real WebGPU backend (Metal/D3D12/Vulkan) with readGraphicsAsync() before session_start, and falls back to the webgpu/wgsl baseline on failure:

import { trackSceneAsync } from "@uptimizr/babylon-lite";

const client = await trackSceneAsync(scene, camera, canvas, { projectId, endpoint });

Coordinate frame & graphics

Babylon Lite is left-handed, y-up, unit-scale 1 — the same as Uptimizr’s canonical wire frame — so the coordinate normalizers are identities (still applied for provenance). It is WebGPU-only, so graphics.api is always webgpu and the shading language is wgsl.

Capture

The Lite connector captures camera pose (camera_sample), pointer move/click and buttons, camera gestures, mesh picks via GPU picking (mesh_interaction), and frame perf. Opt-in: capture.meshVisibility, capture.hoverDwell, capture.resourceSample and capture.gaze. It has no named-bone API, so scene-actor capture is Tier 1 (node/root transforms) only. Frame perf carries FPS without percentiles or long-frame counts, and there is no keyBindings or capture.contextLoss.

Lite-specific options

Option	Accepted by	Default	Effect
pickPixelRatio	trackScene, liteCollector	1	Multiplies CSS-pixel pointer coordinates before picking. Pass window.devicePixelRatio.
picker	trackScene, liteCollector	GPU picker	Override the async probe, a LitePickProbe.
graphics	trackScene	sync baseline	Pre-resolved Graphics block, e.g. await readGraphicsAsync().
connector	trackScene	babylon-lite	Override the provenance { name?, version? }.
frameHook	liteCollector	onBeforeRender	Override the per-frame hook registration, (scene, cb) => void.

createScenePicker(scene) returns the default LitePickProbe: pick(pixelX, pixelY) resolves to { point, mesh } or undefined, and dispose() releases the GPU picker.

For finer control, register liteCollector with an sdk-core UptimizrClient via client.use(...) — see sdk-core (advanced). It is also where the meshVisibility, hoverDwell and resourceSample options objects go; trackScene does not accept them.