mediasoup-client 3.6.47 → 3.6.48

package/lib/handlers/Safari11.js

@@ -399,32 +399,39 @@ class Safari11 extends HandlerInterface_1.HandlerInterface {
         };
         return { dataChannel, sctpStreamParameters };
     }
-    async receive({ trackId, kind, rtpParameters }) {
+    async receive(optionsList) {
         var _a;
         this._assertRecvDirection();
-        logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
-        const localId = trackId;
-        const mid = kind;
-        this._remoteSdp.receive({
-            mid,
-            kind,
-            offerRtpParameters: rtpParameters,
-            streamId: rtpParameters.rtcp.cname,
-            trackId
-        });
+        const results = [];
+        for (const options of optionsList) {
+            const { trackId, kind, rtpParameters } = options;
+            logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+            const mid = kind;
+            this._remoteSdp.receive({
+                mid,
+                kind,
+                offerRtpParameters: rtpParameters,
+                streamId: rtpParameters.rtcp.cname,
+                trackId
+            });
+        }
         const offer = { type: 'offer', sdp: this._remoteSdp.getSdp() };
         logger.debug('receive() | calling pc.setRemoteDescription() [offer:%o]', offer);
         await this._pc.setRemoteDescription(offer);
         let answer = await this._pc.createAnswer();
         const localSdpObject = sdpTransform.parse(answer.sdp);
-        const answerMediaObject = localSdpObject.media
-            .find((m) => String(m.mid) === mid);
-        // May need to modify codec parameters in the answer based on codec
-        // parameters in the offer.
-        sdpCommonUtils.applyCodecParameters({
-            offerRtpParameters: rtpParameters,
-            answerMediaObject
-        });
+        for (const options of optionsList) {
+            const { kind, rtpParameters } = options;
+            const mid = kind;
+            const answerMediaObject = localSdpObject.media
+                .find((m) => String(m.mid) === mid);
+            // May need to modify codec parameters in the answer based on codec
+            // parameters in the offer.
+            sdpCommonUtils.applyCodecParameters({
+                offerRtpParameters: rtpParameters,
+                answerMediaObject
+            });
+        }
         answer = { type: 'answer', sdp: sdpTransform.write(localSdpObject) };
         if (!this._transportReady) {
             await this._setupTransport({
@@ -434,17 +441,23 @@ class Safari11 extends HandlerInterface_1.HandlerInterface {
         }
         logger.debug('receive() | calling pc.setLocalDescription() [answer:%o]', answer);
         await this._pc.setLocalDescription(answer);
-        const rtpReceiver = this._pc.getReceivers()
-            .find((r) => r.track && r.track.id === localId);
-        if (!rtpReceiver)
-            throw new Error('new RTCRtpReceiver not');
-        // Insert into the map.
-        this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters, rtpReceiver });
-        return {
-            localId,
-            track: rtpReceiver.track,
-            rtpReceiver
-        };
+        for (const options of optionsList) {
+            const { kind, trackId, rtpParameters } = options;
+            const mid = kind;
+            const localId = trackId;
+            const rtpReceiver = this._pc.getReceivers()
+                .find((r) => r.track && r.track.id === localId);
+            if (!rtpReceiver)
+                throw new Error('new RTCRtpReceiver not');
+            // Insert into the map.
+            this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters, rtpReceiver });
+            results.push({
+                localId,
+                track: rtpReceiver.track,
+                rtpReceiver
+            });
+        }
+        return results;
     }
     async stopReceiving(localId) {
         this._assertRecvDirection();

package/lib/handlers/Safari12.d.ts

@@ -34,7 +34,7 @@ export declare class Safari12 extends HandlerInterface {
     setRtpEncodingParameters(localId: string, params: any): Promise<void>;
     getSenderStats(localId: string): Promise<RTCStatsReport>;
     sendDataChannel({ ordered, maxPacketLifeTime, maxRetransmits, label, protocol }: HandlerSendDataChannelOptions): Promise<HandlerSendDataChannelResult>;
-    receive({ trackId, kind, rtpParameters }: HandlerReceiveOptions): Promise<HandlerReceiveResult>;
+    receive(optionsList: HandlerReceiveOptions[]): Promise<HandlerReceiveResult[]>;
     stopReceiving(localId: string): Promise<void>;
     pauseReceiving(localId: string): Promise<void>;
     resumeReceiving(localId: string): Promise<void>;

package/lib/handlers/Safari12.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Safari12.d.ts","sourceRoot":"","sources":["../../src/handlers/Safari12.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Safari12.d.ts","sourceRoot":"","sources":["../../src/handlers/Safari12.ts"],"names":[],"mappings":"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"}

package/lib/handlers/Safari12.js

@@ -372,31 +372,39 @@ class Safari12 extends HandlerInterface_1.HandlerInterface {
         };
         return { dataChannel, sctpStreamParameters };
     }
-    async receive({ trackId, kind, rtpParameters }) {
+    async receive(optionsList) {
         var _a;
         this._assertRecvDirection();
-        logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
-        const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
-        this._remoteSdp.receive({
-            mid: localId,
-            kind,
-            offerRtpParameters: rtpParameters,
-            streamId: rtpParameters.rtcp.cname,
-            trackId
-        });
+        const results = [];
+        for (const options of optionsList) {
+            const { trackId, kind, rtpParameters } = options;
+            logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+            const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
+            this._remoteSdp.receive({
+                mid: localId,
+                kind,
+                offerRtpParameters: rtpParameters,
+                streamId: rtpParameters.rtcp.cname,
+                trackId
+            });
+        }
         const offer = { type: 'offer', sdp: this._remoteSdp.getSdp() };
         logger.debug('receive() | calling pc.setRemoteDescription() [offer:%o]', offer);
         await this._pc.setRemoteDescription(offer);
         let answer = await this._pc.createAnswer();
         const localSdpObject = sdpTransform.parse(answer.sdp);
-        const answerMediaObject = localSdpObject.media
-            .find((m) => String(m.mid) === localId);
-        // May need to modify codec parameters in the answer based on codec
-        // parameters in the offer.
-        sdpCommonUtils.applyCodecParameters({
-            offerRtpParameters: rtpParameters,
-            answerMediaObject
-        });
+        for (const options of optionsList) {
+            const { rtpParameters } = options;
+            const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
+            const answerMediaObject = localSdpObject.media
+                .find((m) => String(m.mid) === localId);
+            // May need to modify codec parameters in the answer based on codec
+            // parameters in the offer.
+            sdpCommonUtils.applyCodecParameters({
+                offerRtpParameters: rtpParameters,
+                answerMediaObject
+            });
+        }
         answer = { type: 'answer', sdp: sdpTransform.write(localSdpObject) };
         if (!this._transportReady) {
             await this._setupTransport({
@@ -406,17 +414,22 @@ class Safari12 extends HandlerInterface_1.HandlerInterface {
         }
         logger.debug('receive() | calling pc.setLocalDescription() [answer:%o]', answer);
         await this._pc.setLocalDescription(answer);
-        const transceiver = this._pc.getTransceivers()
-            .find((t) => t.mid === localId);
-        if (!transceiver)
-            throw new Error('new RTCRtpTransceiver not found');
-        // Store in the map.
-        this._mapMidTransceiver.set(localId, transceiver);
-        return {
-            localId,
-            track: transceiver.receiver.track,
-            rtpReceiver: transceiver.receiver
-        };
+        for (const options of optionsList) {
+            const { rtpParameters } = options;
+            const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
+            const transceiver = this._pc.getTransceivers()
+                .find((t) => t.mid === localId);
+            if (!transceiver)
+                throw new Error('new RTCRtpTransceiver not found');
+            // Store in the map.
+            this._mapMidTransceiver.set(localId, transceiver);
+            results.push({
+                localId,
+                track: transceiver.receiver.track,
+                rtpReceiver: transceiver.receiver
+            });
+        }
+        return results;
     }
     async stopReceiving(localId) {
         this._assertRecvDirection();

package/lib/index.d.ts

@@ -8,7 +8,7 @@ export { types };
 /**
  * Expose mediasoup-client version.
  */
-export declare const version = "3.6.47";
+export declare const version = "3.6.48";
 /**
  * Expose Device class and detectDevice() helper.
  */

package/lib/index.js

@@ -33,7 +33,7 @@ exports.types = types;
 /**
  * Expose mediasoup-client version.
  */
-exports.version = '3.6.47';
+exports.version = '3.6.48';
 /**
  * Expose parseScalabilityMode() function.
  */

package/lib/ortc.js

@@ -780,7 +780,6 @@ function matchCodecs(aCodec, bCodec, { strict = false, modify = false } = {}) {
     switch (aMimeType) {
         case 'video/h264':
             {
-                // If strict matching check profile-level-id.
                 if (strict) {
                     const aPacketizationMode = aCodec.parameters['packetization-mode'] || 0;
                     const bPacketizationMode = bCodec.parameters['packetization-mode'] || 0;
@@ -811,7 +810,6 @@ function matchCodecs(aCodec, bCodec, { strict = false, modify = false } = {}) {
             }
         case 'video/vp9':
             {
-                // If strict matching check profile-id.
                 if (strict) {
                     const aProfileId = aCodec.parameters['profile-id'] || 0;
                     const bProfileId = bCodec.parameters['profile-id'] || 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mediasoup-client",
-  "version": "3.6.47",
+  "version": "3.6.48",
   "description": "mediasoup client side JavaScript library",
   "contributors": [
     "Iñaki Baz Castillo <ibc@aliax.net> (https://inakibaz.me)",
@@ -39,25 +39,25 @@
     "@types/events": "^3.0.0",
     "awaitqueue": "^2.3.3",
     "bowser": "^2.11.0",
-    "debug": "^4.3.2",
+    "debug": "^4.3.3",
     "events": "^3.3.0",
     "fake-mediastreamtrack": "^1.1.6",
     "h264-profile-level-id": "^1.0.1",
     "sdp-transform": "^2.14.1",
-    "supports-color": "^9.1.0"
+    "supports-color": "^9.2.1"
   },
   "devDependencies": {
     "@types/sdp-transform": "^2.4.5",
     "@types/uuid": "^3.4.9",
-    "@typescript-eslint/eslint-plugin": "^5.4.0",
-    "@typescript-eslint/parser": "^5.4.0",
-    "eslint": "^8.3.0",
-    "eslint-plugin-jest": "^25.3.0",
-    "jest": "^27.3.1",
+    "@typescript-eslint/eslint-plugin": "^5.9.1",
+    "@typescript-eslint/parser": "^5.9.1",
+    "eslint": "^8.6.0",
+    "eslint-plugin-jest": "^25.3.4",
+    "jest": "^27.4.7",
     "jest-tobetype": "^1.2.3",
     "open-cli": "^7.0.1",
-    "tsc-watch": "^4.5.0",
-    "typescript": "^4.5.2",
+    "tsc-watch": "^4.6.0",
+    "typescript": "^4.5.4",
     "uuid": "^3.4.0"
   }
 }

package/src/Transport.ts

@@ -4,7 +4,7 @@ import { EnhancedEventEmitter } from './EnhancedEventEmitter';
 import { UnsupportedError, InvalidStateError } from './errors';
 import * as utils from './utils';
 import * as ortc from './ortc';
-import { HandlerFactory, HandlerInterface } from './handlers/HandlerInterface';
+import { HandlerFactory, HandlerInterface, HandlerReceiveOptions } from './handlers/HandlerInterface';
 import { Producer, ProducerOptions } from './Producer';
 import { Consumer, ConsumerOptions } from './Consumer';
 import { DataProducer, DataProducerOptions } from './DataProducer';
@@ -19,6 +19,24 @@ interface InternalTransportOptions extends TransportOptions
 	canProduceByKind: CanProduceByKind;
 }
 
+class ConsumerCreationTask
+{
+	consumerOptions: ConsumerOptions;
+	promise: Promise<Consumer>;
+	resolve?: (consumer: Consumer) => void;
+	reject?: (error: Error) => void;
+
+	constructor(consumerOptions: ConsumerOptions)
+	{
+		this.consumerOptions = consumerOptions;
+		this.promise = new Promise((resolve, reject) =>
+		{
+			this.resolve = resolve;
+			this.reject = reject;
+		});
+	}
+}
+
 export type TransportOptions =
 {
 	id: string;
@@ -165,6 +183,10 @@ export class Transport extends EnhancedEventEmitter
 	private _probatorConsumerCreated = false;
 	// AwaitQueue instance to make async tasks happen sequentially.
 	private readonly _awaitQueue = new AwaitQueue({ ClosedErrorClass: InvalidStateError });
+	// Consumer creation tasks awaiting to be processed.
+	private _pendingConsumerTasks: ConsumerCreationTask[] = [];
+	// Consumer creation in progress flag.
+	private _consumerCreationInProgress = false;
 	// Observer instance.
 	protected readonly _observer = new EnhancedEventEmitter();
 
@@ -583,68 +605,33 @@ export class Transport extends EnhancedEventEmitter
 		else if (appData && typeof appData !== 'object')
 			throw new TypeError('if given, appData must be an object');
 
-		// Enqueue command.
-		return this._awaitQueue.push(
-			async () =>
-			{
-				// Ensure the device can consume it.
-				const canConsume = ortc.canReceive(
-					rtpParameters, this._extendedRtpCapabilities);
-
-				if (!canConsume)
-					throw new UnsupportedError('cannot consume this Producer');
-
-				const { localId, rtpReceiver, track } =
-					await this._handler.receive({ trackId: id, kind, rtpParameters });
-
-				const consumer = new Consumer(
-					{
-						id,
-						localId,
-						producerId,
-						rtpReceiver,
-						track,
-						rtpParameters,
-						appData
-					});
-
-				this._consumers.set(consumer.id, consumer);
-				this._handleConsumer(consumer);
-
-				// If this is the first video Consumer and the Consumer for RTP probation
-				// has not yet been created, create it now.
-				if (!this._probatorConsumerCreated && kind === 'video')
-				{
-					try
-					{
-						const probatorRtpParameters =
-							ortc.generateProbatorRtpParameters(consumer.rtpParameters);
+		// Ensure the device can consume it.
+		const canConsume = ortc.canReceive(
+			rtpParameters, this._extendedRtpCapabilities);
 
-						await this._handler.receive(
-							{
-								trackId       : 'probator',
-								kind          : 'video',
-								rtpParameters : probatorRtpParameters
-							});
+		if (!canConsume)
+			throw new UnsupportedError('cannot consume this Producer');
 
-						logger.debug('consume() | Consumer for RTP probation created');
+		const consumerCreationTask = new ConsumerCreationTask(
+			{
+				id,
+				producerId,
+				kind,
+				rtpParameters,
+				appData
+			}
+		);
 
-						this._probatorConsumerCreated = true;
-					}
-					catch (error)
-					{
-						logger.error(
-							'consume() | failed to create Consumer for RTP probation:%o',
-							error);
-					}
-				}
+		// Store the Consumer creation task.
+		this._pendingConsumerTasks.push(consumerCreationTask);
 
-				// Emit observer event.
-				this._observer.safeEmit('newconsumer', consumer);
+		// There is no Consumer creation in progress, create it now.
+		if (this._consumerCreationInProgress === false)
+		{
+			this._createPendingConsumers();
+		}
 
-				return consumer;
-			},
-			'transport.consume()');
+		return consumerCreationTask.promise;
 	}
 
 	/**
@@ -788,6 +775,123 @@ export class Transport extends EnhancedEventEmitter
 			'transport.consumeData()');
 	}
 
+	// This method is guaranteed to never throw.
+	async _createPendingConsumers(): Promise<void>
+	{
+		this._awaitQueue.push(
+			async () =>
+			{
+				this._consumerCreationInProgress = true;
+
+				const pendingConsumerTasks = [ ...this._pendingConsumerTasks ];
+
+				// Clear pending Consumer tasks.
+				this._pendingConsumerTasks = [];
+
+				// Video Consumer in order to create the probator.
+				let videoConsumerForProbator: Consumer | undefined = undefined;
+
+				// Fill options list.
+				const optionsList: HandlerReceiveOptions[] = [];
+
+				for (const task of pendingConsumerTasks)
+				{
+					const { id, kind, rtpParameters } = task.consumerOptions;
+
+					optionsList.push({
+						trackId : id!,
+						kind    : kind as 'audio' | 'video',
+						rtpParameters
+					});
+				}
+
+				try
+				{
+					const results = await this._handler.receive(optionsList);
+
+					for (let idx=0; idx < results.length; idx++)
+					{
+						const task = pendingConsumerTasks[idx];
+						const result = results[idx];
+						const { id, producerId, kind, rtpParameters, appData } = task.consumerOptions;
+						const { localId, rtpReceiver, track } = result;
+						const consumer = new Consumer(
+							{
+								id         : id!,
+								localId,
+								producerId : producerId!,
+								rtpReceiver,
+								track,
+								rtpParameters,
+								appData
+							});
+
+						this._consumers.set(consumer.id, consumer);
+						this._handleConsumer(consumer);
+
+						// If this is the first video Consumer and the Consumer for RTP probation
+						// has not yet been created, it's time to create it.
+						if (!this._probatorConsumerCreated && !videoConsumerForProbator && kind === 'video')
+						{
+							videoConsumerForProbator = consumer;
+						}
+
+						// Emit observer event.
+						this._observer.safeEmit('newconsumer', consumer);
+
+						task.resolve!(consumer);
+					}
+				}
+				catch (error)
+				{
+					for (const task of pendingConsumerTasks)
+					{
+						task.reject!(error as Error);
+					}
+				}
+
+				// If RTP probation must be handled, do it now.
+				if (videoConsumerForProbator)
+				{
+					try
+					{
+						const probatorRtpParameters =
+							ortc.generateProbatorRtpParameters(videoConsumerForProbator!.rtpParameters);
+
+						await this._handler.receive(
+							[ {
+								trackId       : 'probator',
+								kind          : 'video',
+								rtpParameters : probatorRtpParameters
+							} ]);
+
+						logger.debug('_createPendingConsumers() | Consumer for RTP probation created');
+
+						this._probatorConsumerCreated = true;
+					}
+					catch (error)
+					{
+						logger.error(
+							'_createPendingConsumers() | failed to create Consumer for RTP probation:%o',
+							error);
+					}
+				}
+
+				this._consumerCreationInProgress = false;
+			},
+			'transport._createPendingConsumers()')
+			.then(() =>
+			{
+				// There are pending Consumer tasks, enqueue their creation.
+				if (this._pendingConsumerTasks.length > 0)
+				{
+					this._createPendingConsumers();
+				}
+			})
+			// NOTE: We only get here when the await queue is closed.
+			.catch(() => {});
+	}
+
 	_handleHandler(): void
 	{
 		const handler = this._handler;

package/src/handlers/Chrome55.ts

@@ -580,25 +580,31 @@ export class Chrome55 extends HandlerInterface
 	}
 
 	async receive(
-		{ trackId, kind, rtpParameters }: HandlerReceiveOptions
-	): Promise<HandlerReceiveResult>
+		optionsList: HandlerReceiveOptions[]
+	) : Promise<HandlerReceiveResult[]>
 	{
 		this._assertRecvDirection();
 
-		logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+		const results: HandlerReceiveResult[] = [];
 
-		const localId = trackId;
-		const mid = kind;
-		const streamId = rtpParameters.rtcp!.cname!;
+		for (const options of optionsList)
+		{
+			const { trackId, kind, rtpParameters } = options;
 
-		this._remoteSdp!.receive(
-			{
-				mid,
-				kind,
-				offerRtpParameters : rtpParameters,
-				streamId,
-				trackId
-			});
+			logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+
+			const mid = kind;
+			const streamId = rtpParameters.rtcp!.cname!;
+
+			this._remoteSdp!.receive(
+				{
+					mid,
+					kind,
+					offerRtpParameters : rtpParameters,
+					streamId,
+					trackId
+				});
+		}
 
 		const offer = { type: 'offer', sdp: this._remoteSdp!.getSdp() };
 
@@ -610,16 +616,22 @@ export class Chrome55 extends HandlerInterface
 
 		let answer = await this._pc.createAnswer();
 		const localSdpObject = sdpTransform.parse(answer.sdp);
-		const answerMediaObject = localSdpObject.media
-			.find((m: any) => String(m.mid) === mid);
 
-		// May need to modify codec parameters in the answer based on codec
-		// parameters in the offer.
-		sdpCommonUtils.applyCodecParameters(
-			{
-				offerRtpParameters : rtpParameters,
-				answerMediaObject
-			});
+		for (const options of optionsList)
+		{
+			const { kind, rtpParameters } = options;
+			const mid = kind;
+			const answerMediaObject = localSdpObject.media
+				.find((m: any) => String(m.mid) === mid);
+
+			// May need to modify codec parameters in the answer based on codec
+			// parameters in the offer.
+			sdpCommonUtils.applyCodecParameters(
+				{
+					offerRtpParameters : rtpParameters,
+					answerMediaObject
+				});
+		}
 
 		answer = { type: 'answer', sdp: sdpTransform.write(localSdpObject) };
 
@@ -638,17 +650,26 @@ export class Chrome55 extends HandlerInterface
 
 		await this._pc.setLocalDescription(answer);
 
-		const stream = this._pc.getRemoteStreams()
-			.find((s: any) => s.id === streamId);
-		const track = stream.getTrackById(localId);
+		for (const options of optionsList)
+		{
+			const { kind, trackId, rtpParameters } = options;
+			const mid = kind;
+			const localId = trackId;
+			const streamId = rtpParameters.rtcp!.cname!;
+			const stream = this._pc.getRemoteStreams()
+				.find((s: any) => s.id === streamId);
+			const track = stream.getTrackById(localId);
 
-		if (!track)
-			throw new Error('remote track not found');
+			if (!track)
+				throw new Error('remote track not found');
 
-		// Insert into the map.
-		this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters });
+			// Insert into the map.
+			this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters });
+
+			results.push({ localId, track });
+		}
 
-		return { localId, track };
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>