@abrar71/lib-jitsi-meet 0.0.0

package/dist/esm/modules/sdp/RtxModifier.js

@@ -0,0 +1,179 @@
+import { getLogger } from '@jitsi/logger';
+import { MediaDirection } from '../../service/RTC/MediaDirection';
+import { MediaType } from '../../service/RTC/MediaType';
+import { SSRC_GROUP_SEMANTICS } from '../../service/RTC/StandardVideoQualitySettings';
+import SDPUtil from './SDPUtil';
+import { SdpTransformWrap, parseSecondarySSRC } from './SdpTransformUtil';
+const logger = getLogger('sdp:RtxModifier');
+/**
+ * Begin helper functions
+ */
+/**
+ * Updates or inserts the appropriate rtx information for primarySsrc with
+ *  the given rtxSsrc.  If no rtx ssrc for primarySsrc currently exists, it will
+ *  add the appropriate ssrc and ssrc group lines.  If primarySsrc already has
+ *  an rtx ssrc, the appropriate ssrc and group lines will be updated
+ * @param {MLineWrap} mLine
+ * @param {object} primarySsrcInfo the info (ssrc, msid & cname) for the
+ *  primary ssrc
+ * @param {number} rtxSsrc the rtx ssrc to associate with the primary ssrc
+ */
+function updateAssociatedRtxStream(mLine, primarySsrcInfo, rtxSsrc) {
+    const primarySsrc = primarySsrcInfo.id;
+    const primarySsrcMsid = primarySsrcInfo.msid;
+    const primarySsrcCname = primarySsrcInfo.cname;
+    const previousRtxSSRC = mLine.getRtxSSRC(primarySsrc);
+    if (previousRtxSSRC === rtxSsrc) {
+        return;
+    }
+    if (previousRtxSSRC) {
+        // Stream already had an rtx ssrc that is different than the one given,
+        //  remove all trace of the old one
+        mLine.removeSSRC(previousRtxSSRC);
+        mLine.removeGroupsWithSSRC(previousRtxSSRC);
+    }
+    mLine.addSSRCAttribute({
+        attribute: 'cname',
+        id: rtxSsrc,
+        value: primarySsrcCname
+    });
+    primarySsrcMsid && mLine.addSSRCAttribute({
+        attribute: 'msid',
+        id: rtxSsrc,
+        value: primarySsrcMsid
+    });
+    mLine.addSSRCGroup({
+        semantics: SSRC_GROUP_SEMANTICS.FID,
+        ssrcs: `${primarySsrc} ${rtxSsrc}`
+    });
+}
+/**
+ * End helper functions
+ */
+/**
+ * Adds any missing RTX streams for video streams
+ *  and makes sure that they remain consistent
+ */
+export default class RtxModifier {
+    /**
+     * Constructor
+     */
+    constructor() {
+        /**
+         * Map of video ssrc to corresponding RTX
+         *  ssrc
+         */
+        this.correspondingRtxSsrcs = new Map();
+    }
+    /**
+     * Clear the cached map of primary video ssrcs to
+     *  their corresponding rtx ssrcs so that they will
+     *  not be used for the next call to modifyRtxSsrcs
+     */
+    clearSsrcCache() {
+        this.correspondingRtxSsrcs.clear();
+    }
+    /**
+     * Explicitly set the primary video ssrc -> rtx ssrc
+     *  mapping to be used in modifyRtxSsrcs
+     * @param {Map} ssrcMapping a mapping of primary video
+     *  ssrcs to their corresponding rtx ssrcs
+     */
+    setSsrcCache(ssrcMapping) {
+        logger.debug('Setting ssrc cache to ', ssrcMapping);
+        this.correspondingRtxSsrcs = ssrcMapping;
+    }
+    /**
+     * Adds RTX ssrcs for any video ssrcs that don't already have them.  If the video ssrc has been seen before, and
+     * already had an RTX ssrc generated, the same RTX ssrc will be used again.
+     *
+     * @param {string} sdpStr sdp in raw string format
+     * @returns {string} The modified sdp in raw string format.
+     */
+    modifyRtxSsrcs(sdpStr) {
+        let modified = false;
+        const sdpTransformer = new SdpTransformWrap(sdpStr);
+        const videoMLines = sdpTransformer.selectMedia(MediaType.VIDEO);
+        if (!videoMLines?.length) {
+            logger.debug(`No 'video' media found in the sdp: ${sdpStr}`);
+            return sdpStr;
+        }
+        for (const videoMLine of videoMLines) {
+            if (this.modifyRtxSsrcs2(videoMLine)) {
+                modified = true;
+            }
+        }
+        return modified ? sdpTransformer.toRawSDP() : sdpStr;
+    }
+    /**
+     * Does the same thing as {@link modifyRtxSsrcs}, but takes the {@link MLineWrap} instance wrapping video media as
+     * an argument.
+     * @param {MLineWrap} videoMLine
+     * @return {boolean} <tt>true</tt> if the SDP wrapped by {@link SdpTransformWrap} has been modified or
+     * <tt>false</tt> otherwise.
+     */
+    modifyRtxSsrcs2(videoMLine) {
+        if (videoMLine.direction === MediaDirection.RECVONLY) {
+            return false;
+        }
+        if (videoMLine.getSSRCCount() < 1) {
+            return false;
+        }
+        const primaryVideoSsrcs = videoMLine.getPrimaryVideoSSRCs();
+        for (const ssrc of primaryVideoSsrcs) {
+            const msid = videoMLine.getSSRCAttrValue(ssrc, 'msid');
+            const cname = videoMLine.getSSRCAttrValue(ssrc, 'cname');
+            let correspondingRtxSsrc = this.correspondingRtxSsrcs.get(ssrc);
+            if (!correspondingRtxSsrc) {
+                // If there's one in the sdp already for it, we'll just set
+                //  that as the corresponding one
+                const previousAssociatedRtxStream = videoMLine.getRtxSSRC(ssrc);
+                if (previousAssociatedRtxStream) {
+                    correspondingRtxSsrc = previousAssociatedRtxStream;
+                }
+                else {
+                    correspondingRtxSsrc = SDPUtil.generateSsrc();
+                }
+                this.correspondingRtxSsrcs.set(ssrc, correspondingRtxSsrc);
+            }
+            updateAssociatedRtxStream(videoMLine, {
+                cname,
+                id: ssrc,
+                msid
+            }, correspondingRtxSsrc);
+        }
+        // FIXME we're not looking into much details whether the SDP has been
+        // modified or not once the precondition requirements are met.
+        return true;
+    }
+    /**
+     * Strip all rtx streams from the given sdp.
+     *
+     * @param {string} sdpStr sdp in raw string format
+     * @returns {string} sdp string with all rtx streams stripped
+     */
+    stripRtx(sdpStr) {
+        const sdpTransformer = new SdpTransformWrap(sdpStr);
+        const videoMLines = sdpTransformer.selectMedia(MediaType.VIDEO);
+        if (!videoMLines?.length) {
+            logger.debug(`No 'video' media found in the sdp: ${sdpStr}`);
+            return sdpStr;
+        }
+        for (const videoMLine of videoMLines) {
+            if (videoMLine.direction !== MediaDirection.RECVONLY
+                && videoMLine.getSSRCCount()
+                && videoMLine.containsAnySSRCGroups()) {
+                const fidGroups = videoMLine.findGroups(SSRC_GROUP_SEMANTICS.FID);
+                // Remove the fid groups from the mline
+                videoMLine.removeGroupsBySemantics(SSRC_GROUP_SEMANTICS.FID);
+                // Get the rtx ssrcs and remove them from the mline
+                for (const fidGroup of fidGroups) {
+                    const rtxSsrc = parseSecondarySSRC(fidGroup);
+                    videoMLine.removeSSRC(rtxSsrc);
+                }
+            }
+        }
+        return sdpTransformer.toRawSDP();
+    }
+}
+//# sourceMappingURL=RtxModifier.js.map

package/dist/esm/modules/sdp/RtxModifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RtxModifier.js","sourceRoot":"","sources":["../../../../modules/sdp/RtxModifier.js"],"names":[],"mappings":"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"}