feisher / camera_awesome Goto Github PK

Flutter plugin to add Camera support inside your project.

CamerAwesome include a lot of useful features like:

• 📲 Live camera flip ( switch between rear & front camera without rebuild ).
• ⚡️ No init needed, just add CameraAwesome widget !
• ⌛️ Instant focus.
• 📸 Device flash support.
• 🎚 Zoom.
• 🖼 Fullscreen or SizedBox preview support.
• 🎮 Complete example.
• 🎞 Taking a picture ( of course 😃 ).

• iOS add these on ios/Runner/Info.plist file

<key>NSCameraUsageDescription</key>
<string>Your own description</string>

• Android

  • Set permissions before <application>
  
  

  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

  • Change the minimum SDK version to 21 (or higher) in android/app/build.gradle
  
  

  minSdkVersion 21
  

import 'package:camerawesome/camerawesome_plugin.dart';

ValueNotifier is a usefull change notifier from Flutter framework. It fires an event on all listener when value changes. Take a look here for ValueNotifier doc

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with TickerProviderStateMixin {
  // [...]
  // Notifiers
  ValueNotifier<CameraFlashes> _switchFlash = ValueNotifier(CameraFlashes.NONE);
  ValueNotifier<Sensors> _sensor = ValueNotifier(Sensors.BACK);
  ValueNotifier<Size> _photoSize = ValueNotifier(null);

  // Controller
  PictureController _pictureController = new PictureController();
  // [...]
}

If you want to change a config, all you need is setting the value. CameraAwesome will handle the rest.

Example:

_switchFlash.value = CameraFlashes.AUTO

// [...]
@override
  Widget build(BuildContext context) {
    return CameraAwesome(
      testMode: false,
      onPermissionsResult: (bool result) { }
      selectDefaultSize: (List<Size> availableSizes) => Size(1920, 1080),
      onCameraStarted: () { },
      onOrientationChanged: (CameraOrientations newOrientation) { },
      zoom: 0.64,
      sensor: _sensor,
      photoSize: _photoSize,
      switchFlashMode: _switchFlash,
      orientation: DeviceOrientation.portraitUp,
      fitted: true,
    );
  };
// [...]

await _pictureController.takePicture('THE_IMAGE_PATH/myimage.jpg');

The property imagesStreamBuilder allows you to get an imageStream once the camera is ready. Don't try to show all these images on Flutter UI as you won't have time to refresh UI fast enough. (there is too much images/sec).

CameraAwesome(
    ...
    imagesStreamBuilder: (imageStream) {
        /// listen for images preview stream
        /// you can use it to process AI recognition or anything else...
        print("-- init CamerAwesome images stream");
    },
)

CamerAwesome was developed to support most devices on the market but some feature can't be fully functional. You can check if your device support all feature by clicking bellow.

Feel free to contribute to improve this compatibility list.

Feel free to help by submitting PR !

• 🎥 Record video
• 🌠 Focus on specific point
• 📡 Broadcast live image stream
• 🌤 Exposure level
• Add e2e tests
• Fullscreen/SizedBox support
• Complete example
• Take a picture
• Zoom level
• Live switching camera
• Device flash support
• Auto focus

Initiated and sponsored by Apparence.io.

Contributions are welcome. Contribute by creating a PR or create an issue 🎉.