livekit-client 2.0.7 → 2.0.9

package/dist/livekit-client.esm.mjs

@@ -12538,7 +12538,8 @@ const KEY_PROVIDER_DEFAULTS = {
   sharedKey: false,
   ratchetSalt: SALT,
   ratchetWindowSize: 8,
-  failureTolerance: DECRYPTION_FAILURE_TOLERANCE
+  failureTolerance: DECRYPTION_FAILURE_TOLERANCE,
+  keyringSize: 16
 };
 
 var KeyProviderEvent;
@@ -13473,7 +13474,7 @@ function getMatch(exp, ua) {
   return match && match.length >= id && match[id] || '';
 }
 
-var version$1 = "2.0.7";
+var version$1 = "2.0.9";
 
 const version = version$1;
 const protocolVersion = 12;
@@ -15037,6 +15038,13 @@ class LocalTrack extends Track {
       const unlock = yield this.processorLock.lock();
       try {
         this.log.debug('setting up processor', this.logContext);
+        const processorOptions = {
+          kind: this.kind,
+          track: this._mediaStreamTrack,
+          element: this.processorElement,
+          audioContext: this.audioContext
+        };
+        yield processor.init(processorOptions);
         if (this.processor) {
           yield this.stopProcessor();
         }
@@ -15049,13 +15057,6 @@ class LocalTrack extends Track {
         this.processorElement.play().catch(error => this.log.error('failed to play processor element', Object.assign(Object.assign({}, this.logContext), {
           error
         })));
-        const processorOptions = {
-          kind: this.kind,
-          track: this._mediaStreamTrack,
-          element: this.processorElement,
-          audioContext: this.audioContext
-        };
-        yield processor.init(processorOptions);
         this.processor = processor;
         if (this.processor.processedTrack) {
           for (const el of this.attachedElements) {
@@ -15092,7 +15093,10 @@ class LocalTrack extends Track {
       this.processor = undefined;
       (_b = this.processorElement) === null || _b === void 0 ? void 0 : _b.remove();
       this.processorElement = undefined;
-      yield this.restart();
+      // apply original track constraints in case the processor changed them
+      yield this._mediaStreamTrack.applyConstraints(this._constraints);
+      // force re-setting of the mediaStreamTrack on the sender
+      yield this.setMediaStreamTrack(this._mediaStreamTrack, true);
       this.emit(TrackEvent.TrackProcessorUpdate);
     });
   }
@@ -17032,25 +17036,18 @@ class PCTransport extends eventsExports.EventEmitter {
             if (codecPayload === 0) {
               return true;
             }
-            let fmtpFound = false;
+            const startBitrate = Math.round(trackbr.maxbr * startBitrateForSVC);
             for (const fmtp of media.fmtp) {
               if (fmtp.payload === codecPayload) {
+                // if another track's fmtp already is set, we cannot override the bitrate
+                // this has the unfortunate consequence of being forced to use the
+                // initial track's bitrate for all tracks
                 if (!fmtp.config.includes('x-google-start-bitrate')) {
-                  fmtp.config += ";x-google-start-bitrate=".concat(Math.round(trackbr.maxbr * startBitrateForSVC));
+                  fmtp.config += ";x-google-start-bitrate=".concat(startBitrate);
                 }
-                if (!fmtp.config.includes('x-google-max-bitrate')) {
-                  fmtp.config += ";x-google-max-bitrate=".concat(trackbr.maxbr);
-                }
-                fmtpFound = true;
                 break;
               }
             }
-            if (!fmtpFound) {
-              media.fmtp.push({
-                payload: codecPayload,
-                config: "x-google-start-bitrate=".concat(Math.round(trackbr.maxbr * startBitrateForSVC), ";x-google-max-bitrate=").concat(trackbr.maxbr)
-              });
-            }
             return true;
           });
         }
@@ -18179,12 +18176,13 @@ class RTCEngine extends eventsExports.EventEmitter {
     this.reliableDC.onbufferedamountlow = this.handleBufferedAmountLow;
   }
   setPreferredCodec(transceiver, kind, videoCodec) {
-    if (!('getCapabilities' in RTCRtpSender)) {
+    if (!('getCapabilities' in RTCRtpReceiver)) {
       return;
     }
-    const cap = RTCRtpSender.getCapabilities(kind);
+    // when setting codec preferences, the capabilites need to be read from the RTCRtpReceiver
+    const cap = RTCRtpReceiver.getCapabilities(kind);
     if (!cap) return;
-    this.log.debug('get sender capabilities', Object.assign(Object.assign({}, this.logContext), {
+    this.log.debug('get receiver capabilities', Object.assign(Object.assign({}, this.logContext), {
       cap
     }));
     const matched = [];
@@ -19086,23 +19084,40 @@ function computeVideoEncodings(isScreenShare, width, height, options) {
   }
   const original = new VideoPreset(width, height, videoEncoding.maxBitrate, videoEncoding.maxFramerate, videoEncoding.priority);
   if (scalabilityMode && isSVCCodec(videoCodec)) {
-    livekitLogger.debug("using svc with scalabilityMode ".concat(scalabilityMode));
     const sm = new ScalabilityMode(scalabilityMode);
     const encodings = [];
     if (sm.spatial > 3) {
       throw new Error("unsupported scalabilityMode: ".concat(scalabilityMode));
     }
-    for (let i = 0; i < sm.spatial; i += 1) {
+    // Before M113 in Chrome, defining multiple encodings with an SVC codec indicated
+    // that SVC mode should be used. Safari still works this way.
+    // This is a bit confusing but is due to how libwebrtc interpreted the encodings field
+    // before M113.
+    // Announced here: https://groups.google.com/g/discuss-webrtc/c/-QQ3pxrl-fw?pli=1
+    const browser = getBrowser();
+    if (isSafari() || (browser === null || browser === void 0 ? void 0 : browser.name) === 'Chrome' && compareVersions(browser === null || browser === void 0 ? void 0 : browser.version, '113') < 0) {
+      for (let i = 0; i < sm.spatial; i += 1) {
+        // in legacy SVC, scaleResolutionDownBy cannot be set
+        encodings.push({
+          rid: videoRids[2 - i],
+          maxBitrate: videoEncoding.maxBitrate / Math.pow(3, i),
+          maxFramerate: original.encoding.maxFramerate
+        });
+      }
+      // legacy SVC, scalabilityMode is set only on the first encoding
+      /* @ts-ignore */
+      encodings[0].scalabilityMode = scalabilityMode;
+    } else {
       encodings.push({
-        rid: videoRids[2 - i],
-        maxBitrate: videoEncoding.maxBitrate / Math.pow(3, i),
+        maxBitrate: videoEncoding.maxBitrate,
+        maxFramerate: original.encoding.maxFramerate,
         /* @ts-ignore */
-        maxFramerate: original.encoding.maxFramerate
+        scalabilityMode: scalabilityMode
       });
     }
-    /* @ts-ignore */
-    encodings[0].scalabilityMode = scalabilityMode;
-    livekitLogger.debug('encodings', encodings);
+    livekitLogger.debug("using svc encoding", {
+      encodings
+    });
     return encodings;
   }
   if (!useSimulcast) {
@@ -19126,7 +19141,7 @@ function computeVideoEncodings(isScreenShare, width, height, options) {
     //      to disable when CPU constrained.
     //      So encodings should be ordered in increasing spatial
     //      resolution order.
-    //   2. ion-sfu translates rids into layers. So, all encodings
+    //   2. livekit-server translates rids into layers. So, all encodings
     //      should have the base layer `q` and then more added
     //      based on other conditions.
     const size = Math.max(width, height);
@@ -21521,8 +21536,10 @@ class LocalParticipant extends Participant {
         // for svc codecs, disable simulcast and use vp8 for backup codec
         if (track instanceof LocalVideoTrack) {
           if (isSVCCodec(videoCodec)) {
-            // vp9 svc with screenshare has problem to encode, always use L1T3 here
-            if (track.source === Track.Source.ScreenShare && videoCodec === 'vp9') {
+            if (track.source === Track.Source.ScreenShare) {
+              // vp9 svc with screenshare cannot encode multiple spatial layers
+              // doing so reduces publish resolution to minimal resolution
+              opts.scalabilityMode = 'L1T3';
               // Chrome does not allow more than 5 fps with L1T3, and it has encoding bugs with L3T3
               // It has a different path for screenshare handling and it seems to be untested/buggy
               // As a workaround, we are setting contentHint to force it to go through the same
@@ -21530,9 +21547,7 @@ class LocalParticipant extends Participant {
               // that we need
               if ('contentHint' in track.mediaStreamTrack) {
                 track.mediaStreamTrack.contentHint = 'motion';
-                this.log.info('forcing contentHint to motion for screenshare with VP9', Object.assign(Object.assign({}, this.logContext), getLogContextFromTrack(track)));
-              } else {
-                opts.scalabilityMode = 'L1T3';
+                this.log.info('forcing contentHint to motion for screenshare with SVC codecs', Object.assign(Object.assign({}, this.logContext), getLogContextFromTrack(track)));
               }
             }
             // set scalabilityMode to 'L3T3_KEY' by default
@@ -21632,7 +21647,8 @@ class LocalParticipant extends Participant {
               maxbr: ((_l = encodings[0]) === null || _l === void 0 ? void 0 : _l.maxBitrate) ? encodings[0].maxBitrate / 1000 : 0
             });
           }
-        } else if (track.codec && isSVCCodec(track.codec) && ((_m = encodings[0]) === null || _m === void 0 ? void 0 : _m.maxBitrate)) {
+        } else if (track.codec && track.codec == 'av1' && ((_m = encodings[0]) === null || _m === void 0 ? void 0 : _m.maxBitrate)) {
+          // AV1 requires setting x-start-bitrate in SDP
           this.engine.pcManager.publisher.setTrackCodecBitrate({
             cid: req.cid,
             codec: track.codec,
@@ -21640,6 +21656,19 @@ class LocalParticipant extends Participant {
           });
         }
       }
+      if (track.kind === Track.Kind.Video && track.source === Track.Source.ScreenShare) {
+        // a few of reasons we are forcing this setting without allowing overrides:
+        // 1. without this, Chrome seems to aggressively resize the SVC video stating `quality-limitation: bandwidth` even when BW isn't an issue
+        // 2. since we are overriding contentHint to motion (to workaround L1T3 publishing), it overrides the default degradationPreference to `balanced`
+        try {
+          this.log.debug("setting degradationPreference to maintain-resolution");
+          const params = track.sender.getParameters();
+          params.degradationPreference = 'maintain-resolution';
+          yield track.sender.setParameters(params);
+        } catch (e) {
+          this.log.warn("failed to set degradationPreference: ".concat(e));
+        }
+      }
       yield this.engine.negotiate();
       if (track instanceof LocalVideoTrack) {
         track.startMonitor(this.engine.client);
@@ -24612,5 +24641,5 @@ function isFacingModeValue(item) {
   return item === undefined || allowedValues.includes(item);
 }
 
-export { AudioPresets, BaseKeyProvider, ConnectionCheck, ConnectionError, ConnectionQuality, ConnectionState, CriticalTimers, CryptorEvent, DataPacket_Kind, DefaultReconnectPolicy, DeviceUnsupportedError, DisconnectReason, EncryptionEvent, EngineEvent, ExternalE2EEKeyProvider, KeyHandlerEvent, KeyProviderEvent, LivekitError, LocalAudioTrack, LocalParticipant, LocalTrack, LocalTrackPublication, LocalVideoTrack, LogLevel, LoggerNames, MediaDeviceFailure, NegotiationError, Participant, ParticipantEvent, PublishDataError, RemoteAudioTrack, RemoteParticipant, RemoteTrack, RemoteTrackPublication, RemoteVideoTrack, Room, RoomEvent, ScreenSharePresets, Track, TrackEvent, TrackInvalidError, TrackPublication, UnexpectedConnectionState, UnsupportedServer, VideoPreset, VideoPresets, VideoPresets43, VideoQuality, attachToElement, createAudioAnalyser, createE2EEKey, createKeyMaterialFromBuffer, createKeyMaterialFromString, createLocalAudioTrack, createLocalScreenTracks, createLocalTracks, createLocalVideoTrack, deriveKeys, detachTrack, facingModeFromDeviceLabel, facingModeFromLocalTrack, getEmptyAudioStreamTrack, getEmptyVideoStreamTrack, getLogger, importKey, isBackupCodec, isBrowserSupported, isE2EESupported, isInsertableStreamSupported, isScriptTransformSupported, isVideoFrame, needsRbspUnescaping, parseRbsp, protocolVersion, ratchet, setLogExtension, setLogLevel, supportsAV1, supportsAdaptiveStream, supportsDynacast, supportsVP9, version, videoCodecs, writeRbsp };
+export { AudioPresets, BaseKeyProvider, ConnectionCheck, ConnectionError, ConnectionQuality, ConnectionState, CriticalTimers, CryptorEvent, DataPacket_Kind, DefaultReconnectPolicy, DeviceUnsupportedError, DisconnectReason, EncryptionEvent, EngineEvent, ExternalE2EEKeyProvider, KeyHandlerEvent, KeyProviderEvent, LivekitError, LocalAudioTrack, LocalParticipant, LocalTrack, LocalTrackPublication, LocalVideoTrack, LogLevel, LoggerNames, MediaDeviceFailure, NegotiationError, Participant, ParticipantEvent, PublishDataError, RemoteAudioTrack, RemoteParticipant, RemoteTrack, RemoteTrackPublication, RemoteVideoTrack, Room, RoomEvent, ScreenSharePresets, SubscriptionError, Track, TrackEvent, TrackInvalidError, TrackPublication, UnexpectedConnectionState, UnsupportedServer, VideoPreset, VideoPresets, VideoPresets43, VideoQuality, attachToElement, createAudioAnalyser, createE2EEKey, createKeyMaterialFromBuffer, createKeyMaterialFromString, createLocalAudioTrack, createLocalScreenTracks, createLocalTracks, createLocalVideoTrack, deriveKeys, detachTrack, facingModeFromDeviceLabel, facingModeFromLocalTrack, getBrowser, getEmptyAudioStreamTrack, getEmptyVideoStreamTrack, getLogger, importKey, isBackupCodec, isBrowserSupported, isE2EESupported, isInsertableStreamSupported, isScriptTransformSupported, isVideoFrame, needsRbspUnescaping, parseRbsp, protocolVersion, ratchet, setLogExtension, setLogLevel, supportsAV1, supportsAdaptiveStream, supportsDynacast, supportsVP9, version, videoCodecs, writeRbsp };
 //# sourceMappingURL=livekit-client.esm.mjs.map