@displayxr/inline3d 1.49.0 → 1.49.2

package/CHANGELOG.md

@@ -5,6 +5,52 @@ entry points (`.`, `./three`) are frozen for 1.x, while the **scene subpaths** (
 `./splat`, `./model`) are a preview tier whose options may change in any release. Entries below say
 which tier they touch, because that is what tells you whether an upgrade can move your pixels.
 
+## 1.49.2 — 2026-11-04
+
+### Fixed — the camera probe waits for the DisplayXR 3D camera before opening a plain lens (`./camera`, `./call`)
+
+Preview tier. In a DisplayXR Browser the runtime lists its 3D camera lazily. On a phone it is
+missing from the list right after a runtime restart, or after the camera service restarted. With
+the 3D camera absent, `camera: 'auto'` read the list once more and then opened the plain front lens.
+On some phones that open crashes the camera HAL while head tracking streams. The HAL restart takes
+the 3D camera down again, so the call never got it back: the self view stayed 2D, or the call
+reported "Camera busy".
+
+- **The wait:** with camera labels visible and no stereo-named device listed, `'auto'` / `'stereo'`
+  now wait up to `stereoWaitMs` (new option, default **2500 ms in a DisplayXR Browser**, 0
+  elsewhere) before opening any plain lens. They re-read the list on every `devicechange` and every
+  500 ms, and open the 3D camera as soon as it appears. `'mono'`, an explicit `deviceId` and
+  `label:` never wait. The rule is in [`docs/camera.md`](docs/camera.md), "Waiting for the 3D camera".
+- **No shape probe of a second lens in a DisplayXR Browser:** once a plain lens is in hand, the
+  last-resort probe no longer opens the other plain lenses to test whether one is a side-by-side
+  pair. There, a stereo webcam (a USB SBS one included, through the runtime's UVC source) is the
+  runtime's named "3D Camera". The extra open is the one that can crash a phone's camera HAL. Other
+  browsers keep the shape probe, which is how a USB stereo webcam is found there.
+- **Pinned:** when the default camera opens but delivers no picture (0x0), a lens that opens by id
+  is kept as the fallback, never stopped and reported as busy. This has worked since 1.48.0; a test
+  now covers it.
+
+## 1.49.1 — 2026-11-03
+
+### Fixed — app share on browsers without the app-share device patch (`./call`, `./camera`)
+
+Preview tier. A DisplayXR Browser that predates the app-share device patch (1.9.x) lists a running
+app through its 3D-camera device, as `3D Camera (DisplayXR) - <app>` with no `source` in
+`displayxrStereo` — and once the runtime offers more than one source it suffixes the REAL camera the
+same way, so the label cannot tell an app from a camera. On such a browser `camera: 'auto'` could
+open the app and send it as your face, and `listShareableApps()` found nothing.
+
+- **Detection by the opened track**: an app source advertises `baselineMm: 0` and
+  `horizontalFovDeg: 0` (runtime ADR-061 decision 2); a real camera never has baseline 0.
+  `isAppShareDevice()` now accepts that hint as well as `source: 'app'`. The legacy label alone is
+  never enough.
+- **Camera probe**: every probe path checks the opened track; an app is closed again and reported
+  in `skipped` with `reason: 'app-share'`, and probing goes on. Suffixed real cameras open as before.
+- **Discovery**: with no `DisplayXR: <app> (3D)` device listed, `listShareableApps()` returns the
+  `3D Camera (DisplayXR) - <name>` entries as candidates (`ShareableApp.legacy: true`, `appName`
+  from the label). `openAppShare()` verifies the opened track and rejects a real camera with
+  `code: 'not-app-share'` (stopped again); the descriptor's `appName` falls back to the label's name.
+
 ## 1.49.0 — 2026-11-03
 
 ### Added — the content tile: share a running 3D app into a call (`./call`, `./camera`)

package/call.d.ts

@@ -374,9 +374,15 @@ export interface CallContent {
 /** A running DisplayXR app the browser offers to share (`listShareableApps`). */
 export interface ShareableApp {
   readonly deviceId: string;
-  /** `DisplayXR: <app> (3D)`. */
+  /** `DisplayXR: <app> (3D)` (or `3D Camera (DisplayXR) - <app>` for a `legacy` candidate). */
   readonly label: string;
   readonly appName: string | null;
+  /**
+   * A browser without the app-share device patch: a CANDIDATE listed by its label shape only — a
+   * real camera can carry the same shape. `openAppShare()` verifies it (a camera rejects with
+   * `not-app-share`).
+   */
+  readonly legacy?: true;
 }
 
 /** An opened app share (`openAppShare`): pass `stream` (+ `descriptor`) to `shareContent`. The track is yours to stop. */
@@ -392,8 +398,9 @@ export type AppShareErrorCode = 'share-denied' | 'share-failed' | 'not-app-share
 /**
  * Is this a running DisplayXR app offered for 3D screen share (runtime ADR-061) rather than a
  * camera? A `MediaDeviceInfo`, a label, a track, or its settings: true on the label
- * `DisplayXR: <app> (3D)`, a `dxr-app:` device id, or `displayxrStereo.source === 'app'`. No camera
- * probe (`camera: 'auto'`, `openCamera`) ever opens one.
+ * `DisplayXR: <app> (3D)`, a `dxr-app:` device id, `displayxrStereo.source === 'app'`, or (browsers
+ * without the app-share device patch) a hint with `baselineMm` and `horizontalFovDeg` both 0. No
+ * camera probe (`camera: 'auto'`, `openCamera`) ever uses one.
  */
 export function isAppShareDevice(device: MediaDeviceInfo | MediaStreamTrack | MediaTrackSettings | { label?: string; deviceId?: string } | string | null | undefined): boolean;
 

package/camera.d.ts

@@ -73,6 +73,13 @@ export interface CameraOptions {
    * list off. An explicit `deviceId` or `label:` (`prefer`) is your choice and is opened regardless.
    */
   exclude?: ReadonlyArray<string | RegExp> | false;
+  /**
+   * `'auto'` / `'stereo'` with labels visible and no 3D camera listed: how long (ms) to wait for
+   * the runtime's 3D camera to be listed before any plain lens is opened. Default 2500 in a
+   * DisplayXR Browser, 0 elsewhere (one re-read of the list). Opening a phone lens while head
+   * tracking streams can crash the camera HAL on some devices and take the 3D camera down with it.
+   */
+  stereoWaitMs?: number;
   /** Verbose console logging. */
   debug?: boolean;
 }