livekit-client 2.13.7 → 2.14.0

package/src/room/track/Track.ts

@@ -529,4 +529,5 @@ export type TrackEventCallbacks = {
   audioTrackFeatureUpdate: (track: any, feature: AudioTrackFeature, enabled: boolean) => void;
   timeSyncUpdate: (update: { timestamp: number; rtpTimestamp: number }) => void;
   preConnectBufferFlushed: (buffer: Uint8Array[]) => void;
+  cpuConstrained: () => void;
 };

package/src/room/track/TrackPublication.ts

@@ -179,4 +179,5 @@ export type PublicationEventCallbacks = {
   subscriptionFailed: (error: SubscriptionError) => void;
   transcriptionReceived: (transcription: TranscriptionSegment[]) => void;
   timeSyncUpdate: (timestamp: number) => void;
+  cpuConstrained: (track: LocalVideoTrack) => void;
 };

package/src/room/track/create.ts

@@ -3,7 +3,7 @@ import { audioDefaults, videoDefaults } from '../defaults';
 import { DeviceUnsupportedError, TrackInvalidError } from '../errors';
 import { mediaTrackToLocalTrack } from '../participant/publishUtils';
 import type { LoggerOptions } from '../types';
-import { isAudioTrack, isSafari17, isVideoTrack, unwrapConstraint } from '../utils';
+import { isAudioTrack, isSafari17Based, isVideoTrack, unwrapConstraint } from '../utils';
 import LocalAudioTrack from './LocalAudioTrack';
 import type LocalTrack from './LocalTrack';
 import LocalVideoTrack from './LocalVideoTrack';
@@ -198,7 +198,7 @@ export async function createLocalScreenTracks(
   if (options === undefined) {
     options = {};
   }
-  if (options.resolution === undefined && !isSafari17()) {
+  if (options.resolution === undefined && !isSafari17Based()) {
     options.resolution = ScreenSharePresets.h1080fps30.resolution;
   }
 

package/src/room/track/options.ts

@@ -173,6 +173,11 @@ export interface VideoCaptureOptions {
    */
   deviceId?: ConstrainDOMString;
 
+  /**
+   * A ConstrainDouble specifying the frame rate or range of frame rates which are acceptable and/or required.
+   */
+  frameRate?: ConstrainDouble;
+
   /**
    * a facing or an array of facings which are acceptable and/or required.
    */

package/src/room/utils.ts

@@ -96,6 +96,14 @@ export function supportsVP9(): boolean {
       // Safari 16 and below does not support VP9
       return false;
     }
+    if (
+      browser?.os === 'iOS' &&
+      browser?.osVersion &&
+      compareVersions(browser.osVersion, '16') < 0
+    ) {
+      // Safari 16 and below on iOS does not support VP9 we need the iOS check to account for other browsers running webkit under the hood
+      return false;
+    }
   }
   const capabilities = RTCRtpSender.getCapabilities('video');
   let hasVP9 = false;
@@ -148,9 +156,12 @@ export function isSafariBased(): boolean {
   return b?.name === 'Safari' || b?.os === 'iOS';
 }
 
-export function isSafari17(): boolean {
+export function isSafari17Based(): boolean {
   const b = getBrowser();
-  return b?.name === 'Safari' && b.version.startsWith('17.');
+  return (
+    (b?.name === 'Safari' && b.version.startsWith('17.')) ||
+    (b?.os === 'iOS' && !!b?.osVersion && compareVersions(b.osVersion, '17') >= 0)
+  );
 }
 
 export function isSafariSvcApi(browser?: BrowserDetails): boolean {
@@ -158,7 +169,12 @@ export function isSafariSvcApi(browser?: BrowserDetails): boolean {
     browser = getBrowser();
   }
   // Safari 18.4 requires legacy svc api and scaleResolutionDown to be set
-  return browser?.name === 'Safari' && compareVersions(browser.version, '18.3') > 0;
+  return (
+    (browser?.name === 'Safari' && compareVersions(browser.version, '18.3') > 0) ||
+    (browser?.os === 'iOS' &&
+      !!browser?.osVersion &&
+      compareVersions(browser.osVersion, '18.3') > 0)
+  );
 }
 
 export function isMobile(): boolean {