@fishjam-cloud/webrtc-client 0.25.3 → 0.26.0-rc.0

package/dist/index.d.mts

@@ -563,6 +563,24 @@ declare class WebRTCEndpoint extends WebRTCEndpoint_base {
      * ```
      */
     connect: (metadata: unknown) => void;
+    /**
+     * Returns the current audio level for a local audio track, if available.
+     *
+     * This method only works for local **audio** tracks that have been negotiated
+     * with the remote peer and for which an underlying `RTCRtpSender` and
+     * statistics are available.
+     *
+     * @param trackId - Identifier of the local track to query, as used when
+     * adding or managing local tracks on this endpoint.
+     * @returns A promise that resolves to `{ level: number }` when an audio
+     * level can be determined for the given track, or `null` if:
+     * - the track does not exist,
+     * - the track is not an audio track,
+     * - the track has not yet been negotiated / no sender exists
+     */
+    getLocalTrackAudioLevel(trackId: string): Promise<{
+        level: number;
+    } | null>;
     /**
      * Feeds media event received from RTC Engine to {@link WebRTCEndpoint}.
      * This function should be called whenever some media event from RTC Engine

package/dist/index.mjs

@@ -4236,6 +4236,18 @@ var LocalTrack = class {
       {}
     );
   };
+  getAudioLevel = async () => {
+    if (!this.sender) return null;
+    try {
+      const stats = await this.sender.getStats();
+      const source = [...stats.values()].find(
+        (r) => r.type === "media-source" && r.kind === "audio" && typeof r.audioLevel === "number"
+      );
+      return source ? { level: source.audioLevel } : null;
+    } catch {
+      return null;
+    }
+  };
   createTrackVariantBitratesEvent = () => {
   };
 };
@@ -4454,6 +4466,9 @@ var Local = class {
       localTrack.addTrackToConnection();
     });
   };
+  getLocalTrackAudioLevel = async (trackId) => {
+    return this.localTracks[trackId]?.getAudioLevel() ?? null;
+  };
 };
 
 // src/tracks/LocalTrackManager.ts
@@ -4785,6 +4800,24 @@ var WebRTCEndpoint = class extends EventEmitter3 {
     const connect = MediaEvent_Connect.create({ metadataJson: JSON.stringify(metadata) });
     this.sendMediaEvent({ connect });
   };
+  /**
+   * Returns the current audio level for a local audio track, if available.
+   *
+   * This method only works for local **audio** tracks that have been negotiated
+   * with the remote peer and for which an underlying `RTCRtpSender` and
+   * statistics are available.
+   *
+   * @param trackId - Identifier of the local track to query, as used when
+   * adding or managing local tracks on this endpoint.
+   * @returns A promise that resolves to `{ level: number }` when an audio
+   * level can be determined for the given track, or `null` if:
+   * - the track does not exist,
+   * - the track is not an audio track,
+   * - the track has not yet been negotiated / no sender exists
+   */
+  getLocalTrackAudioLevel(trackId) {
+    return this.local.getLocalTrackAudioLevel(trackId);
+  }
   /**
    * Feeds media event received from RTC Engine to {@link WebRTCEndpoint}.
    * This function should be called whenever some media event from RTC Engine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/webrtc-client",
-  "version": "0.25.3",
+  "version": "0.26.0-rc.0",
   "description": "Typescript client library for ExWebRTC/WebRTC endpoint in Membrane RTC Engine",
   "license": "Apache-2.0",
   "author": "Fishjam Team",