A flutter plugin to handle Android / iOS camera


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 ๐Ÿ˜ƒ ).

๐Ÿ“–  Installation and usage

Set permissions

  • iOS add these on ios/Runner/Info.plist file
<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 the package

import 'package:camerawesome/camerawesome_plugin.dart';

Define notifiers (if needed) & controller

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 {
  _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.


_switchFlash.value = CameraFlashes.AUTO

Create your camera

// [...]
  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,
// [...]

Reveal parameters list

Param Type Description Required
testMode boolean true to wrap texture
onPermissionsResult OnPermissionsResult implement this to have a callback after CameraAwesome asked for permissions
selectDefaultSize OnAvailableSizes implement this to select a default size from device available size list โœ…
onCameraStarted OnCameraStarted notify client that camera started
onOrientationChanged OnOrientationChanged notify client that orientation changed
switchFlashMode ValueNotifier<CameraFlashes> change flash mode
zoom ValueNotifier<double> Zoom from native side. Must be between 0 and 1
sensor ValueNotifier<Sensors> sensor to initiate BACK or FRONT โœ…
photoSize ValueNotifier<Size> choose your photo size from the [selectDefaultSize] method
orientation DeviceOrientation initial orientation
fitted bool whether camera preview must be as big as it needs or cropped to fill with. false by default

Take a photo ๐ŸŽ‰

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

๐Ÿ“ฑ  Tested devices

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.

Reveal grid

Devices Flash Focus Zoom Flip
iPhone X โœ… โœ… โœ… โœ…
iPhone 7 โœ… โœ… โœ… โœ…
One Plus 6T โœ… โœ… โœ… โœ…
Xiaomi redmi โœ… โœ… โœ… โœ…
Honor 7 โœ… โœ… โœ… โœ…

๐ŸŽฏ  Our goals

Feel free to help by submitting PR !

  • [ ] ๐Ÿ“ก Broadcast live image stream
  • [ ] ๐ŸŽฅ Record video
  • [ ] ๐ŸŒ  Focus on specific point
  • [x] ~~ ๐ŸŒค Exposure level~~
  • [x] Add e2e tests
  • [x] Fullscreen/SizedBox support
  • [x] Complete example
  • [x] Take a picture
  • [x] Zoom level
  • [x] Live switching camera
  • [x] Device flash support
  • [x] Auto focus


Initiated and sponsored by Apparence.io.


Contributions are welcome. Contribute by creating a PR or create an issue ๐ŸŽ‰.

Download Details:

Author: Apparence-io

Source Code: https://github.com/Apparence-io/camera_awesome

#flutter #dart #mobile-apps

A flutter plugin to handle Android / iOS camera
14.60 GEEK