mediasoup-client 3.6.45 → 3.6.49

package/src/handlers/Chrome55.ts

@@ -454,7 +454,7 @@ export class Chrome55 extends HandlerInterface
 			{
 				logger.warn(
 					'stopSending() | ignoring expected error due no sending tracks: %s',
-					error.toString());
+					(error as Error).toString());
 
 				return;
 			}
@@ -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>

package/src/handlers/Chrome67.ts

@@ -462,7 +462,7 @@ export class Chrome67 extends HandlerInterface
 			{
 				logger.warn(
 					'stopSending() | ignoring expected error due no sending tracks: %s',
-					error.toString());
+					(error as Error).toString());
 
 				return;
 			}
@@ -657,24 +657,31 @@ export class Chrome67 extends HandlerInterface
 	}
 
 	async receive(
-		{ trackId, kind, rtpParameters }: HandlerReceiveOptions
-	): Promise<HandlerReceiveResult>
+		// eslint-disable-next-line @typescript-eslint/no-unused-vars
+		optionsList: HandlerReceiveOptions[]
+	) : Promise<HandlerReceiveResult[]>
 	{
 		this._assertRecvDirection();
 
-		logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+		const results: HandlerReceiveResult[] = [];
 
-		const localId = trackId;
-		const mid = kind;
+		for (const options of optionsList)
+		{
+			const { trackId, kind, rtpParameters } = options;
 
-		this._remoteSdp!.receive(
-			{
-				mid,
-				kind,
-				offerRtpParameters : rtpParameters,
-				streamId           : rtpParameters.rtcp!.cname!,
-				trackId
-			});
+			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() };
 
@@ -686,16 +693,22 @@ export class Chrome67 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) };
 
@@ -714,20 +727,28 @@ export class Chrome67 extends HandlerInterface
 
 		await this._pc.setLocalDescription(answer);
 
-		const rtpReceiver = this._pc.getReceivers()
-			.find((r: RTCRtpReceiver) => r.track && r.track.id === localId);
+		for (const options of optionsList)
+		{
+			const { kind, trackId, rtpParameters } = options;
+			const localId = trackId;
+			const mid = kind;
+			const rtpReceiver = this._pc.getReceivers()
+				.find((r: RTCRtpReceiver) => r.track && r.track.id === localId);
 
-		if (!rtpReceiver)
-			throw new Error('new RTCRtpReceiver not');
+			if (!rtpReceiver)
+				throw new Error('new RTCRtpReceiver not');
 
-		// Insert into the map.
-		this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters, rtpReceiver });
+			// Insert into the map.
+			this._mapRecvLocalIdInfo.set(localId, { mid, rtpParameters, rtpReceiver });
 
-		return {
-			localId,
-			track : rtpReceiver.track,
-			rtpReceiver
-		};
+			results.push({
+				localId,
+				track : rtpReceiver.track,
+				rtpReceiver
+			});
+		}
+
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>

package/src/handlers/Chrome70.ts

@@ -663,23 +663,30 @@ export class Chrome70 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 = rtpParameters.mid || String(this._mapMidTransceiver.size);
+		for (const options of optionsList)
+		{
+			const { trackId, kind, rtpParameters } = options;
 
-		this._remoteSdp!.receive(
-			{
-				mid                : localId,
-				kind,
-				offerRtpParameters : rtpParameters,
-				streamId           : rtpParameters.rtcp!.cname!,
-				trackId
-			});
+			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() };
 
@@ -691,16 +698,22 @@ export class Chrome70 extends HandlerInterface
 
 		let answer = await this._pc.createAnswer();
 		const localSdpObject = sdpTransform.parse(answer.sdp);
-		const answerMediaObject = localSdpObject.media
-			.find((m: any) => 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: any) => 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) };
 
@@ -719,20 +732,27 @@ export class Chrome70 extends HandlerInterface
 
 		await this._pc.setLocalDescription(answer);
 
-		const transceiver = this._pc.getTransceivers()
-			.find((t: RTCRtpTransceiver) => t.mid === localId);
+		for (const options of optionsList)
+		{
+			const { rtpParameters } = options;
+			const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
+			const transceiver = this._pc.getTransceivers()
+				.find((t: RTCRtpTransceiver) => t.mid === localId);
 
-		if (!transceiver)
-			throw new Error('new RTCRtpTransceiver not found');
+			if (!transceiver)
+				throw new Error('new RTCRtpTransceiver not found');
 
-		// Store in the map.
-		this._mapMidTransceiver.set(localId, transceiver);
+			// Store in the map.
+			this._mapMidTransceiver.set(localId, transceiver);
 
-		return {
-			localId,
-			track       : transceiver.receiver.track,
-			rtpReceiver : transceiver.receiver
-		};
+			results.push({
+				localId,
+				track       : transceiver.receiver.track,
+				rtpReceiver : transceiver.receiver
+			});
+		}
+
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>

package/src/handlers/Chrome74.ts

@@ -649,23 +649,30 @@ export class Chrome74 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 = rtpParameters.mid || String(this._mapMidTransceiver.size);
+		for (const options of optionsList)
+		{
+			const { trackId, kind, rtpParameters } = options;
 
-		this._remoteSdp!.receive(
-			{
-				mid                : localId,
-				kind,
-				offerRtpParameters : rtpParameters,
-				streamId           : rtpParameters.rtcp!.cname!,
-				trackId
-			});
+			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() };
 
@@ -677,16 +684,22 @@ export class Chrome74 extends HandlerInterface
 
 		let answer = await this._pc.createAnswer();
 		const localSdpObject = sdpTransform.parse(answer.sdp);
-		const answerMediaObject = localSdpObject.media
-			.find((m: any) => 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: any) => 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) };
 
@@ -705,20 +718,31 @@ export class Chrome74 extends HandlerInterface
 
 		await this._pc.setLocalDescription(answer);
 
-		const transceiver = this._pc.getTransceivers()
-			.find((t: RTCRtpTransceiver) => t.mid === localId);
+		for (const options of optionsList)
+		{
+			const { rtpParameters } = options;
+			const localId = rtpParameters.mid || String(this._mapMidTransceiver.size);
+			const transceiver = this._pc.getTransceivers()
+				.find((t: RTCRtpTransceiver) => t.mid === localId);
 
-		if (!transceiver)
-			throw new Error('new RTCRtpTransceiver not found');
+			if (!transceiver)
+			{
+				throw new Error('new RTCRtpTransceiver not found');
+			}
+			else
+			{
+				// Store in the map.
+				this._mapMidTransceiver.set(localId, transceiver);
 
-		// Store in the map.
-		this._mapMidTransceiver.set(localId, transceiver);
+				results.push({
+					localId,
+					track       : transceiver.receiver.track,
+					rtpReceiver : transceiver.receiver
+				});
+			}
+		}
 
-		return {
-			localId,
-			track       : transceiver.receiver.track,
-			rtpReceiver : transceiver.receiver
-		};
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>

package/src/handlers/Edge11.ts

@@ -361,44 +361,58 @@ export class Edge11 extends HandlerInterface
 	}
 
 	async receive(
-		{ trackId, kind, rtpParameters }: HandlerReceiveOptions
-	): Promise<HandlerReceiveResult>
+		optionsList: HandlerReceiveOptions[]
+	) : Promise<HandlerReceiveResult[]>
 	{
-		logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+		const results: HandlerReceiveResult[] = [];
+
+		for (const options of optionsList)
+		{
+			const { trackId, kind } = options;
+
+			logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+		}
 
 		if (!this._transportReady)
 			await this._setupTransport({ localDtlsRole: 'server' });
 
-		logger.debug('receive() | calling new RTCRtpReceiver()');
+		for (const options of optionsList)
+		{
+			const { trackId, kind, rtpParameters } = options;
 
-		const rtpReceiver = new (RTCRtpReceiver as any)(this._dtlsTransport, kind);
+			logger.debug('receive() | calling new RTCRtpReceiver()');
 
-		rtpReceiver.addEventListener('error', (event: any) =>
-		{
-			logger.error('rtpReceiver "error" event [event:%o]', event);
-		});
+			const rtpReceiver = new (RTCRtpReceiver as any)(this._dtlsTransport, kind);
 
-		// NOTE: Convert our standard RTCRtpParameters into those that Edge
-		// expects.
-		const edgeRtpParameters =
-			edgeUtils.mangleRtpParameters(rtpParameters);
+			rtpReceiver.addEventListener('error', (event: any) =>
+			{
+				logger.error('rtpReceiver "error" event [event:%o]', event);
+			});
 
-		logger.debug(
-			'receive() | calling rtpReceiver.receive() [params:%o]',
-			edgeRtpParameters);
+			// NOTE: Convert our standard RTCRtpParameters into those that Edge
+			// expects.
+			const edgeRtpParameters =
+				edgeUtils.mangleRtpParameters(rtpParameters);
 
-		await rtpReceiver.receive(edgeRtpParameters);
+			logger.debug(
+				'receive() | calling rtpReceiver.receive() [params:%o]',
+				edgeRtpParameters);
 
-		const localId = trackId;
+			await rtpReceiver.receive(edgeRtpParameters);
 
-		// Store it.
-		this._rtpReceivers.set(localId, rtpReceiver);
+			const localId = trackId;
 
-		return {
-			localId,
-			track : rtpReceiver.track,
-			rtpReceiver
-		};
+			// Store it.
+			this._rtpReceivers.set(localId, rtpReceiver);
+
+			results.push({
+				localId,
+				track : rtpReceiver.track,
+				rtpReceiver
+			});
+		}
+
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>
@@ -461,6 +475,7 @@ export class Edge11 extends HandlerInterface
 		{ iceServers?: any[]; iceTransportPolicy?: RTCIceTransportPolicy }
 	): void
 	{
+		// @ts-ignore
 		const iceGatherer = new (RTCIceGatherer as any)(
 			{
 				iceServers   : iceServers || [],
@@ -480,7 +495,8 @@ export class Edge11 extends HandlerInterface
 		catch (error)
 		{
 			logger.debug(
-				'_setIceGatherer() | iceGatherer.gather() failed: %s', error.toString());
+				'_setIceGatherer() | iceGatherer.gather() failed: %s',
+				(error as Error).toString());
 		}
 
 		this._iceGatherer = iceGatherer;

package/src/handlers/FakeHandler.ts

@@ -324,21 +324,29 @@ export class FakeHandler extends HandlerInterface
 	}
 
 	async receive(
-	// eslint-disable-next-line @typescript-eslint/no-unused-vars
-		{ trackId, kind, rtpParameters }: HandlerReceiveOptions
-	): Promise<HandlerReceiveResult>
+		optionsList: HandlerReceiveOptions[]
+	) : Promise<HandlerReceiveResult[]>
 	{
-		if (!this._transportReady)
-			await this._setupTransport({ localDtlsRole: 'client' });
+		const results: HandlerReceiveResult[] = [];
 
-		logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+		for (const options of optionsList)
+		{
+			const { trackId, kind } = options;
 
-		const localId = this._nextLocalId++;
-		const track = new FakeMediaStreamTrack({ kind });
+			if (!this._transportReady)
+				await this._setupTransport({ localDtlsRole: 'client' });
 
-		this._tracks.set(localId, track);
+			logger.debug('receive() [trackId:%s, kind:%s]', trackId, kind);
+
+			const localId = this._nextLocalId++;
+			const track = new FakeMediaStreamTrack({ kind });
+
+			this._tracks.set(localId, track);
+
+			results.push({ localId: String(localId), track });
+		}
 
-		return { localId: String(localId), track };
+		return results;
 	}
 
 	async stopReceiving(localId: string): Promise<void>