mediasoup 3.21.2 → 3.22.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ### NEXT
 
+### 3.22.0
+
+- SCTP: Encode subchannels in SCTP messages to enable subchannels mechanism when using pipe transport ([PR #1859](https://github.com/versatica/mediasoup/pull/1859)).
+
 ### 3.21.2
 
 - Worker: Fix crash when an SCTP `DataConsumer` is closed and triggers buffered amount low event ([PR #1858](https://github.com/versatica/mediasoup/pull/1858)).

package/node/lib/Router.d.ts

@@ -1,6 +1,6 @@
 import { EnhancedEventEmitter } from './enhancedEvents';
 import type { Channel } from './Channel';
-import type { Router, PipeToRouterOptions, PipeToRouterResult, PipeTransportPair, RouterDump, RouterEvents, RouterObserver } from './RouterTypes';
+import type { Router, PipeToRouterOptions, PipeToRouterResult, RouterDump, RouterEvents, RouterObserver } from './RouterTypes';
 import type { Transport } from './TransportTypes';
 import type { WebRtcTransport, WebRtcTransportOptions } from './WebRtcTransportTypes';
 import type { PlainTransport, PlainTransportOptions } from './PlainTransportTypes';
@@ -44,7 +44,6 @@ export declare class RouterImpl<RouterAppData extends AppData = AppData> extends
     createPipeTransport<PipeTransportAppData extends AppData = AppData>({ listenInfo, listenIp, port, enableSctp, maxSendMessageSize, maxReceiveMessageSize, sctpSendBufferSize, sctpPerStreamSendQueueLimit, sctpMaxReceiverWindowBufferSize, enableRtx, enableSrtp, appData, }: PipeTransportOptions<PipeTransportAppData>): Promise<PipeTransport<PipeTransportAppData>>;
     createDirectTransport<DirectTransportAppData extends AppData = AppData>({ maxSendMessageSize, maxReceiveMessageSize, appData, }?: DirectTransportOptions<DirectTransportAppData>): Promise<DirectTransport<DirectTransportAppData>>;
     pipeToRouter({ producerId, dataProducerId, router, keepId, listenInfo, listenIp, enableSctp, maxSendMessageSize, maxReceiveMessageSize, sctpSendBufferSize, sctpPerStreamSendQueueLimit, sctpMaxReceiverWindowBufferSize, enableRtx, enableSrtp, }: PipeToRouterOptions): Promise<PipeToRouterResult>;
-    addPipeTransportPair(pipeTransportPairKey: string, pipeTransportPairPromise: Promise<PipeTransportPair>): void;
     createActiveSpeakerObserver<ActiveSpeakerObserverAppData extends AppData = AppData>({ interval, appData, }?: ActiveSpeakerObserverOptions<ActiveSpeakerObserverAppData>): Promise<ActiveSpeakerObserver<ActiveSpeakerObserverAppData>>;
     createAudioLevelObserver<AudioLevelObserverAppData extends AppData = AppData>({ maxEntries, threshold, interval, appData, }?: AudioLevelObserverOptions<AudioLevelObserverAppData>): Promise<AudioLevelObserver<AudioLevelObserverAppData>>;
     canConsume({ producerId, rtpCapabilities, }: {
@@ -52,6 +51,7 @@ export declare class RouterImpl<RouterAppData extends AppData = AppData> extends
         rtpCapabilities: RtpCapabilities;
     }): boolean;
     updateMediaCodecs(mediaCodecs: RouterRtpCodecCapability[]): void;
+    private addPipeTransportPair;
     private handleListenerError;
 }
 export {};

package/node/lib/Router.d.ts.map

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

package/node/lib/Router.js

@@ -694,24 +694,6 @@ class RouterImpl extends enhancedEvents_1.EnhancedEventEmitter {
             throw new Error('internal error');
         }
     }
-    addPipeTransportPair(pipeTransportPairKey, pipeTransportPairPromise) {
-        if (this.#mapRouterPairPipeTransportPairPromise.has(pipeTransportPairKey)) {
-            throw new Error('given pipeTransportPairKey already exists in this Router');
-        }
-        this.#mapRouterPairPipeTransportPairPromise.set(pipeTransportPairKey, pipeTransportPairPromise);
-        pipeTransportPairPromise
-            .then(pipeTransportPair => {
-            const localPipeTransport = pipeTransportPair[this.id];
-            // NOTE: No need to do any other cleanup here since that is done by the
-            // Router calling this method on us.
-            localPipeTransport.observer.on('close', () => {
-                this.#mapRouterPairPipeTransportPairPromise.delete(pipeTransportPairKey);
-            });
-        })
-            .catch(() => {
-            this.#mapRouterPairPipeTransportPairPromise.delete(pipeTransportPairKey);
-        });
-    }
     async createActiveSpeakerObserver({ interval = 300, appData, } = {}) {
         logger.debug('createActiveSpeakerObserver()');
         if (typeof interval !== 'number') {
@@ -804,6 +786,24 @@ class RouterImpl extends enhancedEvents_1.EnhancedEventEmitter {
         const rtpCapabilities = ortc.generateRouterRtpCapabilities(clonedMediaCodecs);
         this.#data.rtpCapabilities = rtpCapabilities;
     }
+    addPipeTransportPair(pipeTransportPairKey, pipeTransportPairPromise) {
+        if (this.#mapRouterPairPipeTransportPairPromise.has(pipeTransportPairKey)) {
+            throw new Error('given pipeTransportPairKey already exists in this Router');
+        }
+        this.#mapRouterPairPipeTransportPairPromise.set(pipeTransportPairKey, pipeTransportPairPromise);
+        pipeTransportPairPromise
+            .then(pipeTransportPair => {
+            const localPipeTransport = pipeTransportPair[this.id];
+            // NOTE: No need to do any other cleanup here since that is done by the
+            // Router calling this method on us.
+            localPipeTransport.observer.on('close', () => {
+                this.#mapRouterPairPipeTransportPairPromise.delete(pipeTransportPairKey);
+            });
+        })
+            .catch(() => {
+            this.#mapRouterPairPipeTransportPairPromise.delete(pipeTransportPairKey);
+        });
+    }
     handleListenerError() {
         this.on('listenererror', (eventName, error) => {
             logger.error(`event listener threw an error [eventName:${eventName}]:`, error);

package/node/lib/RouterTypes.d.ts

@@ -234,10 +234,6 @@ export interface Router<RouterAppData extends AppData = AppData> extends Enhance
      * Pipes the given Producer or DataProducer into another Router in same host.
      */
     pipeToRouter(options: PipeToRouterOptions): Promise<PipeToRouterResult>;
-    /**
-     * @private
-     */
-    addPipeTransportPair(pipeTransportPairKey: string, pipeTransportPairPromise: Promise<PipeTransportPair>): void;
     /**
      * Create an ActiveSpeakerObserver
      */

package/node/lib/RouterTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterTypes.d.ts","sourceRoot":"","sources":["../src/RouterTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EACX,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACX,eAAe,EACf,sBAAsB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACX,cAAc,EACd,qBAAqB,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EACX,eAAe,EACf,sBAAsB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACX,qBAAqB,EACrB,4BAA4B,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACX,kBAAkB,EAClB,yBAAyB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACX,eAAe,EACf,wBAAwB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,aAAa,CAAC,aAAa,SAAS,OAAO,GAAG,OAAO,IAAI;IACpE;;OAEG;IACH,WAAW,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAEzC;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;;;OAIG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,kBAAkB,CAAC;AAEvB,KAAK,kBAAkB,GAAG,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;AAE/E,KAAK,sBAAsB,GAAG;IAC7B,UAAU,EAAE,mBAAmB,CAAC;CAChC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IAExB;;OAEG;IACH,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAEhC;;OAEG;IACH,gBAAgB,CAAC,EAAE,YAAY,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;OAEG;IACH,wBAAwB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC9D;;OAEG;IACH,uBAAuB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D;;OAEG;IACH,wBAAwB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAC9D;;OAEG;IACH,gCAAgC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACtE;;OAEG;IACH,+BAA+B,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,EAAE,CAAC;IAEhB,QAAQ,EAAE,EAAE,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,EAAE,CAAC;IACV,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1B,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,MAAM,CACtB,aAAa,SAAS,OAAO,GAAG,OAAO,CACtC,SAAQ,oBAAoB,CAAC,YAAY,CAAC;IAC3C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAAC;IAEtB;;OAEG;IACH,IAAI,eAAe,IAAI,eAAe,CAAC;IAEvC;;OAEG;IACH,IAAI,OAAO,IAAI,aAAa,CAAC;IAE7B;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE;IAEpC;;OAEG;IACH,IAAI,QAAQ,IAAI,cAAc,CAAC;IAE/B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;OAIG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5B;;OAEG;IACH,qBAAqB,CAAC,sBAAsB,SAAS,OAAO,GAAG,OAAO,EACrE,OAAO,EAAE,sBAAsB,CAAC,sBAAsB,CAAC,GACrD,OAAO,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAEpD;;OAEG;IACH,oBAAoB,CAAC,qBAAqB,SAAS,OAAO,GAAG,OAAO,EACnE,OAAO,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,GACnD,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAElD;;OAEG;IACH,mBAAmB,CAAC,oBAAoB,SAAS,OAAO,GAAG,OAAO,EACjE,OAAO,EAAE,oBAAoB,CAAC,oBAAoB,CAAC,GACjD,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAEhD;;OAEG;IACH,qBAAqB,CAAC,sBAAsB,SAAS,OAAO,GAAG,OAAO,EACrE,OAAO,CAAC,EAAE,sBAAsB,CAAC,sBAAsB,CAAC,GACtD,OAAO,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAEpD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAExE;;OAEG;IACH,oBAAoB,CACnB,oBAAoB,EAAE,MAAM,EAC5B,wBAAwB,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClD,IAAI,CAAC;IAER;;OAEG;IACH,2BAA2B,CAC1B,4BAA4B,SAAS,OAAO,GAAG,OAAO,EAEtD,OAAO,CAAC,EAAE,4BAA4B,CAAC,4BAA4B,CAAC,GAClE,OAAO,CAAC,qBAAqB,CAAC,4BAA4B,CAAC,CAAC,CAAC;IAEhE;;OAEG;IACH,wBAAwB,CAAC,yBAAyB,SAAS,OAAO,GAAG,OAAO,EAC3E,OAAO,CAAC,EAAE,yBAAyB,CAAC,yBAAyB,CAAC,GAC5D,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,UAAU,CAAC,EACV,UAAU,EACV,eAAe,GACf,EAAE;QACF,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,eAAe,CAAC;KACjC,GAAG,OAAO,CAAC;IAEZ;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,wBAAwB,EAAE,GAAG,IAAI,CAAC;CACjE"}
+{"version":3,"file":"RouterTypes.d.ts","sourceRoot":"","sources":["../src/RouterTypes.ts"],"names":[],"mappings":"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"}

package/node/lib/test/test-PipeTransport.js

@@ -901,7 +901,7 @@ test('router.pipeToRouter() succeeds with data', async () => {
     expect(pipeDataProducer.label).toBe('foo');
     expect(pipeDataProducer.protocol).toBe('bar');
 }, 2000);
-test('transport.dataConsume() for a pipe DataProducer succeeds', async () => {
+test('transport.consumeData() for a pipe DataProducer succeeds', async () => {
     const { pipeDataProducer } = await ctx.router1.pipeToRouter({
         dataProducerId: ctx.dataProducer.id,
         router: ctx.router2,
@@ -920,6 +920,38 @@ test('transport.dataConsume() for a pipe DataProducer succeeds', async () => {
     expect(dataConsumer.label).toBe('foo');
     expect(dataConsumer.protocol).toBe('bar');
 }, 2000);
+test('transport.consumeData() for a pipe DataProducer succeeds with subchannels', async () => {
+    const directTransport1 = await ctx.router1.createDirectTransport();
+    const directDataProducer = await directTransport1.produceData({
+        label: 'foo',
+        protocol: 'bar',
+    });
+    await ctx.router1.pipeToRouter({
+        dataProducerId: directDataProducer.id,
+        router: ctx.router2,
+    });
+    const directTransport2 = await ctx.router2.createDirectTransport();
+    const directDataConsumer = await directTransport2.consumeData({
+        dataProducerId: directDataProducer.id,
+        subchannels: [123, 666],
+    });
+    await new Promise((resolve, reject) => {
+        directDataConsumer.on('message', (message, ppid) => {
+            try {
+                expect(message.toString('utf8')).toBe('hello');
+                expect(ppid).toBe(51);
+                resolve();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        directDataProducer.send('hello', 
+        /* ppid */ undefined, 
+        /* subchannels */ [123, 124], 
+        /* requiredSubchannel */ 666);
+    });
+}, 2000);
 test('dataProducer.close() is transmitted to pipe DataConsumer', async () => {
     const { pipeDataProducer } = await ctx.router1.pipeToRouter({
         dataProducerId: ctx.dataProducer.id,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mediasoup",
-	"version": "3.21.2",
+	"version": "3.22.0",
 	"description": "Cutting Edge WebRTC Video Conferencing",
 	"contributors": [
 		"Iñaki Baz Castillo <ibc@aliax.net> (https://inakibaz.me)",

package/worker/include/RTC/DataConsumer.hpp

@@ -49,7 +49,8 @@ namespace RTC
 		  const std::string& dataProducerId,
 		  RTC::DataConsumer::Listener* listener,
 		  const FBS::Transport::ConsumeDataRequest* data,
-		  size_t maxMessageSize);
+		  size_t maxMessageSize,
+		  bool pipe);
 		~DataConsumer() override;
 
 	public:
@@ -67,20 +68,17 @@ namespace RTC
 		}
 		bool IsActive() const
 		{
-			// It's active it DataConsumer and DataProducer are not paused and the transport
-			// is connected.
+			// It's active it DataConsumer and DataProducer are not paused and the SCTP
+			// association (if any) is not closed.
 			// clang-format off
 			return (
-				this->transportConnected &&
-				(this->type == DataConsumer::Type::DIRECT || this->sctpAssociationConnected) &&
+				(this->type == DataConsumer::Type::DIRECT || !this->sctpAssociationClosed) &&
 				!this->paused &&
 				!this->dataProducerPaused &&
 				!this->dataProducerClosed
 			);
 			// clang-format on
 		}
-		void TransportConnected();
-		void TransportDisconnected();
 		bool IsPaused() const
 		{
 			return this->paused;
@@ -91,7 +89,6 @@ namespace RTC
 		}
 		void DataProducerPaused();
 		void DataProducerResumed();
-		void SctpAssociationConnected();
 		void SctpAssociationClosed();
 		void SctpBufferedAmountLow(uint32_t bufferedAmount) const;
 		void SctpSendBufferFull() const;
@@ -116,14 +113,14 @@ namespace RTC
 		SharedInterface* shared{ nullptr };
 		RTC::DataConsumer::Listener* listener{ nullptr };
 		size_t maxMessageSize{ 0u };
+		bool pipe{ false };
 		// Others.
 		Type type;
 		RTC::SctpStreamParameters sctpStreamParameters;
 		std::string label;
 		std::string protocol;
 		ankerl::unordered_dense::set<uint16_t> subchannels;
-		bool transportConnected{ false };
-		bool sctpAssociationConnected{ false };
+		bool sctpAssociationClosed{ false };
 		bool paused{ false };
 		bool dataProducerPaused{ false };
 		bool dataProducerClosed{ false };

package/worker/include/RTC/PipeTransport.hpp

@@ -41,6 +41,10 @@ namespace RTC
 
 	private:
 		bool IsConnected() const override;
+		bool IsPipe() const override
+		{
+			return true;
+		}
 		bool HasSrtp() const;
 		void SendRtpPacket(
 		  RTC::Consumer* consumer,

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

@@ -68,6 +68,22 @@ namespace RTC
 				return this->payload.size();
 			}
 
+			/**
+			 * Replace the whole payload of the message.
+			 */
+			void SetPayload(std::vector<uint8_t> payload)
+			{
+				this->payload = std::move(payload);
+			}
+
+			/**
+			 * Remove the first `len` bytes from the beginning of the payload.
+			 */
+			void RemovePayloadFront(size_t len)
+			{
+				this->payload.erase(this->payload.begin(), this->payload.begin() + len);
+			}
+
 			/**
 			 * Useful to extract the payload and its ownership when destructing the
 			 * message.

package/worker/include/RTC/SubchannelsCodec.hpp

@@ -0,0 +1,76 @@
+#ifndef MS_RTC_SUBCHANNELS_CODEC_HPP
+#define MS_RTC_SUBCHANNELS_CODEC_HPP
+
+#include "common.hpp"
+#include "RTC/SCTP/public/Message.hpp"
+#include <vector>
+
+namespace RTC
+{
+	/**
+	 * Helper to (optionally) encode/decode subchannels and required subchannel at
+	 * the beginning of an SCTP message payload so that this information travels
+	 * within the SCTP message itself.
+	 */
+	class SubchannelsCodec
+	{
+		/**
+		 * Wire layout of the encoded header prepended to the message payload (all
+		 * fields in network byte order). `R` is the `requiredSubchannelFlag`, i.e.
+		 * the least significant bit of the Magic Token. The `requiredSubchannel`
+		 * field is only present when `R` is 1.
+		 *
+		 *  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
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |                       Magic Token (1/2)                       |
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |                      Magic Token (2/2)                      |R|
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |        subchannelsCount       |          Subchannel 0         |
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |                              ...                              |
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 * |         Subchannel N-1        |  requiredSubchannel (if R=1)  |
+		 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+		 */
+
+	public:
+		/**
+		 * 8-byte Magic Token that prefixes an encoded payload. It is intentionally
+		 * made of non-printable high bytes and starts with a byte that is not a valid
+		 * UTF-8 leading byte (0x80-0xBF), so a real string message (valid UTF-8) can
+		 * never begin with it and the chance of colliding with a binary message is
+		 * negligible. Its least significant bit is reserved as the
+		 * `requiredSubchannelFlag`, so it is always 0 in the token constant itself.
+		 */
+		static constexpr uint64_t MagicToken{ 0xA5F09CB3D6E1F28C };
+		static constexpr uint64_t RequiredSubchannelFlagMask{ 0x1 };
+
+	public:
+		/**
+		 * If `subchannels` is not empty or `requiredSubchannel` has value, encodes
+		 * them at the beginning of the given message payload.
+		 *
+		 * @returns true if the message was encoded, false otherwise.
+		 */
+		static bool EncodeSubchannels(
+		  RTC::SCTP::Message& message,
+		  const std::vector<uint16_t>& subchannels,
+		  std::optional<uint16_t> requiredSubchannel);
+
+		/**
+		 * If the given message payload starts with the Magic Token, extracts the
+		 * encoded subchannels and (optionally) the required subchannel, fills the
+		 * given arguments and removes the encoded header from the message payload.
+		 *
+		 * @returns true if the message was successfully decoded, false otherwise.
+		 */
+		static bool DecodeSubchannels(
+		  RTC::SCTP::Message& message,
+		  std::vector<uint16_t>& subchannels,
+		  std::optional<uint16_t>& requiredSubchannel);
+	};
+} // namespace RTC
+
+#endif

package/worker/include/RTC/Transport.hpp

@@ -219,6 +219,10 @@ namespace RTC
 		  const std::string& dataConsumerId, const std::string& method) const final;
 		virtual void CheckNoSctpDataConsumer(uint16_t streamId, const std::string& method) const final;
 		virtual bool IsConnected() const = 0;
+		virtual bool IsPipe() const
+		{
+			return false;
+		}
 		virtual void SendRtpPacket(
 		  RTC::Consumer* consumer, RTC::RTP::Packet* packet, const onSendCallback* cb = nullptr) = 0;
 		virtual void HandleRtcpPacket(RTC::RTCP::Packet* packet) final;

package/worker/meson.build

@@ -136,6 +136,7 @@ common_sources = [
   'src/RTC/SimpleProducerStreamManager.cpp',
   'src/RTC/SimulcastProducerStreamManager.cpp',
   'src/RTC/SrtpSession.cpp',
+  'src/RTC/SubchannelsCodec.cpp',
   'src/RTC/SvcProducerStreamManager.cpp',
   'src/RTC/TcpConnection.cpp',
   'src/RTC/TcpServer.cpp',
@@ -430,6 +431,7 @@ test_sources = [
   'test/src/RTC/TestRateCalculator.cpp',
   'test/src/RTC/TestRtpEncodingParameters.cpp',
   'test/src/RTC/TestSeqManager.cpp',
+  'test/src/RTC/TestSubchannelsCodec.cpp',
   'test/src/RTC/TestTransportCongestionControlServer.cpp',
   'test/src/RTC/TestTransportTuple.cpp',
   'test/src/RTC/TestTrendCalculator.cpp',

package/worker/scripts/package-lock.json

@@ -21,9 +21,10 @@
 			}
 		},
 		"node_modules/brace-expansion": {
-			"version": "5.0.6",
-			"resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
-			"integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
+			"version": "5.0.7",
+			"resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz",
+			"integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==",
+			"license": "MIT",
 			"dependencies": {
 				"balanced-match": "^4.0.2"
 			},
@@ -104,9 +105,9 @@
 			"integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="
 		},
 		"brace-expansion": {
-			"version": "5.0.6",
-			"resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
-			"integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
+			"version": "5.0.7",
+			"resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz",
+			"integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==",
 			"requires": {
 				"balanced-match": "^4.0.2"
 			}

package/worker/src/RTC/DataConsumer.cpp

@@ -4,6 +4,7 @@
 #include "RTC/DataConsumer.hpp"
 #include "Logger.hpp"
 #include "MediaSoupErrors.hpp"
+#include "RTC/SubchannelsCodec.hpp"
 
 namespace RTC
 {
@@ -15,12 +16,14 @@ namespace RTC
 	  const std::string& dataProducerId,
 	  RTC::DataConsumer::Listener* listener,
 	  const FBS::Transport::ConsumeDataRequest* data,
-	  size_t maxMessageSize)
+	  size_t maxMessageSize,
+	  bool pipe)
 	  : id(id),
 	    dataProducerId(dataProducerId),
 	    shared(shared),
 	    listener(listener),
-	    maxMessageSize(maxMessageSize)
+	    maxMessageSize(maxMessageSize),
+	    pipe(pipe)
 	{
 		MS_TRACE();
 
@@ -398,24 +401,6 @@ namespace RTC
 		}
 	}
 
-	void DataConsumer::TransportConnected()
-	{
-		MS_TRACE();
-
-		this->transportConnected = true;
-
-		MS_DEBUG_DEV("Transport connected [dataConsumerId:%s]", this->id.c_str());
-	}
-
-	void DataConsumer::TransportDisconnected()
-	{
-		MS_TRACE();
-
-		this->transportConnected = false;
-
-		MS_DEBUG_DEV("Transport disconnected [dataConsumerId:%s]", this->id.c_str());
-	}
-
 	void DataConsumer::DataProducerPaused()
 	{
 		MS_TRACE();
@@ -450,22 +435,11 @@ namespace RTC
 		  this->id, FBS::Notification::Event::DATACONSUMER_DATAPRODUCER_RESUME);
 	}
 
-	void DataConsumer::SctpAssociationConnected()
-	{
-		MS_TRACE();
-
-		this->sctpAssociationConnected = true;
-
-		MS_DEBUG_DEV("SctpAssociation connected [dataConsumerId:%s]", this->id.c_str());
-	}
-
 	void DataConsumer::SctpAssociationClosed()
 	{
 		MS_TRACE();
 
-		this->sctpAssociationConnected = false;
-
-		MS_DEBUG_DEV("SctpAssociation closed [dataConsumerId:%s]", this->id.c_str());
+		this->sctpAssociationClosed = true;
 	}
 
 	void DataConsumer::SctpBufferedAmountLow(uint32_t bufferedAmount) const
@@ -526,48 +500,57 @@ namespace RTC
 			return false;
 		}
 
-		// If a required subchannel is given, verify that this data consumer is
-		// subscribed to it.
-		if (
-		  requiredSubchannel.has_value() &&
-		  this->subchannels.find(requiredSubchannel.value()) == this->subchannels.end())
+		if (!this->pipe)
 		{
-			if (cb)
+			// If a required subchannel is given, verify that this data consumer is
+			// subscribed to it.
+			if (requiredSubchannel.has_value() && !this->subchannels.contains(requiredSubchannel.value()))
 			{
-				(*cb)(false, false);
-				delete cb;
-			}
-
-			return false;
-		}
+				if (cb)
+				{
+					(*cb)(false, false);
+					delete cb;
+				}
 
-		// If subchannels are given, verify that this data consumer is subscribed
-		// to at least one of them.
-		if (!subchannels.empty())
-		{
-			bool subchannelMatched{ false };
+				return false;
+			}
 
-			for (const auto subchannel : subchannels)
+			// If subchannels are given, verify that this data consumer is subscribed
+			// to at least one of them.
+			if (!subchannels.empty())
 			{
-				if (this->subchannels.find(subchannel) != this->subchannels.end())
+				bool subchannelMatched{ false };
+
+				for (const auto subchannel : subchannels)
 				{
-					subchannelMatched = true;
+					if (this->subchannels.contains(subchannel))
+					{
+						subchannelMatched = true;
 
-					break;
+						break;
+					}
 				}
-			}
 
-			if (!subchannelMatched)
-			{
-				if (cb)
+				if (!subchannelMatched)
 				{
-					(*cb)(false, false);
-					delete cb;
-				}
+					if (cb)
+					{
+						(*cb)(false, false);
+						delete cb;
+					}
 
-				return false;
+					return false;
+				}
 			}
 		}
+		// This is a piped DataConsumer, so instead of verifying subchannels locally,
+		// encode the subchannels and required subchannel at the beginning of the
+		// message payload so the receiving PipeTransport can decode them and apply
+		// them to its own DataConsumers.
+		else
+		{
+			RTC::SubchannelsCodec::EncodeSubchannels(message, subchannels, requiredSubchannel);
+		}
 
 		const size_t messageLen = message.GetPayloadLength();
 
@@ -575,7 +558,7 @@ namespace RTC
 		{
 			MS_WARN_TAG(
 			  message,
-			  "given message exceeds maxMessageSize value [maxMessageSize:%zu, len:%zu]",
+			  "message exceeds maxMessageSize value [maxMessageSize:%zu, len:%zu]",
 			  messageLen,
 			  this->maxMessageSize);
 

package/worker/src/RTC/SubchannelsCodec.cpp

@@ -0,0 +1,153 @@
+#define MS_CLASS "RTC::SubchannelsCodec"
+// #define MS_LOG_DEV_LEVEL 3
+
+#include "RTC/SubchannelsCodec.hpp"
+#include "Logger.hpp"
+#include "Utils.hpp"
+
+namespace RTC
+{
+	/* Class methods. */
+
+	bool SubchannelsCodec::EncodeSubchannels(
+	  RTC::SCTP::Message& message,
+	  const std::vector<uint16_t>& subchannels,
+	  std::optional<uint16_t> requiredSubchannel)
+	{
+		MS_TRACE();
+
+		// Nothing to encode.
+		if (subchannels.empty() && !requiredSubchannel.has_value())
+		{
+			return false;
+		}
+
+		if (subchannels.size() > 0xFFFF)
+		{
+			MS_ERROR("too many subchannels to encode [count:%zu]", subchannels.size());
+
+			return false;
+		}
+
+		const auto subchannelsCount       = static_cast<uint16_t>(subchannels.size());
+		const bool requiredSubchannelFlag = requiredSubchannel.has_value();
+
+		// Length of the header to prepend.
+		size_t headerLen =
+		  8 /* Magic Token */ + 2 /* subchannelsCount */ + (static_cast<size_t>(subchannelsCount) * 2);
+
+		if (requiredSubchannelFlag)
+		{
+			headerLen += 2;
+		}
+
+		const auto payload = message.GetPayload();
+
+		// Build the whole new payload at once (header followed by the original
+		// payload) so it can be moved into the message with a single allocation.
+		std::vector<uint8_t> newPayload(headerLen + payload.size());
+
+		uint64_t magicToken = SubchannelsCodec::MagicToken;
+
+		if (requiredSubchannelFlag)
+		{
+			magicToken |= SubchannelsCodec::RequiredSubchannelFlagMask;
+		}
+
+		size_t offset = 0;
+
+		Utils::Byte::Set8Bytes(newPayload.data(), offset, magicToken);
+		offset += 8;
+
+		Utils::Byte::Set2Bytes(newPayload.data(), offset, subchannelsCount);
+		offset += 2;
+
+		for (const auto subchannel : subchannels)
+		{
+			Utils::Byte::Set2Bytes(newPayload.data(), offset, subchannel);
+			offset += 2;
+		}
+
+		if (requiredSubchannelFlag)
+		{
+			Utils::Byte::Set2Bytes(newPayload.data(), offset, requiredSubchannel.value());
+			offset += 2;
+		}
+
+		// Append the original payload right after the encoded header.
+		std::ranges::copy(payload, newPayload.begin() + offset);
+
+		message.SetPayload(std::move(newPayload));
+
+		return true;
+	}
+
+	bool SubchannelsCodec::DecodeSubchannels(
+	  RTC::SCTP::Message& message,
+	  std::vector<uint16_t>& subchannels,
+	  std::optional<uint16_t>& requiredSubchannel)
+	{
+		MS_TRACE();
+
+		const auto payload = message.GetPayload();
+		const size_t len   = payload.size();
+
+		// Not even enough bytes to hold the Magic Token and `subchannelsCount` field,
+		// so nothing to decode.
+		if (len < 10)
+		{
+			return false;
+		}
+
+		const uint64_t magicToken = Utils::Byte::Get8Bytes(payload.data(), 0);
+
+		// The message does not start with the Magic Token, so nothing to decode.
+		if ((magicToken & ~SubchannelsCodec::RequiredSubchannelFlagMask) != SubchannelsCodec::MagicToken)
+		{
+			return false;
+		}
+
+		const bool requiredSubchannelFlag =
+		  (magicToken & SubchannelsCodec::RequiredSubchannelFlagMask) != 0;
+
+		const uint16_t subchannelsCount = Utils::Byte::Get2Bytes(payload.data(), 8);
+
+		// Offset right after the Magic Token and subchannelsCount fields.
+		size_t offset = 10;
+
+		// Bytes needed to hold all announced subchannels and, if present, the
+		// requiredSubchannel.
+		size_t neededLen = offset + (static_cast<size_t>(subchannelsCount) * 2);
+
+		if (requiredSubchannelFlag)
+		{
+			neededLen += 2;
+		}
+
+		if (len < neededLen)
+		{
+			MS_WARN_DEV("message too short to hold announced subchannels, ignoring");
+
+			return false;
+		}
+
+		subchannels.reserve(subchannelsCount);
+
+		for (uint16_t i = 0; i < subchannelsCount; ++i)
+		{
+			subchannels.push_back(Utils::Byte::Get2Bytes(payload.data(), offset));
+			offset += 2;
+		}
+
+		if (requiredSubchannelFlag)
+		{
+			requiredSubchannel = Utils::Byte::Get2Bytes(payload.data(), offset);
+			offset += 2;
+		}
+
+		// Remove the decoded header from the beginning of the message payload.
+		message.RemovePayloadFront(offset);
+
+		return true;
+	}
+} // namespace RTC

package/worker/src/RTC/Transport.cpp

@@ -18,6 +18,7 @@
 #include "RTC/RtpDictionaries.hpp"
 #include "RTC/SCTP/association/Association.hpp"
 #include "RTC/SCTP/public/SctpOptions.hpp"
+#include "RTC/SubchannelsCodec.hpp"
 #include "Utils.hpp"
 #ifdef MS_RTC_LOGGER_RTP
 #include "RTC/RtcLogger.hpp"
@@ -1111,7 +1112,13 @@ namespace RTC
 
 				// This may throw.
 				auto* dataConsumer = new RTC::DataConsumer(
-				  this->shared, dataConsumerId, dataProducerId, this, body, this->maxSendMessageSize);
+				  this->shared,
+				  dataConsumerId,
+				  dataProducerId,
+				  this,
+				  body,
+				  this->maxSendMessageSize,
+				  this->IsPipe());
 
 				// Verify the type of the DataConsumer.
 				switch (dataConsumer->GetType())
@@ -1189,19 +1196,8 @@ namespace RTC
 
 				request->Accept(FBS::Response::Body::DataConsumer_DumpResponse, dumpOffset);
 
-				if (IsConnected())
-				{
-					dataConsumer->TransportConnected();
-				}
-
 				if (dataConsumer->GetType() == RTC::DataConsumer::Type::SCTP)
 				{
-					if (this->sctpAssociation->GetAssociationState() == RTC::SCTP::Types::AssociationState::CONNECTED)
-					{
-						// Tell to the DataConsumer.
-						dataConsumer->SctpAssociationConnected();
-					}
-
 					// Tell to the SCTP association.
 					this->sctpAssociation->MayConnect();
 				}
@@ -1480,14 +1476,6 @@ namespace RTC
 			consumer->TransportConnected();
 		}
 
-		// Tell all DataConsumers.
-		for (auto& kv : this->mapDataConsumers)
-		{
-			auto* dataConsumer = kv.second;
-
-			dataConsumer->TransportConnected();
-		}
-
 		// Tell the SctpAssociation.
 		if (this->sctpAssociation)
 		{
@@ -1530,14 +1518,6 @@ namespace RTC
 			consumer->TransportDisconnected();
 		}
 
-		// Tell all DataConsumers.
-		for (auto& kv : this->mapDataConsumers)
-		{
-			auto* dataConsumer = kv.second;
-
-			dataConsumer->TransportDisconnected();
-		}
-
 		// Stop the RTCP timer.
 		this->rtcpTimer->Stop();
 
@@ -2999,17 +2979,6 @@ namespace RTC
 	{
 		MS_TRACE();
 
-		// Tell all DataConsumers.
-		for (auto& kv : this->mapDataConsumers)
-		{
-			auto* dataConsumer = kv.second;
-
-			if (dataConsumer->GetType() == RTC::DataConsumer::Type::SCTP)
-			{
-				dataConsumer->SctpAssociationConnected();
-			}
-		}
-
 		// Notify the upper layer.
 
 		// First tell it about the SCTP negotiated capabilities.
@@ -3041,7 +3010,7 @@ namespace RTC
 
 // For debugging purposes.
 #if MS_LOG_DEV_LEVEL == 3
-		MS_DUMP("--- SCTP association connected:");
+		MS_DUMP("SCTP association connected:");
 		this->sctpAssociation->Dump();
 #endif
 	}
@@ -3187,10 +3156,17 @@ namespace RTC
 		// Pass the SCTP message to the corresponding DataProducer.
 		try
 		{
-			static thread_local std::vector<uint16_t> emptySubchannels;
+			std::vector<uint16_t> subchannels;
+			std::optional<uint16_t> requiredSubchannel;
+
+			// When this is a pipe transport, the subchannels and required subchannel
+			// may be encoded at the beginning of the message payload.
+			if (this->IsPipe())
+			{
+				RTC::SubchannelsCodec::DecodeSubchannels(message, subchannels, requiredSubchannel);
+			}
 
-			dataProducer->ReceiveMessage(
-			  std::move(message), emptySubchannels, /*requiredSubchannel*/ std::nullopt);
+			dataProducer->ReceiveMessage(std::move(message), subchannels, requiredSubchannel);
 		}
 		catch (std::exception& error)
 		{

package/worker/test/src/RTC/TestSubchannelsCodec.cpp

@@ -0,0 +1,224 @@
+#include "common.hpp"
+#include "RTC/SCTP/public/Message.hpp"
+#include "RTC/SubchannelsCodec.hpp"
+#include "Utils.hpp"
+#include <catch2/catch_test_macros.hpp>
+#include <vector>
+
+SCENARIO("SubchannelsCodec", "[subchannels]")
+{
+	// Build a message with the given payload.
+	auto makeMessage = [](const std::vector<uint8_t>& payload)
+	{
+		return RTC::SCTP::Message(/*streamId*/ 1, /*ppid*/ 51, payload);
+	};
+
+	// Copy the current payload of a message into a std::vector.
+	auto payloadToVector = [](const RTC::SCTP::Message& message)
+	{
+		const auto payload = message.GetPayload();
+
+		return std::vector<uint8_t>(payload.begin(), payload.end());
+	};
+
+	SECTION(
+	  "EncodeSubchannels() encodes subchannels and requiredSubchannel and DecodeSubchannels() decodes them back")
+	{
+		const std::vector<uint8_t> originalPayload = { 0x01, 0x02, 0x03, 0x04 };
+
+		auto message = makeMessage(originalPayload);
+
+		const std::vector<uint16_t> subchannels          = { 10, 20, 300 };
+		const std::optional<uint16_t> requiredSubchannel = 5;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::EncodeSubchannels(message, subchannels, requiredSubchannel) == true);
+
+		// 8 (Magic Token) + 2 (subchannelsCount) + 3 * 2 (subchannels) + 2 (requiredSubchannel).
+		REQUIRE(message.GetPayloadLength() == originalPayload.size() + 8 + 2 + (3 * 2) + 2);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == true);
+
+		REQUIRE(decodedSubchannels == subchannels);
+		REQUIRE(decodedRequiredSubchannel == requiredSubchannel);
+		// The header must have been removed, leaving the original payload.
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("EncodeSubchannels() encodes subchannels without requiredSubchannel")
+	{
+		const std::vector<uint8_t> originalPayload = { 0xAA, 0xBB };
+
+		auto message = makeMessage(originalPayload);
+
+		const std::vector<uint16_t> subchannels = { 1, 2 };
+
+		REQUIRE(RTC::SubchannelsCodec::EncodeSubchannels(message, subchannels, std::nullopt) == true);
+
+		// 8 (Magic Token) + 2 (subchannelsCount) + 2 * 2 (subchannels).
+		REQUIRE(message.GetPayloadLength() == originalPayload.size() + 8 + 2 + (2 * 2));
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == true);
+
+		REQUIRE(decodedSubchannels == subchannels);
+		REQUIRE(decodedRequiredSubchannel.has_value() == false);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("EncodeSubchannels() encodes requiredSubchannel without subchannels")
+	{
+		const std::vector<uint8_t> originalPayload = { 0xAA, 0xBB, 0xCC };
+
+		auto message = makeMessage(originalPayload);
+
+		const std::optional<uint16_t> requiredSubchannel = 4321;
+
+		REQUIRE(RTC::SubchannelsCodec::EncodeSubchannels(message, {}, requiredSubchannel) == true);
+
+		// 8 (Magic Token) + 2 (subchannelsCount) + 2 (requiredSubchannel).
+		REQUIRE(message.GetPayloadLength() == originalPayload.size() + 8 + 2 + 2);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == true);
+
+		REQUIRE(decodedSubchannels.empty() == true);
+		REQUIRE(decodedRequiredSubchannel == requiredSubchannel);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("EncodeSubchannels() does nothing if there is nothing to encode")
+	{
+		const std::vector<uint8_t> originalPayload = { 0x01, 0x02 };
+
+		auto message = makeMessage(originalPayload);
+
+		REQUIRE(RTC::SubchannelsCodec::EncodeSubchannels(message, {}, std::nullopt) == false);
+
+		// The message must remain untouched.
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("DecodeSubchannels() does nothing if the message does not start with the Magic Token")
+	{
+		const std::vector<uint8_t> originalPayload(12);
+
+		auto message = makeMessage(originalPayload);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == false);
+
+		REQUIRE(decodedSubchannels.empty() == true);
+		REQUIRE(decodedRequiredSubchannel.has_value() == false);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("DecodeSubchannels() does nothing if the message is shorter than the Magic Token")
+	{
+		const std::vector<uint8_t> originalPayload = { 0x01, 0x02 };
+
+		auto message = makeMessage(originalPayload);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == false);
+
+		REQUIRE(decodedSubchannels.empty() == true);
+		REQUIRE(decodedRequiredSubchannel.has_value() == false);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION(
+	  "DecodeSubchannels() ignores a truncated message that announces more subchannels than present")
+	{
+		// Craft a payload with the Magic Token (no requiredSubchannelFlag) that
+		// announces 3 subchannels but does not carry their bytes.
+		std::vector<uint8_t> originalPayload(10);
+
+		Utils::Byte::Set8Bytes(originalPayload.data(), 0, RTC::SubchannelsCodec::MagicToken);
+		Utils::Byte::Set2Bytes(originalPayload.data(), 8, /*subchannelsCount*/ 3);
+
+		auto message = makeMessage(originalPayload);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == false);
+
+		REQUIRE(decodedSubchannels.empty() == true);
+		REQUIRE(decodedRequiredSubchannel.has_value() == false);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION(
+	  "DecodeSubchannels() ignores a message whose requiredSubchannelFlag is set but has no room for the requiredSubchannel field")
+	{
+		// Craft a payload with the Magic Token and requiredSubchannelFlag set,
+		// announcing 1 subchannel (present) but without the requiredSubchannel bytes.
+		std::vector<uint8_t> originalPayload(12);
+
+		Utils::Byte::Set8Bytes(
+		  originalPayload.data(),
+		  0,
+		  RTC::SubchannelsCodec::MagicToken | RTC::SubchannelsCodec::RequiredSubchannelFlagMask);
+		Utils::Byte::Set2Bytes(originalPayload.data(), 8, /*subchannelsCount*/ 1);
+		Utils::Byte::Set2Bytes(originalPayload.data(), 10, /*subchannel*/ 42);
+
+		auto message = makeMessage(originalPayload);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == false);
+
+		REQUIRE(decodedSubchannels.empty() == true);
+		REQUIRE(decodedRequiredSubchannel.has_value() == false);
+		REQUIRE(payloadToVector(message) == originalPayload);
+	}
+
+	SECTION("EncodeSubchannels() and DecodeSubchannels() work with an empty original payload")
+	{
+		auto message = makeMessage({});
+
+		const std::vector<uint16_t> subchannels          = { 7 };
+		const std::optional<uint16_t> requiredSubchannel = 7;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::EncodeSubchannels(message, subchannels, requiredSubchannel) == true);
+
+		std::vector<uint16_t> decodedSubchannels;
+		std::optional<uint16_t> decodedRequiredSubchannel;
+
+		REQUIRE(
+		  RTC::SubchannelsCodec::DecodeSubchannels(
+		    message, decodedSubchannels, decodedRequiredSubchannel) == true);
+
+		REQUIRE(decodedSubchannels == subchannels);
+		REQUIRE(decodedRequiredSubchannel == requiredSubchannel);
+		REQUIRE(message.GetPayloadLength() == 0);
+	}
+}