[camera] Add camera plugin (#97)

* [camera] Initial commits for camera plugin (#46)

* [camera] Initial commit for camera

* [camera] Copy an example from original

* [camera] Add tizen host for exmple

* [camera] Establish camera channel and cameraEvents channel

* Add basics to handle method call of camera channel
* Add CameraDevice class to represent Camera

* [camera] Fix build error

* [camera] Implement permission_manager (#51)

* Request camera permission when initializing
* Add some macros for convenience
* Add camera privilege to tizen-manifest.xml

* [camera] Migrate to Dart 2.12 and Flutter 2.0 (#55)

* [camera] Implement basic behavior of MediaPacketPreviewCb

* The preview currently has a fixed orientation,
 We have been working on how to properly rotate it.

* [camera] Migrate to Dart 2.12 and Flutter 2.0

* Revise method handler according to last original camera plugin
* Update example

* [camera] Add orientation_event_listener (#56)

* Add device_method_channel

* [camera] Send converted orientation event (#59)

* Convert the orientation event according to the lens orientation
* Rename orientation_event_listener to manager
* Use the prefix 'k' in enumerator names according to the Google Coding Guide

* [camera] Implement takePicture (#64)

* Flip an Image when using the front camera
* Use device orientation
* Mimic Android capture file path

* [camera] Implement setFocusMode

* Return result as a boolean type in camera device API wrapper function
* Use the capture file format explicitly as JPEG

* [camera] Implement setExposureMode (#70)

* Clean-up codes
* Fix a crash when Disposing camera
* ExposureMode.locked is not supported on TM1

* [camera] Implement setFocusPoint (#71)

* Fix build warning
* Update minor things

* [camera] Send focusPointSupported as a true (#73)

* Even if I send this to false when opening camera,
  the focus point request arrived to method handler normally

* [camera] Implement setFlashMode (#74)

* Replace if-statement about enumerable with switch
* Fix wrong log message

* [camera] Implement setZoomLevel (#75)

* Implement get{Max|min}ZoomLevel

* [camera] Request a recorder permission (#77)

* [camera] Use 'Camera' as a wrapper function name prefix

* [camera] Request permissions as async callchain

* Request a recorder permission when initialize too

* [camera] Implement video recording (#79)

* Implement {start|stop|pause|resume}Recording
* Cleanup code

* [camera] Implement lockCaptureOrientation (#81)

* [camera] Improve zoom behavior (#82)

* Update project files to latest

* [camera] Update README (#84)

* [camera] Use enable_audio argument (#88)

* If enable_audio is false, disable audio track when recording video

* [camera] Implement {GetMin|GetMax|Set}Exposure (#92)

* [camera] Implement {GetMin|GetMax|Set}Exposure

* [camera] Introduce CameraDeviceError

* Now, The public API on the CameraDevice throws an error
  or takes a flutter::MethodResult as an argument to send result

* [camera] Update minor things

* [camera] Fix a bug related to zoom

* Ignore a case where min and max zoom level are the same

* [camera] Use LOG_WARN instead of LOG_ERROR

* [camera] Migrate example app host to latest

* [camera] Update CHANGELOG

* Cleaup tidy
* Set the version to 0.1.0

* [camera] Sort dependencies in pubspec.yaml

* [camera] Implement ResolutionPreset

* The resolution values came from resolution_preset.dart
  This may not be supported by your device.

* [camera] Add LICENSE

* [camera] Modify camera_test.dart to run on TM1

* This is temporary modifications, please review this again
  if an official device with camera is released later

* [camera] Update GetValueFromEncodableMap tamplate

Signed-off-by: Boram Bae <[email protected]>

Author: bbrto21

packages/camera/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+.dart_tool/
+
+.packages
+.pub/
+
+build/

packages/camera/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.0
+
+* Initial release.

packages/camera/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2021 Samsung Electronics Co., Ltd. All rights reserved.
+Copyright (c) 2013 The Flutter Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the names of the copyright holders nor the names of the
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/camera/README.md

@@ -0,0 +1,53 @@
+# camera_tizen
+
+The Tizen implementation of [`camera`](https://github.com/flutter/plugins/tree/master/packages/camera).
+
+## Supported devices
+
+This plugin is an experimental plug-in for the future
+
+- Nothing
+
+## Required privileges
+
+To use this plugin, add below lines under the `<manifest>` section in your `tizen-manifest.xml` file,
+
+```xml
+<privileges>
+    <privilege>http://tizen.org/privilege/camera</privilege>
+    <privilege>http://tizen.org/privilege/recorder</privilege>
+</privileges>
+```
+
+## Usage
+
+This package is not an _endorsed_ implementation of `camera`. Therefore, you have to include `camera_tizen` alongside `camera` as dependencies in your `pubspec.yaml` file.
+
+```yaml
+dependencies:
+  camera: ^0.8.1
+  camera_tizen: ^0.1.0
+```
+
+Then you can import `camera` in your Dart code:
+
+```dart
+import 'package:camera/camera.dart';
+```
+For detailed usage, see https://github.com/flutter/plugins/tree/master/packages/camera/camera#example.
+
+## Notes
+CameraPreview currently does not support other platforms except Android and iOS. Therefor the camera preview to orient properly, you have to modify the `camera_preview.dart`.
+
+```dart
+  Widget _wrapInRotatedBox({required Widget child}) {
+    // if (defaultTargetPlatform != TargetPlatform.android) {
+    //   return child;
+    // }
+
+    return RotatedBox(
+      quarterTurns: _getQuarterTurns(),
+      child: child,
+    );
+  }
+```

packages/camera/example/.gitignore

@@ -0,0 +1,46 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+/build/
+
+# Web related
+lib/generated_plugin_registrant.dart
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

packages/camera/example/README.md

@@ -0,0 +1,7 @@
+# camera_tizen_example
+
+Demonstrates how to use the camera_tizen plugin.
+
+## Getting Started
+
+To run this app on your Tizen device, use [flutter-tizen](https://github.com/flutter-tizen/flutter-tizen).

packages/camera/example/integration_test/camera_test.dart

@@ -0,0 +1,244 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// TODO(mvanbeusekom): Remove this once flutter_driver supports null safety.
+// https://github.com/flutter/flutter/issues/71379
+// @dart = 2.9
+import 'dart:async';
+import 'dart:io';
+import 'dart:ui';
+
+import 'package:camera/camera.dart';
+import 'package:flutter/painting.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:path_provider/path_provider.dart';
+import 'package:video_player/video_player.dart';
+import 'package:integration_test/integration_test.dart';
+
+void main() {
+  Directory testDir;
+
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  setUpAll(() async {
+    final Directory extDir = await getTemporaryDirectory();
+    testDir = await Directory('${extDir.path}/test').create(recursive: true);
+  });
+
+  tearDownAll(() async {
+    await testDir.delete(recursive: true);
+  });
+
+  // final Map<ResolutionPreset, Size> presetExpectedSizes =
+  //     <ResolutionPreset, Size>{
+  //   ResolutionPreset.low:
+  //       Platform.isAndroid ? const Size(240, 320) : const Size(288, 352),
+  //   ResolutionPreset.medium:
+  //       Platform.isAndroid ? const Size(480, 720) : const Size(480, 640),
+  //   ResolutionPreset.high: const Size(720, 1280),
+  //   ResolutionPreset.veryHigh: const Size(1080, 1920),
+  //   ResolutionPreset.ultraHigh: const Size(2160, 3840),
+  //   // Don't bother checking for max here since it could be anything.
+  // };
+
+  final Map<ResolutionPreset, Size> presetExpectedSizes =
+      <ResolutionPreset, Size>{
+    ResolutionPreset.medium: const Size(480, 720),
+    // Don't bother checking for max here since it could be anything.
+  };
+
+  /// Verify that [actual] has dimensions that are at least as large as
+  /// [expectedSize]. Allows for a mismatch in portrait vs landscape. Returns
+  /// whether the dimensions exactly match.
+  bool assertExpectedDimensions(Size expectedSize, Size actual) {
+    expect(actual.shortestSide, lessThanOrEqualTo(expectedSize.shortestSide));
+    expect(actual.longestSide, lessThanOrEqualTo(expectedSize.longestSide));
+    return actual.shortestSide == expectedSize.shortestSide &&
+        actual.longestSide == expectedSize.longestSide;
+  }
+
+  // This tests that the capture is no bigger than the preset, since we have
+  // automatic code to fall back to smaller sizes when we need to. Returns
+  // whether the image is exactly the desired resolution.
+  Future<bool> testCaptureImageResolution(
+      CameraController controller, ResolutionPreset preset) async {
+    final Size expectedSize = presetExpectedSizes[preset];
+    print(
+        'Capturing photo at $preset (${expectedSize.width}x${expectedSize.height}) using camera ${controller.description.name}');
+
+    // Take Picture
+    final file = await controller.takePicture();
+
+    // Load picture
+    final File fileImage = File(file.path);
+    final Image image = await decodeImageFromList(fileImage.readAsBytesSync());
+
+    // Verify image dimensions are as expected
+    expect(image, isNotNull);
+    return assertExpectedDimensions(
+        expectedSize, Size(image.height.toDouble(), image.width.toDouble()));
+  }
+
+  testWidgets('Capture specific image resolutions',
+      (WidgetTester tester) async {
+    final List<CameraDescription> cameras = await availableCameras();
+    if (cameras.isEmpty) {
+      return;
+    }
+    for (CameraDescription cameraDescription in cameras) {
+      bool previousPresetExactlySupported = true;
+      for (MapEntry<ResolutionPreset, Size> preset
+          in presetExpectedSizes.entries) {
+        final CameraController controller =
+            CameraController(cameraDescription, preset.key);
+        await controller.initialize();
+        final bool presetExactlySupported =
+            await testCaptureImageResolution(controller, preset.key);
+        assert(!(!previousPresetExactlySupported && presetExactlySupported),
+            'The camera took higher resolution pictures at a lower resolution.');
+        previousPresetExactlySupported = presetExactlySupported;
+        await controller.dispose();
+      }
+    }
+  });
+
+  // This tests that the capture is no bigger than the preset, since we have
+  // automatic code to fall back to smaller sizes when we need to. Returns
+  // whether the image is exactly the desired resolution.
+  Future<bool> testCaptureVideoResolution(
+      CameraController controller, ResolutionPreset preset) async {
+    final Size expectedSize = presetExpectedSizes[preset];
+    print(
+        'Capturing video at $preset (${expectedSize.width}x${expectedSize.height}) using camera ${controller.description.name}');
+
+    // Take Video
+    await controller.startVideoRecording();
+    sleep(const Duration(milliseconds: 300));
+    final file = await controller.stopVideoRecording();
+
+    // Load video metadata
+    final File videoFile = File(file.path);
+    final VideoPlayerController videoController =
+        VideoPlayerController.file(videoFile);
+    await videoController.initialize();
+    final Size video = videoController.value.size;
+
+    // Verify image dimensions are as expected
+    expect(video, isNotNull);
+    return assertExpectedDimensions(
+        expectedSize, Size(video.height, video.width));
+  }
+
+  testWidgets('Capture specific video resolutions',
+      (WidgetTester tester) async {
+    final List<CameraDescription> cameras = await availableCameras();
+    if (cameras.isEmpty) {
+      return;
+    }
+    for (CameraDescription cameraDescription in cameras) {
+      bool previousPresetExactlySupported = true;
+      for (MapEntry<ResolutionPreset, Size> preset
+          in presetExpectedSizes.entries) {
+        final CameraController controller =
+            CameraController(cameraDescription, preset.key);
+        await controller.initialize();
+        // await controller.prepareForVideoRecording();
+        final bool presetExactlySupported =
+            await testCaptureVideoResolution(controller, preset.key);
+        assert(!(!previousPresetExactlySupported && presetExactlySupported),
+            'The camera took higher resolution pictures at a lower resolution.');
+        previousPresetExactlySupported = presetExactlySupported;
+        await controller.dispose();
+      }
+    }
+  });
+
+  testWidgets('Pause and resume video recording', (WidgetTester tester) async {
+    final List<CameraDescription> cameras = await availableCameras();
+    if (cameras.isEmpty) {
+      return;
+    }
+
+    final CameraController controller = CameraController(
+      cameras[0],
+      ResolutionPreset.low,
+      enableAudio: false,
+    );
+
+    await controller.initialize();
+    // await controller.prepareForVideoRecording();
+
+    int startPause;
+    int timePaused = 0;
+
+    await controller.startVideoRecording();
+    final int recordingStart = DateTime.now().millisecondsSinceEpoch;
+    sleep(const Duration(milliseconds: 500));
+
+    await controller.pauseVideoRecording();
+    startPause = DateTime.now().millisecondsSinceEpoch;
+    sleep(const Duration(milliseconds: 500));
+    await controller.resumeVideoRecording();
+    timePaused += DateTime.now().millisecondsSinceEpoch - startPause;
+
+    sleep(const Duration(milliseconds: 500));
+
+    await controller.pauseVideoRecording();
+    startPause = DateTime.now().millisecondsSinceEpoch;
+    sleep(const Duration(milliseconds: 500));
+    await controller.resumeVideoRecording();
+    timePaused += DateTime.now().millisecondsSinceEpoch - startPause;
+
+    sleep(const Duration(milliseconds: 500));
+
+    final file = await controller.stopVideoRecording();
+    final int recordingTime =
+        DateTime.now().millisecondsSinceEpoch - recordingStart;
+
+    final File videoFile = File(file.path);
+    final VideoPlayerController videoController = VideoPlayerController.file(
+      videoFile,
+    );
+    await videoController.initialize();
+    final int duration = videoController.value.duration.inMilliseconds;
+    await videoController.dispose();
+
+    expect(duration, lessThan(recordingTime - timePaused));
+  });
+
+  testWidgets(
+    'Android image streaming',
+    (WidgetTester tester) async {
+      final List<CameraDescription> cameras = await availableCameras();
+      if (cameras.isEmpty) {
+        return;
+      }
+
+      final CameraController controller = CameraController(
+        cameras[0],
+        ResolutionPreset.low,
+        enableAudio: false,
+      );
+
+      await controller.initialize();
+      bool _isDetecting = false;
+
+      await controller.startImageStream((CameraImage image) {
+        if (_isDetecting) return;
+
+        _isDetecting = true;
+
+        expectLater(image, isNotNull).whenComplete(() => _isDetecting = false);
+      });
+
+      expect(controller.value.isStreamingImages, true);
+
+      sleep(const Duration(milliseconds: 500));
+
+      await controller.stopImageStream();
+      await controller.dispose();
+    },
+    skip: !Platform.isAndroid,
+  );
+}