feat: support applying music mode constraints (#27)

Co-authored-by: Bryce Tham <[email protected]>

src/device/device-management.ts

@@ -31,6 +31,9 @@ export class WcmeError {
 
 export type AudioDeviceConstraints = {
   deviceId?: string;
+  autoGainControl?: boolean;
+  echoCancellation?: boolean;
+  noiseSuppression?: boolean;
 };
 
 export type VideoDeviceConstraints = {

src/media/local-track.spec.ts

@@ -51,4 +51,14 @@ describe('LocalTrack', () => {
 
     expect(emitted).toBe(true);
   });
+
+  it('should apply and get underlying track constraints', () => {
+    expect.assertions(1);
+
+    localTrack.applyConstraints({ autoGainControl: true });
+
+    const constraints = localTrack.getConstraints();
+
+    expect(constraints).toStrictEqual({ autoGainControl: true });
+  });
 });

src/media/local-track.ts

@@ -267,4 +267,33 @@ export abstract class LocalTrack extends EventEmitter<TrackEvents> {
       this.emit(LocalTrackEvents.UnderlyingTrackChange);
     }
   }
+
+  /**
+   * Apply constraints to the track.
+   *
+   * @param constraints - The constraints to apply to the track.
+   * @returns A promise which resolves when the constraints have been successfully applied.
+   */
+  async applyConstraints(constraints?: MediaTrackConstraints): Promise<void> {
+    logger.log(`Applying constraints to local track:`, constraints);
+    return this.underlyingTrack.applyConstraints(constraints);
+  }
+
+  /**
+   * Get the current constraints of the track.
+   *
+   * @returns The constraints of the track.
+   */
+  getConstraints(): MediaTrackConstraints {
+    return this.underlyingTrack.getConstraints();
+  }
+
+  /**
+   * Get the current settings of the track.
+   *
+   * @returns The settings of the track.
+   */
+  getSettings(): MediaTrackSettings {
+    return this.underlyingTrack.getSettings();
+  }
 }

src/mocks/media-stream-track-stub.ts

@@ -12,6 +12,8 @@ class MediaStreamTrackStub {
   // be fine.
   eventListeners: Map<string, any> = new Map();
 
+  constraints: MediaTrackConstraints = {};
+
   kind?: MediaStreamTrackKind;
 
   /**
@@ -24,6 +26,12 @@ class MediaStreamTrackStub {
    */
   stop(): void {}
 
+  applyConstraints(constraints?: MediaTrackConstraints): void {}
+
+  getConstraints(): MediaTrackConstraints {
+    return {} as MediaTrackConstraints;
+  }
+
   getSettings(): MediaTrackSettings {
     return {} as MediaTrackSettings;
   }

src/util/test-utils.ts

@@ -30,6 +30,12 @@ export const createMockedStreamWithSize = (width: number, height: number): Media
     width,
     aspectRatio: width / height,
   });
+  track.applyConstraints.mockImplementation((constraints?: MediaTrackConstraints) => {
+    track.constraints = constraints || {};
+  });
+  track.getConstraints.mockImplementation(() => {
+    return track.constraints;
+  });
   mockStream.getVideoTracks.mockReturnValue([track as unknown as MediaStreamTrack]);
   mockStream.getTracks.mockReturnValue([track as unknown as MediaStreamTrack]);
   return mockStream as unknown as MediaStream;