mediasoup 3.20.5 → 3.20.7

package/worker/include/RTC/SCTP/association/StateCookie.hpp

@@ -6,7 +6,6 @@
 #include "RTC/SCTP/public/SctpTypes.hpp"
 #include "RTC/Serializable.hpp"
 #include "Utils.hpp"
-#include <string_view>
 
 namespace RTC
 {
@@ -58,6 +57,28 @@ namespace RTC
 		 *   Interleaving (I-DATA).
 		 * - Flag C (reconfig): Stream Reconfiguration.
 		 * - Flag D (zeroChecksum): Zero Checksum.
+		 *
+		 * When State Cookie authentication is enabled (see
+		 * `SctpOptions::requireAuthenticatedCookie`), two extra fields are appended
+		 * after the Negotiated Capabilities so the receiver can verify that the
+		 * cookie was generated by itself and is not stale:
+		 *
+		 *  0                   1                   2                   3
+		 *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |                       Creation Timestamp                      |
+		 * |                                                               |
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * \                                                               \
+		 * /            MAC (HMAC-SHA1 over all preceding bytes)           /
+		 * \                                                               \
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 *
+		 * The MAC is keyed with a per-association secret that never leaves the
+		 * worker, making the cookie unforgeable. The Creation Timestamp (in ms) is
+		 * used to detect stale cookies.
+		 *
+		 * @see RFC 9260 sections 5.1.3 and 5.1.4.
 		 */
 		class StateCookie : public Serializable
 		{
@@ -84,7 +105,8 @@ namespace RTC
 			};
 
 		public:
-			// Fixed total length of our generated State Cookies.
+			// Fixed length of our generated State Cookies when authentication is
+			// disabled.
 			static constexpr size_t StateCookieLength{ 44 };
 			// Offset in the State Cookie where the Negotiated Capabilitied are
 			// located.
@@ -95,13 +117,27 @@ namespace RTC
 			static constexpr size_t Magic1Length{ 8 };
 			// Magic value used within the Negotiated Capabilities block.
 			static constexpr uint16_t Magic2{ 0xAD81 };
+			// Offset of the creation timestamp present in authenticated State
+			// Cookies.
+			static constexpr size_t TimestampOffset{ StateCookie::StateCookieLength };
+			// Length of the creation timestamp field (a uint64_t with the time in
+			// milliseconds).
+			static constexpr size_t TimestampLength{ 8 };
+			// Offset of the MAC present in authenticated State Cookies.
+			static constexpr size_t MacOffset{ StateCookie::TimestampOffset + StateCookie::TimestampLength };
+			// Length of the MAC. We use HMAC-SHA1 so it's 20 bytes.
+			static constexpr size_t MacLength{ 20 };
+			// Fixed length of our generated State Cookies when authentication is
+			// enabled.
+			static constexpr size_t AuthenticatedStateCookieLength{ StateCookie::MacOffset +
+				                                                      StateCookie::MacLength };
+			// State Cookie lifespan (Valid.Cookie.Life) in milliseconds. Used to
+			// reject stale authenticated cookies.
+			//
+			// @see RFC 9260 section 16.
+			static constexpr uint64_t ValidCookieLifeMs{ 60000 };
 
 		public:
-			/**
-			 * Whether the given buffer is a StateCookie generated by mediasoup.
-			 */
-			static bool IsMediasoupStateCookie(const uint8_t* buffer, size_t bufferLength);
-
 			/**
 			 * Parse a StateCookie supposely generated by mediasoup.
 			 *
@@ -114,8 +150,11 @@ namespace RTC
 			 * Create a StateCookie.
 			 *
 			 * @remarks
-			 * `bufferLength` could be greater than the real length of the State
-			 * cookie.
+			 * - `bufferLength` could be greater than the real length of the State
+			 *   cookie.
+			 * - If `macKey` is not nullptr, an authenticated cookie (with creation
+			 *   timestamp and MAC) is generated. Otherwise a plain cookie is
+			 *   generated and `creationTimestampMs`/`macKey` are ignored.
 			 */
 			static StateCookie* Factory(
 			  uint8_t* buffer,
@@ -126,10 +165,18 @@ namespace RTC
 			  uint32_t remoteInitialTsn,
 			  uint32_t remoteAdvertisedReceiverWindowCredit,
 			  uint64_t tieTag,
-			  const NegotiatedCapabilities& negotiatedCapabilities);
+			  const NegotiatedCapabilities& negotiatedCapabilities,
+			  uint64_t creationTimestampMs = 0,
+			  const uint8_t* macKey        = nullptr,
+			  size_t macKeyLength          = 0);
 
 			/**
 			 * Serialize a StateCookie (based on given arguments) in the given buffer.
+			 *
+			 * @remarks
+			 * - If `macKey` is not nullptr, an authenticated cookie (with creation
+			 *   timestamp and MAC) is generated. Otherwise a plain cookie is
+			 *   generated and `creationTimestampMs`/`macKey` are ignored.
 			 */
 			static void Write(
 			  uint8_t* buffer,
@@ -140,7 +187,33 @@ namespace RTC
 			  uint32_t remoteInitialTsn,
 			  uint32_t remoteAdvertisedReceiverWindowCredit,
 			  uint64_t tieTag,
-			  const NegotiatedCapabilities& negotiatedCapabilities);
+			  const NegotiatedCapabilities& negotiatedCapabilities,
+			  uint64_t creationTimestampMs = 0,
+			  const uint8_t* macKey        = nullptr,
+			  size_t macKeyLength          = 0);
+
+			/**
+			 * Whether the given buffer is a StateCookie generated by mediasoup.
+			 *
+			 * @remarks
+			 * - This only checks magic values and length. It does NOT verify the
+			 *   MAC of authenticated cookies (which requires the per-association
+			 *   secret). Use `VerifyMac()` for that.
+			 */
+			static bool IsMediasoupStateCookie(const uint8_t* buffer, size_t bufferLength);
+
+			/**
+			 * Verify the MAC of an authenticated StateCookie generated by mediasoup.
+			 *
+			 * @remarks
+			 * - Returns false if the buffer is not an authenticated cookie (i.e. its
+			 *   length is not `AuthenticatedStateCookieLength`) or if the MAC doesn't
+			 *   match the one computed with the given secret key.
+			 *
+			 * @see RFC 9260 section 5.1.4.
+			 */
+			static bool VerifyMac(
+			  const uint8_t* buffer, size_t bufferLength, const uint8_t* macKey, size_t macKeyLength);
 
 			/**
 			 * Determine the SCTP implementation of the generator of State Cookie
@@ -218,6 +291,26 @@ namespace RTC
 			 */
 			NegotiatedCapabilities GetNegotiatedCapabilities() const;
 
+			/**
+			 * Whether this is an authenticated StateCookie (i.e. it carries a
+			 * creation timestamp and a MAC).
+			 */
+			bool IsAuthenticated() const
+			{
+				return GetLength() == StateCookie::AuthenticatedStateCookieLength;
+			}
+
+			/**
+			 * The time (in milliseconds) at which this StateCookie was created.
+			 *
+			 * @remarks
+			 * - Only meaningful in authenticated cookies (see `IsAuthenticated()`).
+			 */
+			uint64_t GetCreationTimestampMs() const
+			{
+				return Utils::Byte::Get8Bytes(GetBuffer(), StateCookie::TimestampOffset);
+			}
+
 		private:
 			NegotiatedCapabilitiesField* GetNegotiatedCapabilitiesField() const
 			{

package/worker/include/RTC/SCTP/packet/Chunk.hpp

@@ -145,7 +145,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t ChunkHeaderLength{ 4 };
+			static constexpr size_t ChunkHeaderLength{ 4 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/ErrorCause.hpp

@@ -85,7 +85,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t ErrorCauseHeaderLength{ 4 };
+			static constexpr size_t ErrorCauseHeaderLength{ 4 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/Packet.hpp

@@ -70,7 +70,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t CommonHeaderLength{ 12 };
+			static constexpr size_t CommonHeaderLength{ 12 };
 
 			/**
 			 * Whether given buffer could be a valid SCTP packet.
@@ -94,7 +94,6 @@ namespace RTC
 			 * Create an SCTP packet.
 			 *
 			 * @remarks
-			 * - `bufferLength` must be the exact length of the STUN packet.
 			 * - If `transactionId` is not given then a random Transaction ID is
 			 *   generated.
 			 */

package/worker/include/RTC/SCTP/packet/Parameter.hpp

@@ -99,7 +99,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t ParameterHeaderLength{ 4 };
+			static constexpr size_t ParameterHeaderLength{ 4 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/TLV.hpp

@@ -33,7 +33,7 @@ namespace RTC
 		class TLV : public Serializable
 		{
 		public:
-			static const size_t TLVHeaderLength{ 4 };
+			static constexpr size_t TLVHeaderLength{ 4 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/DataChunk.hpp

@@ -77,7 +77,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t DataChunkHeaderLength{ 16 };
+			static constexpr size_t DataChunkHeaderLength{ 16 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/ForwardTsnChunk.hpp

@@ -48,7 +48,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t ForwardTsnChunkHeaderLength{ 8 };
+			static constexpr size_t ForwardTsnChunkHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/IDataChunk.hpp

@@ -74,7 +74,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t IDataChunkHeaderLength{ 20 };
+			static constexpr size_t IDataChunkHeaderLength{ 20 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/IForwardTsnChunk.hpp

@@ -60,7 +60,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t IForwardTsnChunkHeaderLength{ 8 };
+			static constexpr size_t IForwardTsnChunkHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/InitAckChunk.hpp

@@ -71,7 +71,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t InitAckChunkHeaderLength{ 20 };
+			static constexpr size_t InitAckChunkHeaderLength{ 20 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/InitChunk.hpp

@@ -71,7 +71,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t InitChunkHeaderLength{ 20 };
+			static constexpr size_t InitChunkHeaderLength{ 20 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/SackChunk.hpp

@@ -97,7 +97,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t SackChunkHeaderLength{ 16 };
+			static constexpr size_t SackChunkHeaderLength{ 16 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/chunks/ShutdownChunk.hpp

@@ -39,7 +39,7 @@ namespace RTC
 			friend class Packet;
 
 		public:
-			static const size_t ShutdownChunkHeaderLength{ 8 };
+			static constexpr size_t ShutdownChunkHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/errorCauses/InvalidStreamIdentifierErrorCause.hpp

@@ -33,7 +33,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t InvalidStreamIdentifierErrorCauseHeaderLength{ 8 };
+			static constexpr size_t InvalidStreamIdentifierErrorCauseHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/errorCauses/MissingMandatoryParameterErrorCause.hpp

@@ -38,7 +38,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t MissingMandatoryParameterErrorCauseHeaderLength{ 8 };
+			static constexpr size_t MissingMandatoryParameterErrorCauseHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/errorCauses/NoUserDataErrorCause.hpp

@@ -32,7 +32,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t NoUserDataErrorCauseHeaderLength{ 8 };
+			static constexpr size_t NoUserDataErrorCauseHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/errorCauses/StaleCookieErrorCause.hpp

@@ -32,7 +32,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t StaleCookieErrorCauseHeaderLength{ 8 };
+			static constexpr size_t StaleCookieErrorCauseHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/AddIncomingStreamsRequestParameter.hpp

@@ -35,7 +35,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t AddIncomingStreamsRequestParameterHeaderLength{ 12 };
+			static constexpr size_t AddIncomingStreamsRequestParameterHeaderLength{ 12 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/AddOutgoingStreamsRequestParameter.hpp

@@ -35,7 +35,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t AddOutgoingStreamsRequestParameterHeaderLength{ 12 };
+			static constexpr size_t AddOutgoingStreamsRequestParameterHeaderLength{ 12 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/CookiePreservativeParameter.hpp

@@ -32,7 +32,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t CookiePreservativeParameterHeaderLength{ 8 };
+			static constexpr size_t CookiePreservativeParameterHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/IPv4AddressParameter.hpp

@@ -31,7 +31,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t IPv4AddressParameterHeaderLength{ 8 };
+			static constexpr size_t IPv4AddressParameterHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/IPv6AddressParameter.hpp

@@ -34,7 +34,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t IPv6AddressParameterHeaderLength{ 20 };
+			static constexpr size_t IPv6AddressParameterHeaderLength{ 20 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/IncomingSsnResetRequestParameter.hpp

@@ -40,7 +40,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t IncomingSsnResetRequestParameterHeaderLength{ 8 };
+			static constexpr size_t IncomingSsnResetRequestParameterHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/OutgoingSsnResetRequestParameter.hpp

@@ -44,7 +44,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t OutgoingSsnResetRequestParameterHeaderLength{ 16 };
+			static constexpr size_t OutgoingSsnResetRequestParameterHeaderLength{ 16 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/ReconfigurationResponseParameter.hpp

@@ -54,8 +54,8 @@ namespace RTC
 			};
 
 		public:
-			static const size_t ReconfigurationResponseParameterHeaderLength{ 12 };
-			static const size_t ReconfigurationResponseParameterHeaderLengthWithOptionalFields{ 20 };
+			static constexpr size_t ReconfigurationResponseParameterHeaderLength{ 12 };
+			static constexpr size_t ReconfigurationResponseParameterHeaderLengthWithOptionalFields{ 20 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/SsnTsnResetRequestParameter.hpp

@@ -33,7 +33,7 @@ namespace RTC
 			friend class Chunk;
 
 		public:
-			static const size_t SsnTsnResetRequestParameterHeaderLength{ 8 };
+			static constexpr size_t SsnTsnResetRequestParameterHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/packet/parameters/StateCookieParameter.hpp

@@ -104,7 +104,10 @@ namespace RTC
 			  uint32_t remoteInitialTsn,
 			  uint32_t remoteAdvertisedReceiverWindowCredit,
 			  uint64_t tieTag,
-			  const NegotiatedCapabilities& negotiatedCapabilities);
+			  const NegotiatedCapabilities& negotiatedCapabilities,
+			  uint64_t creationTimestampMs = 0,
+			  const uint8_t* macKey        = nullptr,
+			  size_t macKeyLength          = 0);
 
 		protected:
 			StateCookieParameter* SoftClone(const uint8_t* buffer) const final;

package/worker/include/RTC/SCTP/packet/parameters/ZeroChecksumAcceptableParameter.hpp

@@ -46,7 +46,7 @@ namespace RTC
 			};
 
 		public:
-			static const size_t ZeroChecksumAcceptableParameterHeaderLength{ 8 };
+			static constexpr size_t ZeroChecksumAcceptableParameterHeaderLength{ 8 };
 
 		public:
 			/**

package/worker/include/RTC/SCTP/public/SctpOptions.hpp

@@ -264,6 +264,19 @@ namespace RTC
 				ZeroChecksumAcceptableParameter::AlternateErrorDetectionMethod::NONE
 			};
 
+			/**
+			 * Whether received State Cookies must be authenticated with a MAC keyed
+			 * by a per-association secret, and checked for staleness.
+			 *
+			 * This MUST be enabled in transports whose SCTP traffic is not protected
+			 * by DTLS to comply with RFC 9260 section 5.1.3 and prevent State Cookie
+			 * forgery (an on-path attacker could otherwise craft a COOKIE-ECHO chunk
+			 * that passes validation and establish an unauthorized association).
+			 *
+			 * @see RFC 9260 sections 5.1.3 and 5.1.4.
+			 */
+			bool requireAuthenticatedCookie{ false };
+
 			void Dump(int indentation = 0) const;
 		};
 

package/worker/include/RTC/SimpleProducerStreamManager.hpp

@@ -0,0 +1,72 @@
+#ifndef MS_RTC_SIMPLE_CONSUMER_STREAM_HPP
+#define MS_RTC_SIMPLE_CONSUMER_STREAM_HPP
+
+#include "RTC/ProducerStreamManager.hpp"
+
+namespace RTC
+{
+	class SimpleProducerStreamManager : public ProducerStreamManager
+	{
+	public:
+		SimpleProducerStreamManager(
+		  const std::vector<RTC::RtpEncodingParameters>& consumableRtpEncodings,
+		  const RTC::ConsumerTypes::VideoLayers& preferredLayers,
+		  std::unique_ptr<RTC::RTP::Codecs::EncodingContext> encodingContext,
+		  RTC::Media::Kind kind,
+		  bool keyFrameSupported,
+		  Listener* listener,
+		  SharedInterface* shared);
+
+	public:
+		RTC::ConsumerTypes::VideoLayers GetTargetLayers() const override
+		{
+			return {};
+		}
+		int16_t GetCurrentSpatialLayer() const override
+		{
+			return 0;
+		}
+		int16_t GetCurrentTemporalLayer() const override
+		{
+			return 0;
+		}
+		RTC::RTP::RtpStreamRecv* GetProducerCurrentRtpStream() const override;
+		RTC::RTP::RtpStreamRecv* GetProducerTargetRtpStream() const override;
+		bool IsPacketForCurrentStream(const RTC::RTP::Packet* /*packet*/) const override
+		{
+			return true;
+		}
+		bool IsActive() const override;
+		void ProducerRtpStream(RTC::RTP::RtpStreamRecv* rtpStream, uint32_t mappedSsrc) override;
+		void ProducerNewRtpStream(RTC::RTP::RtpStreamRecv* rtpStream, uint32_t mappedSsrc) override;
+		void ProducerRtpStreamScore(
+		  RTC::RTP::RtpStreamRecv* rtpStream, uint8_t score, uint8_t previousScore) override;
+		void ProducerRtcpSenderReport(RTC::RTP::RtpStreamRecv* rtpStream, bool first) override;
+		uint32_t IncreaseLayer(
+		  uint32_t bitrate, bool considerLoss, float lossPercentage, uint64_t nowMs) override;
+		void ApplyLayers(uint64_t rtpStreamActiveMs) override;
+		uint32_t GetDesiredBitrate(uint64_t nowMs) const override;
+		RtpPacketProcessResult ProcessRtpPacket(
+		  RTC::RTP::Packet* packet,
+		  bool lastSentPacketHasMarker,
+		  uint32_t clockRate,
+		  uint32_t maxPacketTs) override;
+		void RequestKeyFrame() override;
+		void RequestKeyFrameForTargetSpatialLayer() override;
+		void RequestKeyFrameForCurrentSpatialLayer() override;
+		void UpdateTargetLayers(int16_t spatial, int16_t temporal) override;
+		bool RecalculateTargetLayers(RTC::ConsumerTypes::VideoLayers& newTargetLayers) const override;
+		void OnTransportConnected() override;
+		void OnTransportDisconnected() override;
+		void OnPaused() override;
+		void OnResumed() override;
+
+	private:
+		// Producer RTP stream (single stream for Simple).
+		RTC::RTP::RtpStreamRecv* producerRtpStream{ nullptr };
+		// Prevents double IncreaseLayer in one BWE round.
+		bool managingBitrate{ false };
+	};
+} // namespace RTC
+
+#endif

package/worker/include/RTC/SimulcastProducerStreamManager.hpp

@@ -0,0 +1,93 @@
+#ifndef MS_RTC_SIMULCAST_CONSUMER_STREAM_HPP
+#define MS_RTC_SIMULCAST_CONSUMER_STREAM_HPP
+
+#include "RTC/ProducerStreamManager.hpp"
+#include <ankerl/unordered_dense.h>
+
+namespace RTC
+{
+	class SimulcastProducerStreamManager : public ProducerStreamManager
+	{
+	public:
+		SimulcastProducerStreamManager(
+		  const std::vector<RTC::RtpEncodingParameters>& consumableRtpEncodings,
+		  const RTC::ConsumerTypes::VideoLayers& preferredLayers,
+		  std::unique_ptr<RTC::RTP::Codecs::EncodingContext> encodingContext,
+		  RTC::Media::Kind kind,
+		  bool keyFrameSupported,
+		  Listener* listener,
+		  SharedInterface* shared);
+
+	public:
+		RTC::ConsumerTypes::VideoLayers GetTargetLayers() const override
+		{
+			return this->targetLayers;
+		}
+		int16_t GetCurrentSpatialLayer() const override
+		{
+			return this->currentSpatialLayer;
+		}
+		int16_t GetCurrentTemporalLayer() const override
+		{
+			return this->encodingContext->GetCurrentTemporalLayer();
+		}
+		RTC::RTP::RtpStreamRecv* GetProducerCurrentRtpStream() const override;
+		RTC::RTP::RtpStreamRecv* GetProducerTargetRtpStream() const override;
+		bool IsPacketForCurrentStream(const RTC::RTP::Packet* packet) const override
+		{
+			const auto it = this->mapMappedSsrcSpatialLayer.find(packet->GetSsrc());
+			if (it == this->mapMappedSsrcSpatialLayer.end())
+			{
+				return false;
+			}
+			return it->second == this->currentSpatialLayer;
+		}
+		bool IsActive() const override;
+		void ProducerRtpStream(RTC::RTP::RtpStreamRecv* rtpStream, uint32_t mappedSsrc) override;
+		void ProducerNewRtpStream(RTC::RTP::RtpStreamRecv* rtpStream, uint32_t mappedSsrc) override;
+		void ProducerRtpStreamScore(
+		  RTC::RTP::RtpStreamRecv* rtpStream, uint8_t score, uint8_t previousScore) override;
+		void ProducerRtcpSenderReport(RTC::RTP::RtpStreamRecv* rtpStream, bool first) override;
+		uint32_t IncreaseLayer(
+		  uint32_t bitrate, bool considerLoss, float lossPercentage, uint64_t nowMs) override;
+		void ApplyLayers(uint64_t rtpStreamActiveMs) override;
+		uint32_t GetDesiredBitrate(uint64_t nowMs) const override;
+		RtpPacketProcessResult ProcessRtpPacket(
+		  RTC::RTP::Packet* packet,
+		  bool lastSentPacketHasMarker,
+		  uint32_t clockRate,
+		  uint32_t maxPacketTs) override;
+		void RequestKeyFrame() override;
+		void RequestKeyFrameForTargetSpatialLayer() override;
+		void RequestKeyFrameForCurrentSpatialLayer() override;
+		void UpdateTargetLayers(int16_t newTargetSpatialLayer, int16_t newTargetTemporalLayer) override;
+		bool RecalculateTargetLayers(RTC::ConsumerTypes::VideoLayers& newTargetLayers) const override;
+		void OnTransportConnected() override;
+		void OnTransportDisconnected() override;
+		void OnPaused() override;
+		void OnResumed() override;
+
+	private:
+		bool CanSwitchToSpatialLayer(int16_t spatialLayer) const;
+		RTC::RTP::RtpStreamRecv* GetProducerTsReferenceRtpStream() const;
+
+	private:
+		// Producer RTP streams (multiple for Simulcast).
+		std::vector<RTC::RTP::RtpStreamRecv*> producerRtpStreams;
+		ankerl::unordered_dense::map<uint32_t, int16_t> mapMappedSsrcSpatialLayer;
+		RTC::ConsumerTypes::VideoLayers targetLayers;
+		int16_t currentSpatialLayer{ -1 };
+		int16_t spatialLayerToSync{ -1 };
+		// Timestamp synchronization.
+		int16_t tsReferenceSpatialLayer{ -1 };
+		uint32_t tsOffset{ 0u };
+		bool keyFrameForTsOffsetRequested{ false };
+		// Old-packet filtering after spatial switch.
+		uint16_t snReferenceSpatialLayer{ 0u };
+		bool checkingForOldPacketsInSpatialLayer{ false };
+		// BWE downgrade tracking.
+		uint64_t lastBweDowngradeAtMs{ 0u };
+	};
+} // namespace RTC
+
+#endif