Merge branch 'main' into chore/sync_1.2.0

# Conflicts:
#	CHANGELOG.md
#	common/darwin/Classes/FlutterWebRTCPlugin.m
#	ios/stream_webrtc_flutter.podspec
#	lib/src/native/factory_impl.dart
#	macos/stream_webrtc_flutter.podspec
#	pubspec.yaml

Author: Brazol

CHANGELOG.md

@@ -20,6 +20,10 @@
 	* [Apple/Android] Local recording API for Darwin and Android (#1880)
 	* [Apple/Android] Data Packet Cryptor Support.
 
+[1.0.13] - 2025-10-28
+* Exposed `eventStream` in `MediaDevices`.
+* [Android] Sends event when screen capture ends.
+
 [1.0.12] - 2025-09-30
 * [Android] Changed the configuration used when creating EGL rendering context to one that supports alpha channel to fix an issue with Impeller blending background with video texture on some devices.
 * [Android] Migrate from onSurfaceDestroyed to onSurfaceCleanup for SurfaceProducer.Callback.

android/src/main/java/io/getstream/webrtc/flutter/GetUserMediaImpl.java

@@ -96,6 +96,7 @@ public class GetUserMediaImpl {
     private static final int DEFAULT_HEIGHT = 720;
     private static final int DEFAULT_FPS = 30;
 
+    private static final String EVENT_DISPLAY_MEDIA_STOPPED = "screenSharingStopped";
     private static final String PERMISSION_AUDIO = Manifest.permission.RECORD_AUDIO;
     private static final String PERMISSION_VIDEO = Manifest.permission.CAMERA;
     private static final String PERMISSION_SCREEN = "android.permission.MediaProjection";
@@ -518,19 +519,24 @@ private void getDisplayMedia(final Result result, final MediaStream mediaStream,
         /* Create ScreenCapture */
         VideoTrack displayTrack = null;
         VideoCapturer videoCapturer = null;
-        videoCapturer =
-                new OrientationAwareScreenCapturer(
-                        applicationContext,
-                        mediaProjectionData,
-                        new MediaProjection.Callback() {
-                            @Override
-                            public void onStop() {
-                                super.onStop();
-                                // After Huawei P30 and Android 10 version test, the onstop method is called, which will not affect the next process,
-                                // and there is no need to call the resulterror method
-                                //resultError("MediaProjection.Callback()", "User revoked permission to capture the screen.", result);
-                            }
-                        });
+        String trackId = stateProvider.getNextTrackUUID();
+
+        videoCapturer = new OrientationAwareScreenCapturer(
+                applicationContext,
+                mediaProjectionData,
+                new MediaProjection.Callback() {
+                    @Override
+                    public void onStop() {
+                        super.onStop();
+
+                        ConstraintsMap params = new ConstraintsMap();
+                        params.putString("event", EVENT_DISPLAY_MEDIA_STOPPED);
+                        params.putString("trackId", trackId);
+                        FlutterWebRTCPlugin.sharedSingleton.sendEvent(params.toMap());
+                    }
+                }
+            );
+
         if (videoCapturer == null) {
             resultError("screenRequestPermissions", "GetDisplayMediaFailed, User revoked permission to capture the screen.", result);
             return;
@@ -562,7 +568,6 @@ public void onStop() {
         videoCapturer.startCapture(info.width, info.height, info.fps);
         Log.d(TAG, "OrientationAwareScreenCapturer.startCapture: " + info.width + "x" + info.height + "@" + info.fps);
 
-        String trackId = stateProvider.getNextTrackUUID();
         mVideoCapturers.put(trackId, info);
         mVideoSources.put(trackId, videoSource);
 

common/darwin/Classes/FlutterWebRTCPlugin.h

@@ -105,6 +105,8 @@ typedef void (^CapturerStopHandler)(CompletionHandler _Nonnull handler);
 - (RTCRtpSender* _Nullable)getRtpSenderById:(RTCPeerConnection* _Nonnull)peerConnection
                                          Id:(NSString* _Nonnull)Id;
 
+- (void)postEventWithName:(NSString* _Nonnull)eventName data:(NSDictionary* _Nullable)data;
+
 + (FlutterWebRTCPlugin* _Nullable)sharedSingleton;
 
 @end

common/darwin/Classes/FlutterWebRTCPlugin.m

@@ -2618,6 +2618,21 @@ - (FlutterRTCVideoRenderer*)findRendererByTrackId:(NSString*)trackId {
   return nil;
 }
 
+#pragma mark - Event Posting Helper
+
+- (void)postEventWithName:(NSString*)eventName data:(NSDictionary*)data {
+  if (!self.eventSink) {
+    return;
+  }
+
+  NSMutableDictionary* eventData = [NSMutableDictionary dictionaryWithObject:eventName forKey:@"event"];
+  if (data) {
+    [eventData addEntriesFromDictionary:data];
+  }
+
+  postEvent(self.eventSink, eventData);
+}
+
 #pragma mark - RTCAudioDeviceModuleDelegate methods
 
 - (void)audioDeviceModuleDidUpdateDevices:(RTCAudioDeviceModule*)audioDeviceModule {

lib/src/native/factory_impl.dart

@@ -189,5 +189,8 @@ MediaDevices get mediaDevices => MediaDeviceNative.instance;
 
 FrameCryptorFactory get frameCryptorFactory => FrameCryptorFactoryImpl.instance;
 
+Stream<Map<String, dynamic>> get eventStream =>
+    MediaDeviceNative.instance.eventStream;
+
 DataPacketCryptorFactory get dataPacketCryptorFactory =>
     DataPacketCryptorFactoryImpl.instance;

lib/src/native/mediadevices_impl.dart

@@ -19,6 +19,9 @@ class MediaDeviceNative extends MediaDevices {
 
   static final MediaDeviceNative instance = MediaDeviceNative._internal();
 
+  Stream<Map<String, dynamic>> get eventStream =>
+      FlutterWebRTCEventChannel.instance.handleEvents.stream;
+
   void handleEvent(String event, final Map<dynamic, dynamic> map) async {
     switch (map['event']) {
       case 'onDeviceChange':

lib/src/web/factory_impl.dart

@@ -22,3 +22,5 @@ Future<void> handleCallInterruptionCallbacks(
   throw UnimplementedError(
       'handleCallInterruptionCallbacks() is not supported on web');
 }
+
+Stream<Map<String, dynamic>> get eventStream => Stream.empty();