[camera_web] Support for camera stream on web

packages/camera/camera_web/CHANGELOG.md

@@ -1,113 +1,114 @@
-## NEXT
+## 0.3.6
 
-* Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
+- Supporting camera image stream on web.
+- Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
 
 ## 0.3.5
 
-* Migrates to package:web to support WASM
-* Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.
+- Migrates to package:web to support WASM
+- Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.
 
 ## 0.3.4
 
-* Removes `maxVideoDuration`/`maxDuration`, as the feature was never exposed at
+- Removes `maxVideoDuration`/`maxDuration`, as the feature was never exposed at
   the app-facing package level, and is deprecated at the platform interface
   level.
-* Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
+- Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
 
 ## 0.3.3
 
-* Adds support to control video FPS and bitrate. See `CameraController.withSettings`.
-* Updates minimum supported SDK version to Flutter 3.13/Dart 3.1.
+- Adds support to control video FPS and bitrate. See `CameraController.withSettings`.
+- Updates minimum supported SDK version to Flutter 3.13/Dart 3.1.
 
 ## 0.3.2+4
 
-* Updates minimum supported SDK version to Flutter 3.10/Dart 3.0.
-* Fixes new lint warnings.
+- Updates minimum supported SDK version to Flutter 3.10/Dart 3.0.
+- Fixes new lint warnings.
 
 ## 0.3.2+3
 
-* Migrates to `dart:ui_web` APIs.
-* Updates minimum supported SDK version to Flutter 3.13.0/Dart 3.1.0.
+- Migrates to `dart:ui_web` APIs.
+- Updates minimum supported SDK version to Flutter 3.13.0/Dart 3.1.0.
 
 ## 0.3.2+2
 
-* Adds pub topics to package metadata.
-* Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.
+- Adds pub topics to package metadata.
+- Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.
 
 ## 0.3.2+1
 
-* Updates README to improve example of `Image` creation.
+- Updates README to improve example of `Image` creation.
 
 ## 0.3.2
 
-* Changes `availableCameras` to not ask for the microphone permission.
+- Changes `availableCameras` to not ask for the microphone permission.
 
 ## 0.3.1+4
 
-* Removes obsolete null checks on non-nullable values.
-* Updates minimum supported SDK version to Flutter 3.3/Dart 2.18.
+- Removes obsolete null checks on non-nullable values.
+- Updates minimum supported SDK version to Flutter 3.3/Dart 2.18.
 
 ## 0.3.1+3
 
-* Clarifies explanation of endorsement in README.
-* Aligns Dart and Flutter SDK constraints.
+- Clarifies explanation of endorsement in README.
+- Aligns Dart and Flutter SDK constraints.
 
 ## 0.3.1+2
 
-* Updates links for the merge of flutter/plugins into flutter/packages.
-* Updates minimum Flutter version to 3.0.
+- Updates links for the merge of flutter/plugins into flutter/packages.
+- Updates minimum Flutter version to 3.0.
 
 ## 0.3.1+1
 
-* Updates code for stricter lint checks.
+- Updates code for stricter lint checks.
 
 ## 0.3.1
 
-* Updates to latest camera platform interface, and fails if user attempts to use streaming with recording (since streaming is currently unsupported on web).
+- Updates to latest camera platform interface, and fails if user attempts to use streaming with recording (since streaming is currently unsupported on web).
 
 ## 0.3.0+1
 
-* Updates imports for `prefer_relative_imports`.
-* Updates minimum Flutter version to 2.10.
-* Fixes avoid_redundant_argument_values lint warnings and minor typos.
-* Ignores unnecessary import warnings in preparation for [upcoming Flutter changes](https://github.com/flutter/flutter/pull/106316).
+- Updates imports for `prefer_relative_imports`.
+- Updates minimum Flutter version to 2.10.
+- Fixes avoid_redundant_argument_values lint warnings and minor typos.
+- Ignores unnecessary import warnings in preparation for [upcoming Flutter changes](https://github.com/flutter/flutter/pull/106316).
 
 ## 0.3.0
 
-* **BREAKING CHANGE**: Renames error code `cameraPermission` to `CameraAccessDenied` to be consistent with other platforms.
+- **BREAKING CHANGE**: Renames error code `cameraPermission` to `CameraAccessDenied` to be consistent with other platforms.
 
 ## 0.2.1+6
 
-* Minor fixes for new analysis options.
+- Minor fixes for new analysis options.
 
 ## 0.2.1+5
 
-* Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors
+- Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors
   lint warnings.
 
 ## 0.2.1+4
 
-* Migrates from `ui.hash*` to `Object.hash*`.
-* Updates minimum Flutter version for changes in 0.2.1+3.
+- Migrates from `ui.hash*` to `Object.hash*`.
+- Updates minimum Flutter version for changes in 0.2.1+3.
 
 ## 0.2.1+3
 
-* Internal code cleanup for stricter analysis options.
+- Internal code cleanup for stricter analysis options.
 
 ## 0.2.1+2
 
-* Fixes cameraNotReadable error that prevented access to the camera on some Android devices when initializing a camera.
-* Implemented support for new Dart SDKs with an async requestFullscreen API.
+- Fixes cameraNotReadable error that prevented access to the camera on some Android devices when initializing a camera.
+- Implemented support for new Dart SDKs with an async requestFullscreen API.
 
 ## 0.2.1+1
 
-* Update usage documentation.
+- Update usage documentation.
 
 ## 0.2.1
 
-* Add video recording functionality.
-* Fix cameraNotReadable error that prevented access to the camera on some Android devices.
+- Add video recording functionality.
+- Fix cameraNotReadable error that prevented access to the camera on some Android devices.
 
 ## 0.2.0
 
-* Initial release, adapted from the Flutter [I/O Photobooth](https://photobooth.flutter.dev/) project.
+- Initial release, adapted from the Flutter [I/O Photobooth](https://photobooth.flutter.dev/) project.

packages/camera/camera_web/example/integration_test/camera_bitrate_test.dart

@@ -106,6 +106,10 @@ void main() {
       ).thenAnswer(
           (_) => Future<MediaStream>.value(canvasElement.captureStream()));
 
+      when(
+        () => cameraService.hasPropertyOffScreenCanvas(),
+      ).thenAnswer((_) => true);
+
       final Camera camera = Camera(
           textureId: cameraId,
           cameraService: cameraService,

packages/camera/camera_web/example/integration_test/camera_service_test.dart

@@ -4,6 +4,7 @@
 
 // ignore_for_file: only_throw_errors
 
+import 'dart:async';
 import 'dart:js_interop';
 import 'dart:js_interop_unsafe';
 
@@ -903,5 +904,69 @@ void main() {
         );
       });
     });
+
+    group('camera image stream', () {
+      setUp(
+        () {
+          cameraService.jsUtil = jsUtil;
+        },
+      );
+      testWidgets(
+        'returns true if broswer has OffscreenCanvas '
+        'otherwise false',
+        (WidgetTester widgetTester) async {
+          when(
+            () => jsUtil.hasProperty(
+              window,
+              'OffscreenCanvas'.toJS,
+            ),
+          ).thenReturn(true);
+          final bool hasOffScreenCanvas =
+              cameraService.hasPropertyOffScreenCanvas();
+          expect(
+            hasOffScreenCanvas,
+            true,
+          );
+          when(
+            () => jsUtil.hasProperty(
+              window,
+              'OffscreenCanvas'.toJS,
+            ),
+          ).thenReturn(false);
+          final bool hasNotOffScreenCanvas =
+              cameraService.hasPropertyOffScreenCanvas();
+          expect(
+            hasNotOffScreenCanvas,
+            false,
+          );
+        },
+      );
+      testWidgets(
+        'returns Camera Image of Size '
+        'when videoElement is of Size',
+        (WidgetTester widgetTester) async {
+          const Size size = Size(10, 10);
+          final Completer<void> completer = Completer<void>();
+          final web.VideoElement videoElement =
+              getVideoElementWithBlankStream(size)
+                ..onLoadedMetadata.listen((_) {
+                  completer.complete();
+                })
+                ..load();
+          await completer.future;
+          final CameraImageData cameraImageData = cameraService.takeFrame(
+            videoElement,
+            canUseOffscreenCanvas: true,
+          );
+          expect(
+            size,
+            Size(
+              cameraImageData.width.toDouble(),
+              cameraImageData.height.toDouble(),
+            ),
+          );
+        },
+      );
+    });
   });
 }

packages/camera/camera_web/example/integration_test/camera_test.dart

@@ -5,6 +5,7 @@
 import 'dart:async';
 import 'dart:js_interop';
 import 'dart:js_interop_unsafe';
+import 'dart:typed_data';
 import 'dart:ui';
 
 import 'package:async/async.dart';
@@ -61,6 +62,10 @@ void main() {
           cameraId: any(named: 'cameraId'),
         ),
       ).thenAnswer((_) => Future<MediaStream>.value(mediaStream));
+
+      when(
+        () => cameraService.hasPropertyOffScreenCanvas(),
+      ).thenAnswer((_) => true);
     });
 
     setUpAll(() {
@@ -1704,5 +1709,56 @@ void main() {
         });
       });
     });
+    group('cameraFrameStream', () {
+      testWidgets(
+        'bytes is a multiple of 4',
+        (WidgetTester tester) async {
+          final VideoElement videoElement = getVideoElementWithBlankStream(
+            const Size(10, 10),
+          );
+
+          final Camera camera = Camera(
+            textureId: textureId,
+            cameraService: cameraService,
+          )..videoElement = videoElement;
+
+          when(
+            () => cameraService.takeFrame(
+              videoElement,
+              canUseOffscreenCanvas: camera.canUseOffscreenCanvas,
+            ),
+          ).thenAnswer(
+            (_) => CameraImageData(
+              format: const CameraImageFormat(
+                ImageFormatGroup.jpeg,
+                raw: '',
+              ),
+              planes: <CameraImagePlane>[
+                CameraImagePlane(
+                  bytes: Uint8List(32),
+                  bytesPerRow: 0,
+                ),
+              ],
+              height: 10,
+              width: 10,
+            ),
+          );
+
+          final CameraImageData cameraImageData =
+              await camera.cameraFrameStream().first;
+          expect(
+            cameraImageData,
+            equals(
+              isA<CameraImageData>().having(
+                (CameraImageData e) => e.planes.first.bytes.length % 4,
+                'bytes',
+                equals(0),
+              ),
+            ),
+          );
+        },
+        timeout: const Timeout(Duration(seconds: 2)),
+      );
+    });
   });
 }

packages/camera/camera_web/example/integration_test/camera_web_test.dart

@@ -100,6 +100,10 @@ void main() {
         (_) async => videoElement.captureStream(),
       );
 
+      when(
+        () => cameraService.hasPropertyOffScreenCanvas(),
+      ).thenAnswer((_) => true);
+
       CameraPlatform.instance = CameraPlugin(
         cameraService: cameraService,
       )..window = window;