@whereby.com/media 1.21.1 → 1.22.0

package/dist/index.cjs

@@ -2635,7 +2635,9 @@ function getPreferredOrder(availableCodecs, { vp9On, av1On }) {
     return availableCodecs;
 }
 function sortCodecsByMimeType(codecs, features) {
-    const availableCodecs = codecs.map(({ mimeType }) => mimeType).filter((value, index, array) => array.indexOf(value) === index);
+    const availableCodecs = codecs
+        .map(({ mimeType }) => mimeType)
+        .filter((value, index, array) => array.indexOf(value) === index);
     const preferredOrder = getPreferredOrder(availableCodecs, features);
     return codecs.sort((a, b) => {
         const indexA = preferredOrder.indexOf(a.mimeType.toLowerCase());
@@ -2645,6 +2647,41 @@ function sortCodecsByMimeType(codecs, features) {
         return orderA - orderB;
     });
 }
+function getIsCodecDecodingPowerEfficient(codec) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { powerEfficient } = yield navigator.mediaCapabilities.decodingInfo({
+            type: "webrtc",
+            video: {
+                width: 1280,
+                height: 720,
+                bitrate: 2580,
+                framerate: 24,
+                contentType: codec,
+            },
+        });
+        return powerEfficient;
+    });
+}
+function sortCodecsByPowerEfficiency(codecs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const codecPowerEfficiencyEntries = yield Promise.all(codecs.map(({ mimeType }) => getIsCodecDecodingPowerEfficient(mimeType).then((val) => [mimeType, val])));
+        const codecPowerEfficiencies = Object.fromEntries(codecPowerEfficiencyEntries);
+        const sorted = codecs.sort((a, b) => {
+            const aPowerEfficient = codecPowerEfficiencies[a.mimeType];
+            const bPowerEfficient = codecPowerEfficiencies[b.mimeType];
+            return aPowerEfficient === bPowerEfficient ? 0 : aPowerEfficient ? -1 : 1;
+        });
+        return sorted;
+    });
+}
+function sortCodecs(codecs, features) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (features.preferHardwareDecodingOn) {
+            codecs = yield sortCodecsByPowerEfficiency(codecs);
+        }
+        return sortCodecsByMimeType(codecs, features);
+    });
+}
 
 const logger$8 = new Logger();
 class ReconnectManager extends EventEmitter {
@@ -3787,46 +3824,53 @@ class P2pRtcManager {
             this._negotiatePeerConnection(clientId, session, Object.assign({}, this.offerOptions, { iceRestart: true }));
         }
     }
-    _setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn, }) {
-        try {
-            const audioTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
-            audioTransceivers.forEach((audioTransceiver) => {
-                if (typeof RTCRtpSender.getCapabilities === "undefined")
-                    return;
-                const capabilities = RTCRtpSender.getCapabilities("audio");
-                for (let i = 0; i < capabilities.codecs.length; i++) {
-                    if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
-                        capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
-                        break;
+    _setCodecPreferences(pc) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { p2pVp9On, p2pAv1On, redOn, preferHardwareDecodingOn } = this._features;
+            if (!(p2pVp9On || p2pAv1On || redOn || preferHardwareDecodingOn)) {
+                return;
+            }
+            try {
+                const audioTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
+                audioTransceivers.forEach((audioTransceiver) => {
+                    if (typeof RTCRtpSender.getCapabilities === "undefined")
+                        return;
+                    const capabilities = RTCRtpSender.getCapabilities("audio");
+                    for (let i = 0; i < capabilities.codecs.length; i++) {
+                        if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
+                            capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
+                            break;
+                        }
                     }
-                }
-                if (typeof audioTransceiver.setCodecPreferences === "undefined")
-                    return;
-                audioTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-            const videoTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
-            videoTransceivers.forEach((videoTransceiver) => {
-                if (RTCRtpReceiver.getCapabilities === undefined)
-                    return;
-                const capabilities = RTCRtpReceiver.getCapabilities("video");
-                if (p2pVp9On || p2pAv1On) {
-                    capabilities.codecs = sortCodecsByMimeType(capabilities.codecs, {
-                        vp9On: p2pVp9On,
-                        av1On: p2pAv1On,
-                    });
-                }
-                if (videoTransceiver.setCodecPreferences === undefined)
-                    return;
-                videoTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-        }
-        catch (error) {
-            logger$7.error("Error during setting setCodecPreferences:", error);
-        }
+                    if (typeof audioTransceiver.setCodecPreferences === "undefined")
+                        return;
+                    audioTransceiver.setCodecPreferences(capabilities.codecs);
+                });
+                const videoTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
+                yield Promise.all(videoTransceivers.map((videoTransceiver) => __awaiter(this, void 0, void 0, function* () {
+                    if (RTCRtpReceiver.getCapabilities === undefined)
+                        return;
+                    if (videoTransceiver.setCodecPreferences === undefined)
+                        return;
+                    const capabilities = RTCRtpReceiver.getCapabilities("video");
+                    if (p2pVp9On || p2pAv1On || preferHardwareDecodingOn) {
+                        capabilities.codecs = yield sortCodecs(capabilities.codecs, {
+                            vp9On: p2pVp9On,
+                            av1On: p2pAv1On,
+                            preferHardwareDecodingOn,
+                        });
+                    }
+                    videoTransceiver.setCodecPreferences(capabilities.codecs);
+                })));
+            }
+            catch (error) {
+                logger$7.error("Error during setting setCodecPreferences:", error);
+            }
+        });
     }
     _negotiatePeerConnection(clientId, session, constraints) {
         if (!session) {
@@ -3841,11 +3885,9 @@ class P2pRtcManager {
             return;
         }
         session.isOperationPending = true;
-        const { p2pVp9On, p2pAv1On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
-        if (p2pVp9On || p2pAv1On || redOn) {
-            this._setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn });
-        }
-        pc.createOffer(constraints || this.offerOptions)
+        const { p2pVp9On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
+        this._setCodecPreferences(pc).then(() => pc
+            .createOffer(constraints || this.offerOptions)
             .then((offer) => {
             if (rtpAbsCaptureTimeOn)
                 offer.sdp = addAbsCaptureTimeExtMap(offer.sdp);
@@ -3869,7 +3911,7 @@ class P2pRtcManager {
         })
             .catch((e) => {
             logger$7.warn("RTCPeerConnection.createOffer() failed to create local offer", e);
-        });
+        }));
     }
     _withForcedRenegotiation(session, action) {
         const pc = session.pc;
@@ -8057,7 +8099,7 @@ exports.setClientProvider = setClientProvider;
 exports.setCodecPreferenceSDP = setCodecPreferenceSDP;
 exports.setPeerConnectionsForTests = setPeerConnectionsForTests;
 exports.setVideoBandwidthUsingSetParameters = setVideoBandwidthUsingSetParameters;
-exports.sortCodecsByMimeType = sortCodecsByMimeType;
+exports.sortCodecs = sortCodecs;
 exports.standardDeviation = standardDeviation;
 exports.startPerformanceMonitor = startPerformanceMonitor;
 exports.stopStreamTracks = stopStreamTracks;

package/dist/index.d.cts

@@ -541,11 +541,7 @@ declare class P2pRtcManager implements RtcManager {
     _monitorVideoTrack(track: CustomMediaStreamTrack): void;
     _connect(clientId: string): Promise<any>;
     _maybeRestartIce(clientId: string, session: any): void;
-    _setCodecPreferences(pc: RTCPeerConnection, { p2pVp9On, p2pAv1On, redOn, }: {
-        p2pVp9On?: boolean;
-        p2pAv1On?: boolean;
-        redOn?: boolean;
-    }): void;
+    _setCodecPreferences(pc: RTCPeerConnection): Promise<void>;
     _negotiatePeerConnection(clientId: string, session: any, constraints?: any): void;
     _withForcedRenegotiation(session: any, action: any): void;
     _changeBandwidthForAllClients(isJoining: boolean): number;
@@ -617,10 +613,11 @@ interface Codec {
     mimeType: string;
     sdpFmtpLine?: string;
 }
-declare function sortCodecsByMimeType(codecs: Codec[], features: {
+declare function sortCodecs(codecs: Codec[], features: {
     vp9On?: boolean;
     av1On?: boolean;
-}): Codec[];
+    preferHardwareDecodingOn?: boolean;
+}): Promise<Codec[]>;
 
 declare function getOptimalBitrate(width: number, height: number, frameRate: number): number;
 
@@ -1666,4 +1663,4 @@ declare class RtcStream {
     static getTypeFromId(id: string): string;
 }
 
-export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecsByMimeType, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
+export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };

package/dist/index.d.mts

@@ -541,11 +541,7 @@ declare class P2pRtcManager implements RtcManager {
     _monitorVideoTrack(track: CustomMediaStreamTrack): void;
     _connect(clientId: string): Promise<any>;
     _maybeRestartIce(clientId: string, session: any): void;
-    _setCodecPreferences(pc: RTCPeerConnection, { p2pVp9On, p2pAv1On, redOn, }: {
-        p2pVp9On?: boolean;
-        p2pAv1On?: boolean;
-        redOn?: boolean;
-    }): void;
+    _setCodecPreferences(pc: RTCPeerConnection): Promise<void>;
     _negotiatePeerConnection(clientId: string, session: any, constraints?: any): void;
     _withForcedRenegotiation(session: any, action: any): void;
     _changeBandwidthForAllClients(isJoining: boolean): number;
@@ -617,10 +613,11 @@ interface Codec {
     mimeType: string;
     sdpFmtpLine?: string;
 }
-declare function sortCodecsByMimeType(codecs: Codec[], features: {
+declare function sortCodecs(codecs: Codec[], features: {
     vp9On?: boolean;
     av1On?: boolean;
-}): Codec[];
+    preferHardwareDecodingOn?: boolean;
+}): Promise<Codec[]>;
 
 declare function getOptimalBitrate(width: number, height: number, frameRate: number): number;
 
@@ -1666,4 +1663,4 @@ declare class RtcStream {
     static getTypeFromId(id: string): string;
 }
 
-export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecsByMimeType, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
+export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };

package/dist/index.d.ts

@@ -541,11 +541,7 @@ declare class P2pRtcManager implements RtcManager {
     _monitorVideoTrack(track: CustomMediaStreamTrack): void;
     _connect(clientId: string): Promise<any>;
     _maybeRestartIce(clientId: string, session: any): void;
-    _setCodecPreferences(pc: RTCPeerConnection, { p2pVp9On, p2pAv1On, redOn, }: {
-        p2pVp9On?: boolean;
-        p2pAv1On?: boolean;
-        redOn?: boolean;
-    }): void;
+    _setCodecPreferences(pc: RTCPeerConnection): Promise<void>;
     _negotiatePeerConnection(clientId: string, session: any, constraints?: any): void;
     _withForcedRenegotiation(session: any, action: any): void;
     _changeBandwidthForAllClients(isJoining: boolean): number;
@@ -617,10 +613,11 @@ interface Codec {
     mimeType: string;
     sdpFmtpLine?: string;
 }
-declare function sortCodecsByMimeType(codecs: Codec[], features: {
+declare function sortCodecs(codecs: Codec[], features: {
     vp9On?: boolean;
     av1On?: boolean;
-}): Codec[];
+    preferHardwareDecodingOn?: boolean;
+}): Promise<Codec[]>;
 
 declare function getOptimalBitrate(width: number, height: number, frameRate: number): number;
 
@@ -1666,4 +1663,4 @@ declare class RtcStream {
     static getTypeFromId(id: string): string;
 }
 
-export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecsByMimeType, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
+export { type AddSpotlightRequest, type AudioEnableRequest, type AudioEnableRequestedEvent, type AudioEnabledEvent, BandwidthTester, type BreakoutConfig, type BreakoutGroupJoinedEvent, type BreakoutSessionUpdatedEvent, type ChatMessage, type ClientKickedEvent, type ClientLeftEvent, type ClientMetadataPayload, type ClientMetadataReceivedEvent, type ClientRole, type ClientUnableToJoinEvent, type CloudRecordingStartedEvent, type Codec, type Credentials, type CustomMediaStreamTrack, EVENTS, type GetConstraintsOptions, type GetDeviceDataResult, type GetMediaConstraintsOptions, type GetStreamOptions, type GetStreamResult, type GetUpdatedDevicesResult, type IdentifyDeviceRequest, type IssuesAndMetricsByView, type JoinRoomRequest, KNOCK_MESSAGES, KalmanFilter, type KnockAcceptedEvent, type KnockRejectedEvent, type KnockRoomRequest, type KnockerLeftEvent, type LiveTranscriptionStartedEvent, type LiveTranscriptionStoppedEvent, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, type NewClientEvent, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, type RemoveSpotlightRequest, type RoleName, type RoomJoinedEvent, type RoomKnockedEvent, type RoomLockedEvent, type RoomSessionEndedEvent, type RtcClientConnectionStatusChangedPayload, RtcEventNames, type RtcEvents, type RtcLocalStreamTrackAddedPayload, type RtcLocalStreamTrackRemovedPayload, type RtcManager, type RtcManagerCreatedPayload, RtcManagerDispatcher, RtcStream, type RtcStreamAddedPayload, STREAM_TYPES, type ScreenshareStartedEvent, type ScreenshareStoppedEvent, type SendClientMetadataRequest, ServerSocket, Session, SfuV2Parser, type SignalClient, type SignalEvents, type SignalKnocker, type SignalRequests, type SocketConf, type SocketManager, type Spotlight, type SpotlightAddedEvent, type SpotlightRemovedEvent, type StatsMonitorOptions, type StatsMonitorState, type StatsSubscription, TYPES, type TrackStats, type TurnTransportProtocol, type UpdatedDeviceInfo, type UpdatedDevicesInfo, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, type VideoEnableRequest, type VideoEnableRequestedEvent, type VideoEnabledEvent, type ViewStats, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, _default as rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, type ssrcStats, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };

package/dist/index.mjs

@@ -2610,7 +2610,9 @@ function getPreferredOrder(availableCodecs, { vp9On, av1On }) {
     return availableCodecs;
 }
 function sortCodecsByMimeType(codecs, features) {
-    const availableCodecs = codecs.map(({ mimeType }) => mimeType).filter((value, index, array) => array.indexOf(value) === index);
+    const availableCodecs = codecs
+        .map(({ mimeType }) => mimeType)
+        .filter((value, index, array) => array.indexOf(value) === index);
     const preferredOrder = getPreferredOrder(availableCodecs, features);
     return codecs.sort((a, b) => {
         const indexA = preferredOrder.indexOf(a.mimeType.toLowerCase());
@@ -2620,6 +2622,41 @@ function sortCodecsByMimeType(codecs, features) {
         return orderA - orderB;
     });
 }
+function getIsCodecDecodingPowerEfficient(codec) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { powerEfficient } = yield navigator.mediaCapabilities.decodingInfo({
+            type: "webrtc",
+            video: {
+                width: 1280,
+                height: 720,
+                bitrate: 2580,
+                framerate: 24,
+                contentType: codec,
+            },
+        });
+        return powerEfficient;
+    });
+}
+function sortCodecsByPowerEfficiency(codecs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const codecPowerEfficiencyEntries = yield Promise.all(codecs.map(({ mimeType }) => getIsCodecDecodingPowerEfficient(mimeType).then((val) => [mimeType, val])));
+        const codecPowerEfficiencies = Object.fromEntries(codecPowerEfficiencyEntries);
+        const sorted = codecs.sort((a, b) => {
+            const aPowerEfficient = codecPowerEfficiencies[a.mimeType];
+            const bPowerEfficient = codecPowerEfficiencies[b.mimeType];
+            return aPowerEfficient === bPowerEfficient ? 0 : aPowerEfficient ? -1 : 1;
+        });
+        return sorted;
+    });
+}
+function sortCodecs(codecs, features) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (features.preferHardwareDecodingOn) {
+            codecs = yield sortCodecsByPowerEfficiency(codecs);
+        }
+        return sortCodecsByMimeType(codecs, features);
+    });
+}
 
 const logger$8 = new Logger();
 class ReconnectManager extends EventEmitter {
@@ -3762,46 +3799,53 @@ class P2pRtcManager {
             this._negotiatePeerConnection(clientId, session, Object.assign({}, this.offerOptions, { iceRestart: true }));
         }
     }
-    _setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn, }) {
-        try {
-            const audioTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
-            audioTransceivers.forEach((audioTransceiver) => {
-                if (typeof RTCRtpSender.getCapabilities === "undefined")
-                    return;
-                const capabilities = RTCRtpSender.getCapabilities("audio");
-                for (let i = 0; i < capabilities.codecs.length; i++) {
-                    if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
-                        capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
-                        break;
+    _setCodecPreferences(pc) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { p2pVp9On, p2pAv1On, redOn, preferHardwareDecodingOn } = this._features;
+            if (!(p2pVp9On || p2pAv1On || redOn || preferHardwareDecodingOn)) {
+                return;
+            }
+            try {
+                const audioTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
+                audioTransceivers.forEach((audioTransceiver) => {
+                    if (typeof RTCRtpSender.getCapabilities === "undefined")
+                        return;
+                    const capabilities = RTCRtpSender.getCapabilities("audio");
+                    for (let i = 0; i < capabilities.codecs.length; i++) {
+                        if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
+                            capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
+                            break;
+                        }
                     }
-                }
-                if (typeof audioTransceiver.setCodecPreferences === "undefined")
-                    return;
-                audioTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-            const videoTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
-            videoTransceivers.forEach((videoTransceiver) => {
-                if (RTCRtpReceiver.getCapabilities === undefined)
-                    return;
-                const capabilities = RTCRtpReceiver.getCapabilities("video");
-                if (p2pVp9On || p2pAv1On) {
-                    capabilities.codecs = sortCodecsByMimeType(capabilities.codecs, {
-                        vp9On: p2pVp9On,
-                        av1On: p2pAv1On,
-                    });
-                }
-                if (videoTransceiver.setCodecPreferences === undefined)
-                    return;
-                videoTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-        }
-        catch (error) {
-            logger$7.error("Error during setting setCodecPreferences:", error);
-        }
+                    if (typeof audioTransceiver.setCodecPreferences === "undefined")
+                        return;
+                    audioTransceiver.setCodecPreferences(capabilities.codecs);
+                });
+                const videoTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
+                yield Promise.all(videoTransceivers.map((videoTransceiver) => __awaiter(this, void 0, void 0, function* () {
+                    if (RTCRtpReceiver.getCapabilities === undefined)
+                        return;
+                    if (videoTransceiver.setCodecPreferences === undefined)
+                        return;
+                    const capabilities = RTCRtpReceiver.getCapabilities("video");
+                    if (p2pVp9On || p2pAv1On || preferHardwareDecodingOn) {
+                        capabilities.codecs = yield sortCodecs(capabilities.codecs, {
+                            vp9On: p2pVp9On,
+                            av1On: p2pAv1On,
+                            preferHardwareDecodingOn,
+                        });
+                    }
+                    videoTransceiver.setCodecPreferences(capabilities.codecs);
+                })));
+            }
+            catch (error) {
+                logger$7.error("Error during setting setCodecPreferences:", error);
+            }
+        });
     }
     _negotiatePeerConnection(clientId, session, constraints) {
         if (!session) {
@@ -3816,11 +3860,9 @@ class P2pRtcManager {
             return;
         }
         session.isOperationPending = true;
-        const { p2pVp9On, p2pAv1On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
-        if (p2pVp9On || p2pAv1On || redOn) {
-            this._setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn });
-        }
-        pc.createOffer(constraints || this.offerOptions)
+        const { p2pVp9On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
+        this._setCodecPreferences(pc).then(() => pc
+            .createOffer(constraints || this.offerOptions)
             .then((offer) => {
             if (rtpAbsCaptureTimeOn)
                 offer.sdp = addAbsCaptureTimeExtMap(offer.sdp);
@@ -3844,7 +3886,7 @@ class P2pRtcManager {
         })
             .catch((e) => {
             logger$7.warn("RTCPeerConnection.createOffer() failed to create local offer", e);
-        });
+        }));
     }
     _withForcedRenegotiation(session, action) {
         const pc = session.pc;
@@ -7948,4 +7990,4 @@ var RtcEventNames;
     RtcEventNames["stream_added"] = "stream_added";
 })(RtcEventNames || (RtcEventNames = {}));
 
-export { BandwidthTester, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, RtcStream, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecsByMimeType, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
+export { BandwidthTester, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, RtcStream, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };

package/dist/legacy-esm.js

@@ -2610,7 +2610,9 @@ function getPreferredOrder(availableCodecs, { vp9On, av1On }) {
     return availableCodecs;
 }
 function sortCodecsByMimeType(codecs, features) {
-    const availableCodecs = codecs.map(({ mimeType }) => mimeType).filter((value, index, array) => array.indexOf(value) === index);
+    const availableCodecs = codecs
+        .map(({ mimeType }) => mimeType)
+        .filter((value, index, array) => array.indexOf(value) === index);
     const preferredOrder = getPreferredOrder(availableCodecs, features);
     return codecs.sort((a, b) => {
         const indexA = preferredOrder.indexOf(a.mimeType.toLowerCase());
@@ -2620,6 +2622,41 @@ function sortCodecsByMimeType(codecs, features) {
         return orderA - orderB;
     });
 }
+function getIsCodecDecodingPowerEfficient(codec) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { powerEfficient } = yield navigator.mediaCapabilities.decodingInfo({
+            type: "webrtc",
+            video: {
+                width: 1280,
+                height: 720,
+                bitrate: 2580,
+                framerate: 24,
+                contentType: codec,
+            },
+        });
+        return powerEfficient;
+    });
+}
+function sortCodecsByPowerEfficiency(codecs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const codecPowerEfficiencyEntries = yield Promise.all(codecs.map(({ mimeType }) => getIsCodecDecodingPowerEfficient(mimeType).then((val) => [mimeType, val])));
+        const codecPowerEfficiencies = Object.fromEntries(codecPowerEfficiencyEntries);
+        const sorted = codecs.sort((a, b) => {
+            const aPowerEfficient = codecPowerEfficiencies[a.mimeType];
+            const bPowerEfficient = codecPowerEfficiencies[b.mimeType];
+            return aPowerEfficient === bPowerEfficient ? 0 : aPowerEfficient ? -1 : 1;
+        });
+        return sorted;
+    });
+}
+function sortCodecs(codecs, features) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (features.preferHardwareDecodingOn) {
+            codecs = yield sortCodecsByPowerEfficiency(codecs);
+        }
+        return sortCodecsByMimeType(codecs, features);
+    });
+}
 
 const logger$8 = new Logger();
 class ReconnectManager extends EventEmitter {
@@ -3762,46 +3799,53 @@ class P2pRtcManager {
             this._negotiatePeerConnection(clientId, session, Object.assign({}, this.offerOptions, { iceRestart: true }));
         }
     }
-    _setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn, }) {
-        try {
-            const audioTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
-            audioTransceivers.forEach((audioTransceiver) => {
-                if (typeof RTCRtpSender.getCapabilities === "undefined")
-                    return;
-                const capabilities = RTCRtpSender.getCapabilities("audio");
-                for (let i = 0; i < capabilities.codecs.length; i++) {
-                    if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
-                        capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
-                        break;
+    _setCodecPreferences(pc) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { p2pVp9On, p2pAv1On, redOn, preferHardwareDecodingOn } = this._features;
+            if (!(p2pVp9On || p2pAv1On || redOn || preferHardwareDecodingOn)) {
+                return;
+            }
+            try {
+                const audioTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "audio"; });
+                audioTransceivers.forEach((audioTransceiver) => {
+                    if (typeof RTCRtpSender.getCapabilities === "undefined")
+                        return;
+                    const capabilities = RTCRtpSender.getCapabilities("audio");
+                    for (let i = 0; i < capabilities.codecs.length; i++) {
+                        if (redOn && capabilities.codecs[i].mimeType.toLowerCase() === "audio/red") {
+                            capabilities.codecs.unshift(capabilities.codecs.splice(i, 1)[0]);
+                            break;
+                        }
                     }
-                }
-                if (typeof audioTransceiver.setCodecPreferences === "undefined")
-                    return;
-                audioTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-            const videoTransceivers = pc
-                .getTransceivers()
-                .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
-            videoTransceivers.forEach((videoTransceiver) => {
-                if (RTCRtpReceiver.getCapabilities === undefined)
-                    return;
-                const capabilities = RTCRtpReceiver.getCapabilities("video");
-                if (p2pVp9On || p2pAv1On) {
-                    capabilities.codecs = sortCodecsByMimeType(capabilities.codecs, {
-                        vp9On: p2pVp9On,
-                        av1On: p2pAv1On,
-                    });
-                }
-                if (videoTransceiver.setCodecPreferences === undefined)
-                    return;
-                videoTransceiver.setCodecPreferences(capabilities.codecs);
-            });
-        }
-        catch (error) {
-            logger$7.error("Error during setting setCodecPreferences:", error);
-        }
+                    if (typeof audioTransceiver.setCodecPreferences === "undefined")
+                        return;
+                    audioTransceiver.setCodecPreferences(capabilities.codecs);
+                });
+                const videoTransceivers = pc
+                    .getTransceivers()
+                    .filter((transceiver) => { var _a, _b; return ((_b = (_a = transceiver === null || transceiver === void 0 ? void 0 : transceiver.sender) === null || _a === void 0 ? void 0 : _a.track) === null || _b === void 0 ? void 0 : _b.kind) === "video"; });
+                yield Promise.all(videoTransceivers.map((videoTransceiver) => __awaiter(this, void 0, void 0, function* () {
+                    if (RTCRtpReceiver.getCapabilities === undefined)
+                        return;
+                    if (videoTransceiver.setCodecPreferences === undefined)
+                        return;
+                    const capabilities = RTCRtpReceiver.getCapabilities("video");
+                    if (p2pVp9On || p2pAv1On || preferHardwareDecodingOn) {
+                        capabilities.codecs = yield sortCodecs(capabilities.codecs, {
+                            vp9On: p2pVp9On,
+                            av1On: p2pAv1On,
+                            preferHardwareDecodingOn,
+                        });
+                    }
+                    videoTransceiver.setCodecPreferences(capabilities.codecs);
+                })));
+            }
+            catch (error) {
+                logger$7.error("Error during setting setCodecPreferences:", error);
+            }
+        });
     }
     _negotiatePeerConnection(clientId, session, constraints) {
         if (!session) {
@@ -3816,11 +3860,9 @@ class P2pRtcManager {
             return;
         }
         session.isOperationPending = true;
-        const { p2pVp9On, p2pAv1On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
-        if (p2pVp9On || p2pAv1On || redOn) {
-            this._setCodecPreferences(pc, { p2pVp9On, p2pAv1On, redOn });
-        }
-        pc.createOffer(constraints || this.offerOptions)
+        const { p2pVp9On, redOn, rtpAbsCaptureTimeOn, cleanSdpOn } = this._features;
+        this._setCodecPreferences(pc).then(() => pc
+            .createOffer(constraints || this.offerOptions)
             .then((offer) => {
             if (rtpAbsCaptureTimeOn)
                 offer.sdp = addAbsCaptureTimeExtMap(offer.sdp);
@@ -3844,7 +3886,7 @@ class P2pRtcManager {
         })
             .catch((e) => {
             logger$7.warn("RTCPeerConnection.createOffer() failed to create local offer", e);
-        });
+        }));
     }
     _withForcedRenegotiation(session, action) {
         const pc = session.pc;
@@ -7948,5 +7990,5 @@ var RtcEventNames;
     RtcEventNames["stream_added"] = "stream_added";
 })(RtcEventNames || (RtcEventNames = {}));
 
-export { BandwidthTester, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, RtcStream, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecsByMimeType, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
+export { BandwidthTester, EVENTS, KNOCK_MESSAGES, KalmanFilter, Logger, MAXIMUM_TURN_BANDWIDTH, MAXIMUM_TURN_BANDWIDTH_UNLIMITED, MEDIA_JITTER_BUFFER_TARGET, NoDevicesError, P2pRtcManager, PROTOCOL_ERRORS, PROTOCOL_EVENTS, PROTOCOL_REQUESTS, PROTOCOL_RESPONSES, RELAY_MESSAGES, ReconnectManager, RtcEventNames, RtcManagerDispatcher, RtcStream, STREAM_TYPES, ServerSocket, Session, SfuV2Parser, TYPES, VegaConnection, VegaMediaQualityMonitor, VegaRtcManager, addAbsCaptureTimeExtMap, addExtMap, assert, buildDeviceList, calculateStd, captureAudioSsrcMetrics, captureCandidatePairInfoMetrics, captureCommonSsrcMetrics, captureSsrcInfo, captureVideoSsrcMetrics, changeMediaDirection, cleanSdp, compareLocalDevices, createACFCalculator, createMicAnalyser, createWorker, deprioritizeH264, detectMicrophoneNotWorking, enumerate, external_stun_servers, filterMidExtension, filterMsidSemantic, fromLocation, generateByteString, getConstraints, getCurrentPeerConnections, getDeviceData, getDisplayMedia, getIssuesAndMetrics, getMediaConstraints, getMediaSettings, getMediasoupDevice, getNumFailedStatsReports, getNumFailedTrackSsrcLookups, getNumMissingTrackSsrcLookups, getOptimalBitrate, getPeerConnectionIndex, getStats, getStream, getUpdatedDevices, getUpdatedStats, getUserMedia, hasGetDisplayMedia, ipRegex, isMobile, isRelayed, maybeRejectNoH264, maybeTurnOnly, modifyMediaCapabilities, removePeerConnection, replaceSSRCs, replaceTracksInStream, rtcManagerEvents, rtcStats, setClientProvider, setCodecPreferenceSDP, setPeerConnectionsForTests, setVideoBandwidthUsingSetParameters, sortCodecs, standardDeviation, startPerformanceMonitor, stopStreamTracks, subscribeIssues, subscribeStats, turnServerOverride, variance };
 //# sourceMappingURL=legacy-esm.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@whereby.com/media",
     "description": "Media library for Whereby",
-    "version": "1.21.1",
+    "version": "1.22.0",
     "license": "MIT",
     "homepage": "https://github.com/whereby/sdk",
     "repository": {