@tribe-nest/media-client 0.1.1 → 0.4.0

package/src/room/browserDevice.ts

@@ -27,14 +27,24 @@ import type {
  * place.
  */
 
-const adapt = (transport: Transport): MediaTransport => ({
+const CODEC_MIME: Record<"h264" | "vp8", string> = { h264: "video/h264", vp8: "video/vp8" };
+
+const adapt = (transport: Transport, device: Device): MediaTransport => ({
   id: transport.id,
 
-  async produce({ track, appData, encodings }) {
+  async produce({ track, appData, encodings, codec }) {
+    // The router's own entry for the codec, which is what mediasoup-client
+    // wants rather than a name. Missing means the router does not offer it
+    // and the default applies, which the caller can see from the producer.
+    const wanted = codec ? CODEC_MIME[codec] : undefined;
+    const capability = wanted
+      ? device.rtpCapabilities.codecs?.find((c) => c.mimeType.toLowerCase() === wanted)
+      : undefined;
     const producer = await transport.produce({
       track,
       ...(encodings ? { encodings: encodings as never } : {}),
       ...(appData ? { appData } : {}),
+      ...(capability ? { codec: capability } : {}),
     });
     return producer as unknown as MediaProducerHandle;
   },
@@ -103,12 +113,12 @@ export function createBrowserDevice(): MediaDevice {
     createSendTransport({ description, iceServers, handlers }) {
       const transport = device.createSendTransport(common(description, iceServers));
       wire(transport, handlers);
-      return adapt(transport);
+      return adapt(transport, device);
     },
     createRecvTransport({ description, iceServers, handlers }) {
       const transport = device.createRecvTransport(common(description, iceServers));
       wire(transport, handlers);
-      return adapt(transport);
+      return adapt(transport, device);
     },
   };
 }

package/src/room/device.ts

@@ -62,6 +62,8 @@ export interface MediaTransport {
     track: MediaStreamTrack;
     appData?: Record<string, unknown>;
     encodings?: unknown[];
+    /** Prefer this codec from the loaded capabilities; ignored when absent. */
+    codec?: "h264" | "vp8";
   }): Promise<MediaProducerHandle>;
   consume(input: {
     id: string;
@@ -78,7 +80,18 @@ export type MediaProducerHandle = {
   pause(): void;
   resume(): void;
   close(): void;
+  /** Swap the capture feeding this producer. The node sees nothing. */
+  replaceTrack(track: MediaStreamTrack): Promise<void>;
   readonly closed: boolean;
+  /**
+   * The underlying sender, when the implementation has one.
+   *
+   * Exposed for `degradationPreference`, which is a SENDER-level setting with
+   * no per-encoding equivalent, so there is no way to ask for it through
+   * `produce()`. Optional because a non-browser implementation has no such
+   * object, and every caller has to cope with its absence anyway.
+   */
+  readonly rtpSender?: RTCRtpSender | null;
 };
 
 export type MediaConsumerHandle = {
@@ -89,6 +102,12 @@ export type MediaConsumerHandle = {
   pause(): void;
   resume(): void;
   close(): void;
+  /**
+   * The browser's inbound stats for this consumer, when the implementation
+   * has them (mediasoup-client does; a fake need not). What the diagnostics
+   * read decoded resolution and bitrate from.
+   */
+  getStats?(): Promise<unknown>;
 };
 
 /**