feat: Add 'call' support to improve 2-way audio experience (#2486)

Draws significant inspiration (and direct styling) from https://github.com/dermotduffy/advanced-camera-card/pull/2447 . Thank you @Maudfer ! BREAKING CHANGE: The microphone condition previously bundled two unrelated signals — whether a two-way-audio session was connected and whether the microphone was muted. Connection state is now its own dedicated call condition, and microphone is reserved purely for mute state. Configs are upgraded automatically (the card rewrites affected conditions under overrides, elements, and automations). If you maintain config by hand, convert as follows: If you only used connected: # Before ```yaml condition: microphone connected: true ``` # After ```yaml condition: call call: true ``` If you used both connected and muted — they must be split into two conditions, since they no longer live together: # Before ```yaml condition: microphone connected: true muted: false ``` # After ```yaml condition: and conditions: - condition: call call: true - condition: microphone muted: false ```
2026-06-30 17:45:13 -07:00
parent bb061a1a55
commit abcba884e5
116 changed files with 3871 additions and 845 deletions
@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { getStreamCameraID, hasSubstream } from '../../src/view/substream';
+import { createView } from '../test-utils';
+
+describe('getStreamCameraID / hasSubstream', () => {
+  it('should report a substream override', () => {
+    const view = createView({
+      camera: 'camera',
+      context: {
+        live: {
+          overrides: new Map([['camera', 'camera2']]),
+        },
+      },
+    });
+    expect(hasSubstream(view)).toBeTruthy();
+    expect(getStreamCameraID(view)).toBe('camera2');
+  });
+
+  it('should not report a substream when absent', () => {
+    const view = createView({ camera: 'camera' });
+    expect(hasSubstream(view)).toBeFalsy();
+    expect(getStreamCameraID(view)).toBe('camera');
+  });
+
+  it('should not report a substream when the override points at the main stream', () => {
+    const view = createView({
+      camera: 'camera',
+      context: {
+        live: {
+          overrides: new Map([['camera', 'camera']]),
+        },
+      },
+    });
+    expect(hasSubstream(view)).toBeFalsy();
+    expect(getStreamCameraID(view)).toBe('camera');
+  });
+
+  describe('should respect explicit cameraID argument', () => {
+    it('when the cameraID has an override', () => {
+      const view = createView({
+        camera: 'camera',
+        context: {
+          live: {
+            overrides: new Map([
+              ['camera', 'camera2'],
+              ['camera3', 'camera4'],
+            ]),
+          },
+        },
+      });
+      expect(hasSubstream(view)).toBeTruthy();
+      expect(getStreamCameraID(view, 'camera3')).toBe('camera4');
+    });
+
+    it('when the cameraID has no override', () => {
+      const view = createView();
+      expect(hasSubstream(view)).toBeFalsy();
+      expect(getStreamCameraID(view, 'camera3')).toBe('camera3');
+    });
+  });
+
+  it('should handle a null camera', () => {
+    expect(getStreamCameraID(createView({ camera: null }))).toBeNull();
+    expect(hasSubstream(createView({ camera: null }))).toBeFalsy();
+  });
+});