@uptimizr/playcanvas 0.1.0

package/dist/trackScene.js

@@ -0,0 +1,72 @@
+import { UptimizrClient } from "@uptimizr/sdk-core";
+import { playcanvasCollector } from "./collector.js";
+import { readDeviceCaps } from "./device.js";
+import { readGraphics } from "./graphics.js";
+import { readConnector } from "./connector.js";
+import { readSceneMeta } from "./scene.js";
+/**
+ * One-call PlayCanvas integration: create a client, register the PlayCanvas
+ * collector, read device/GPU caps, and start the session. Returns the
+ * {@link UptimizrClient} so the host can read `sessionId`, emit custom events, or
+ * `stop()` on teardown.
+ *
+ * PlayCanvas supports multiple camera entities with no single "active" camera, and
+ * the connector reads FPS / the canvas from the app's graphics device, so — unlike
+ * Babylon's `trackScene(scene, options)` — the `camera` Entity is an explicit
+ * positional argument (mirroring the three connector).
+ *
+ * ```ts
+ * import { trackScene } from "@uptimizr/playcanvas";
+ *
+ * const client = trackScene(app, cameraEntity, {
+ *   projectId: "your-project",
+ *   endpoint: "https://collect.example.com",
+ * });
+ * // ... later
+ * await client.stop("manual");
+ * ```
+ *
+ * For finer control (custom transport, `beforeSend`, registering multiple
+ * collectors), use {@link playcanvasCollector} with a {@link UptimizrClient} directly.
+ */
+export function trackScene(app, camera, options) {
+    const client = new UptimizrClient({
+        projectId: options.projectId,
+        endpoint: options.endpoint,
+        flushIntervalMs: options.flushIntervalMs,
+        transport: options.transport,
+        disabled: options.disabled,
+        debug: options.debug,
+    });
+    client.use(playcanvasCollector({
+        app,
+        camera,
+        sampleCameraMs: options.sampleCameraMs,
+        samplePerfMs: options.samplePerfMs,
+        pointerMoveThrottleMs: options.pointerMoveThrottleMs,
+        suppressIdleSamples: options.suppressIdleSamples,
+        suppressIdlePerfSamples: options.suppressIdlePerfSamples,
+        cameraEpsilon: options.cameraEpsilon,
+        perfFpsThreshold: options.perfFpsThreshold,
+        capture: options.capture,
+        ...(options.gaze ? { gaze: options.gaze } : {}),
+        ...(options.sampling ? { sampling: options.sampling } : {}),
+        ...(options.actors ? { actors: options.actors } : {}),
+        ...(options.keyBindings ? { keyBindings: options.keyBindings } : {}),
+    }));
+    const sceneMeta = {
+        ...readSceneMeta(app, camera),
+        ...(options.sceneDescription ? { description: options.sceneDescription } : {}),
+        ...(options.cameraType ? { cameraType: options.cameraType } : {}),
+    };
+    client.start({
+        device: readDeviceCaps(app),
+        graphics: readGraphics(app),
+        connector: readConnector(),
+        scene: sceneMeta,
+        ...(options.user ? { user: options.user } : {}),
+        ...options.meta,
+    });
+    return client;
+}
+//# sourceMappingURL=trackScene.js.map

package/dist/trackScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackScene.js","sourceRoot":"","sources":["../src/trackScene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqF3C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,UAAU,CACxB,GAAY,EACZ,MAAc,EACd,OAA0B;IAE1B,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CACR,mBAAmB,CAAC;QAClB,GAAG;QACH,MAAM;QACN,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC,CACH,CAAC;IAEF,MAAM,SAAS,GAAG;QAChB,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC;QAC7B,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC;QACX,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC;QAC3B,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC;QAC3B,SAAS,EAAE,aAAa,EAAE;QAC1B,KAAK,EAAE,SAAS;QAChB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,OAAO,CAAC,IAAI;KAChB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}