support target resolution setting (#789)

Author: Brazol

packages/stream_video/lib/src/call/call.dart

@@ -1312,6 +1312,8 @@ class Call {
           ? FacingMode.user
           : FacingMode.environment,
       speakerDefaultOn: settings.audio.speakerDefaultOn,
+      targetResolution: settings.video.targetResolution,
+      screenShareTargetResolution: settings.screenShare.targetResolution,
     );
   }
 
@@ -1320,9 +1322,13 @@ class Call {
     await _applyCameraOption(
       _connectOptions.camera,
       _connectOptions.cameraFacingMode,
+      _connectOptions.targetResolution,
     );
     await _applyMicrophoneOption(_connectOptions.microphone);
-    await _applyScreenShareOption(_connectOptions.screenShare);
+    await _applyScreenShareOption(
+      _connectOptions.screenShare,
+      _connectOptions.screenShareTargetResolution,
+    );
 
     if (_connectOptions.audioInputDevice != null) {
       await setAudioInputDevice(_connectOptions.audioInputDevice!);
@@ -1344,6 +1350,7 @@ class Call {
   Future<void> _applyCameraOption(
     TrackOption cameraOption,
     FacingMode facingMode,
+    StreamTargetResolution? targetResolution,
   ) async {
     if (cameraOption is TrackProvided) {
       await _setLocalTrack(cameraOption.track);
@@ -1352,6 +1359,8 @@ class Call {
         enabled: true,
         constraints: CameraConstraints(
           facingMode: facingMode,
+          params: targetResolution?.toVideoParams() ??
+              RtcVideoParametersPresets.h720_16x9,
         ),
       );
     }
@@ -1365,11 +1374,22 @@ class Call {
     }
   }
 
-  Future<void> _applyScreenShareOption(TrackOption screenShareOption) async {
+  Future<void> _applyScreenShareOption(
+    TrackOption screenShareOption,
+    StreamTargetResolution? targetResolution,
+  ) async {
     if (screenShareOption is TrackProvided) {
       await _setLocalTrack(screenShareOption.track);
     } else if (screenShareOption is TrackEnabled) {
-      await setScreenShareEnabled(enabled: true);
+      await setScreenShareEnabled(
+        enabled: true,
+        constraints: ScreenShareConstraints(
+          params: targetResolution?.toVideoParams(
+                defaultBitrate: RtcVideoParametersPresets.k1080pBitrate,
+              ) ??
+              RtcVideoParametersPresets.h1080_16x9,
+        ),
+      );
     }
   }
 
@@ -1842,9 +1862,17 @@ class Call {
       return Result.error('Missing permission to share screen for the user');
     }
 
+    final updatedConstraints =
+        (constraints ?? const ScreenShareConstraints()).copyWith(
+      params: constraints?.params ??
+          _connectOptions.screenShareTargetResolution?.toVideoParams(
+            defaultBitrate: RtcVideoParametersPresets.k1080pBitrate,
+          ),
+    );
+
     final result = await _session?.setScreenShareEnabled(
           enabled,
-          constraints: constraints,
+          constraints: updatedConstraints,
         ) ??
         Result.error('Call session is null, cannot start screen share');
 

packages/stream_video/lib/src/call/call_connect_options.dart

@@ -11,6 +11,8 @@ class CallConnectOptions with EquatableMixin {
     this.audioInputDevice,
     this.speakerDefaultOn = false,
     this.cameraFacingMode = FacingMode.user,
+    this.targetResolution,
+    this.screenShareTargetResolution,
   });
 
   final TrackOption camera;
@@ -22,6 +24,8 @@ class CallConnectOptions with EquatableMixin {
   final bool speakerDefaultOn;
 
   final FacingMode cameraFacingMode;
+  final StreamTargetResolution? targetResolution;
+  final StreamTargetResolution? screenShareTargetResolution;
 
   CallConnectOptions copyWith({
     TrackOption? camera,
@@ -31,6 +35,8 @@ class CallConnectOptions with EquatableMixin {
     RtcMediaDevice? audioInputDevice,
     FacingMode? cameraFacingMode,
     bool? speakerDefaultOn,
+    StreamTargetResolution? targetResolution,
+    StreamTargetResolution? screenShareTargetResolution,
   }) {
     return CallConnectOptions(
       camera: camera ?? this.camera,
@@ -40,6 +46,9 @@ class CallConnectOptions with EquatableMixin {
       audioInputDevice: audioInputDevice ?? this.audioInputDevice,
       cameraFacingMode: cameraFacingMode ?? this.cameraFacingMode,
       speakerDefaultOn: speakerDefaultOn ?? this.speakerDefaultOn,
+      targetResolution: targetResolution ?? this.targetResolution,
+      screenShareTargetResolution:
+          screenShareTargetResolution ?? this.screenShareTargetResolution,
     );
   }
 
@@ -52,6 +61,8 @@ class CallConnectOptions with EquatableMixin {
       audioInputDevice: other.audioInputDevice,
       cameraFacingMode: other.cameraFacingMode,
       speakerDefaultOn: other.speakerDefaultOn,
+      targetResolution: other.targetResolution,
+      screenShareTargetResolution: other.screenShareTargetResolution,
     );
   }
 
@@ -64,6 +75,8 @@ class CallConnectOptions with EquatableMixin {
         audioInputDevice,
         cameraFacingMode,
         speakerDefaultOn,
+        targetResolution,
+        screenShareTargetResolution,
       ];
 
   @override
@@ -76,6 +89,8 @@ class CallConnectOptions with EquatableMixin {
         ' audioInput: $audioInputDevice, '
         ' cameraFacingMode: $cameraFacingMode, '
         ' speakerDefaultOn: $speakerDefaultOn'
+        ' targetResolution: $targetResolution'
+        ' screenShareTargetResolution: $screenShareTargetResolution'
         '}';
   }
 }

packages/stream_video/lib/src/models/call_settings.dart

@@ -1,6 +1,9 @@
 import 'package:equatable/equatable.dart';
 
 import '../../open_api/video/coordinator/api.dart';
+import '../webrtc/model/rtc_video_dimension.dart';
+import '../webrtc/model/rtc_video_encoding.dart';
+import '../webrtc/model/rtc_video_parameters.dart';
 
 class CallSettings with EquatableMixin {
   const CallSettings({
@@ -123,8 +126,10 @@ class StreamVideoSettings extends MediaSettings {
     this.enabled = false,
     this.cameraDefaultOn = true,
     this.cameraFacing = VideoSettingsRequestCameraFacingEnum.front,
-    this.targetResolution =
-        const StreamTargetResolution(height: 1280, width: 720),
+    this.targetResolution = const StreamTargetResolution(
+      height: 720,
+      width: 1280,
+    ),
   });
 
   final bool enabled;
@@ -357,6 +362,44 @@ class StreamHlsSettings extends AbstractSettings {
   List<Object?> get props => [enabled, autoOn, qualityTracks];
 }
 
+class StreamTargetResolution extends AbstractSettings {
+  const StreamTargetResolution({
+    required this.height,
+    required this.width,
+    this.bitrate,
+  });
+
+  final int height;
+  final int width;
+  final int? bitrate;
+
+  @override
+  List<Object?> get props => [height, width, bitrate];
+
+  TargetResolution toOpenDto() {
+    return TargetResolution(
+      height: height,
+      width: width,
+      bitrate: bitrate,
+    );
+  }
+
+  RtcVideoParameters toVideoParams({
+    int defaultBitrate = RtcVideoParametersPresets.k720pBitrate,
+  }) {
+    return RtcVideoParameters(
+      dimension: RtcVideoDimension(
+        width: width,
+        height: height,
+      ),
+      encoding: RtcVideoEncoding(
+        maxFramerate: 30,
+        maxBitrate: bitrate ?? defaultBitrate,
+      ),
+    );
+  }
+}
+
 class StreamRtmpSettings extends AbstractSettings {
   const StreamRtmpSettings({
     required this.quality,
@@ -485,26 +528,3 @@ enum NoiceCancellationSettingsMode {
     }
   }
 }
-
-class StreamTargetResolution extends AbstractSettings {
-  const StreamTargetResolution({
-    required this.height,
-    required this.width,
-    this.bitrate,
-  });
-
-  final int height;
-  final int width;
-  final int? bitrate;
-
-  @override
-  List<Object?> get props => [height, width, bitrate];
-
-  TargetResolution toOpenDto() {
-    return TargetResolution(
-      height: height,
-      width: width,
-      bitrate: bitrate,
-    );
-  }
-}