@signalapp/ringrtc 2.24.0 → 2.25.0

package/dist/ringrtc/Service.d.ts

@@ -194,7 +194,7 @@ export declare class Call {
     get remoteVideoEnabled(): boolean;
     set remoteVideoEnabled(enabled: boolean);
     sendVideoFrame(width: number, height: number, format: VideoPixelFormatEnum, buffer: Buffer): void;
-    receiveVideoFrame(buffer: Buffer): [number, number] | undefined;
+    receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
     private enableOrDisableCapturer;
     private setOutgoingVideoEnabled;
     updateBandwidthMode(bandwidthMode: BandwidthMode): void;
@@ -340,7 +340,7 @@ declare class GroupCallVideoFrameSource {
     private readonly _groupCall;
     private readonly _remoteDemuxId;
     constructor(callManager: CallManager, groupCall: GroupCall, remoteDemuxId: number);
-    receiveVideoFrame(buffer: Buffer): [number, number] | undefined;
+    receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
 }
 declare type ProtobufBuffer = Buffer | {
     toArrayBuffer: () => ArrayBuffer;
@@ -400,9 +400,8 @@ export declare enum HangupType {
     NeedPermission = 4
 }
 export declare enum BandwidthMode {
-    VeryLow = 0,
-    Low = 1,
-    Normal = 2
+    Low = 0,
+    Normal = 1
 }
 export declare enum RingCancelReason {
     DeclinedByUser = 0,
@@ -424,7 +423,7 @@ export interface CallManager {
     setOutgoingVideoIsScreenShare(enabled: boolean): void;
     updateBandwidthMode(bandwidthMode: BandwidthMode): void;
     sendVideoFrame(width: number, height: number, format: VideoPixelFormatEnum, buffer: Buffer): void;
-    receiveVideoFrame(buffer: Buffer): [number, number] | undefined;
+    receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
     receivedOffer(remoteUserId: UserId, remoteDeviceId: DeviceId, messageAgeSec: number, callId: CallId, offerType: OfferType, localDeviceId: DeviceId, opaque: Buffer, senderIdentityKey: Buffer, receiverIdentityKey: Buffer): void;
     receivedAnswer(remoteUserId: UserId, remoteDeviceId: DeviceId, callId: CallId, opaque: Buffer, senderIdentityKey: Buffer, receiverIdentityKey: Buffer): void;
     receivedIceCandidates(remoteUserId: UserId, remoteDeviceId: DeviceId, callId: CallId, candidates: Array<Buffer>): void;
@@ -449,7 +448,7 @@ export interface CallManager {
     requestVideo(clientId: GroupCallClientId, resolutions: Array<VideoRequest>, activeSpeakerHeight: number): void;
     setGroupMembers(clientId: GroupCallClientId, members: Array<GroupMemberInfo>): void;
     setMembershipProof(clientId: GroupCallClientId, proof: Buffer): void;
-    receiveGroupCallVideoFrame(clientId: GroupCallClientId, remoteDemuxId: number, buffer: Buffer): [number, number] | undefined;
+    receiveGroupCallVideoFrame(clientId: GroupCallClientId, remoteDemuxId: number, buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
     peekGroupCall(requestId: number, sfu_url: string, membership_proof: Buffer, group_members: Array<GroupMemberInfo>): Promise<PeekInfo>;
     getAudioInputs(): AudioDevice[];
     setAudioInput(index: number): void;

package/dist/ringrtc/Service.js

@@ -60,10 +60,16 @@ class NativeCallManager {
         const fieldTrialsString = Object.entries(config.field_trials || {})
             .map(([k, v]) => `${k}/${v}`)
             .join('/') + '/';
-        const callEndpoint = Native.createCallEndpoint(this, config.use_new_audio_device_module, fieldTrialsString);
         Object.defineProperty(this, Native.callEndpointPropertyKey, {
-            value: callEndpoint,
-            configurable: true, // allows it to be changed
+            configurable: true,
+            get() {
+                const callEndpoint = Native.createCallEndpoint(this, config.use_new_audio_device_module, fieldTrialsString);
+                Object.defineProperty(this, Native.callEndpointPropertyKey, {
+                    configurable: true,
+                    value: callEndpoint,
+                });
+                return callEndpoint;
+            },
         });
     }
 }
@@ -1021,13 +1027,13 @@ class Call {
     }
     // With this method, a Call is a VideoFrameSender
     sendVideoFrame(width, height, format, buffer) {
-        // This assumes we only have one active all.
+        // This assumes we only have one active call.
         this._callManager.sendVideoFrame(width, height, format, buffer);
     }
     // With this method, a Call is a VideoFrameSource
-    receiveVideoFrame(buffer) {
-        // This assumes we only have one active all.
-        return this._callManager.receiveVideoFrame(buffer);
+    receiveVideoFrame(buffer, maxWidth, maxHeight) {
+        // This assumes we only have one active call.
+        return this._callManager.receiveVideoFrame(buffer, maxWidth, maxHeight);
     }
     enableOrDisableCapturer() {
         if (!this._videoCapturer) {
@@ -1371,7 +1377,7 @@ class GroupCall {
     }
     // With this, a GroupCall is a VideoFrameSender
     sendVideoFrame(width, height, format, buffer) {
-        // This assumes we only have one active all.
+        // This assumes we only have one active call.
         this._callManager.sendVideoFrame(width, height, format, buffer);
     }
     // With this, a GroupCall can provide a VideoFrameSource for each remote device.
@@ -1397,9 +1403,9 @@ class GroupCallVideoFrameSource {
         this._groupCall = groupCall;
         this._remoteDemuxId = remoteDemuxId;
     }
-    receiveVideoFrame(buffer) {
-        // This assumes we only have one active all.
-        const frame = this._callManager.receiveGroupCallVideoFrame(this._groupCall.clientId, this._remoteDemuxId, buffer);
+    receiveVideoFrame(buffer, maxWidth, maxHeight) {
+        // This assumes we only have one active call.
+        const frame = this._callManager.receiveGroupCallVideoFrame(this._groupCall.clientId, this._remoteDemuxId, buffer, maxWidth, maxHeight);
         if (!!frame) {
             const [width, height] = frame;
             this._groupCall.setRemoteAspectRatio(this._remoteDemuxId, width / height);
@@ -1452,9 +1458,8 @@ var HangupType;
 })(HangupType = exports.HangupType || (exports.HangupType = {}));
 var BandwidthMode;
 (function (BandwidthMode) {
-    BandwidthMode[BandwidthMode["VeryLow"] = 0] = "VeryLow";
-    BandwidthMode[BandwidthMode["Low"] = 1] = "Low";
-    BandwidthMode[BandwidthMode["Normal"] = 2] = "Normal";
+    BandwidthMode[BandwidthMode["Low"] = 0] = "Low";
+    BandwidthMode[BandwidthMode["Normal"] = 1] = "Normal";
 })(BandwidthMode = exports.BandwidthMode || (exports.BandwidthMode = {}));
 /// Describes why a ring was cancelled.
 var RingCancelReason;

package/dist/ringrtc/VideoSupport.d.ts

@@ -8,7 +8,17 @@ export declare enum VideoPixelFormatEnum {
     Rgba = 2
 }
 export interface VideoFrameSource {
-    receiveVideoFrame(buffer: Buffer): [number, number] | undefined;
+    /**
+     * Copies the latest frame into `buffer`.
+     *
+     * Note that `maxWidth` and `maxHeight` specify maximum dimensions,
+     * but allow for rotation, i.e. a maximum of 1920x1080 will also allow
+     * portrait-mode 1080x1920.
+     *
+     * Returns a `[width, height]` pair for the resulting frame,
+     * or `undefined` if there's no new frame ready to be displayed.
+     */
+    receiveVideoFrame(buffer: Buffer, maxWidth: number, maxHeight: number): [number, number] | undefined;
 }
 interface VideoFrameSender {
     sendVideoFrame(width: number, height: number, format: VideoPixelFormatEnum, buffer: Buffer): void;

package/dist/ringrtc/VideoSupport.js

@@ -376,7 +376,7 @@ class CanvasVideoRenderer {
         if (!context) {
             return;
         }
-        const frame = this.source.receiveVideoFrame(this.buffer);
+        const frame = this.source.receiveVideoFrame(this.buffer, exports.MAX_VIDEO_CAPTURE_WIDTH, exports.MAX_VIDEO_CAPTURE_HEIGHT);
         if (!frame) {
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/ringrtc",
-  "version": "2.24.0",
+  "version": "2.25.0",
   "description": "Signal Messenger voice and video calling library.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
   },
   "config": {
     "prebuildUrl": "https://build-artifacts.signal.org/libraries/ringrtc-desktop-build-v${npm_package_version}.tar.gz",
-    "prebuildChecksum": "7f7f7a795d4387d59e5262c6a3b8efb910f2d3f9c60a18316e49bb9a29d65343"
+    "prebuildChecksum": "99767cde606a663ef881deaa1d3dec8976e2c52981d808c5c95397e773810f22"
   },
   "author": "",
   "license": "AGPL-3.0-only",