✨🚧 Multi camera support

[istornz]

Description

CamerAwesome is now able to show multiple sensors preview! 📹

This is the most requested feature in the official camera plugin ⭐️

This PR add multi camera feature for iOS (Android will be developed soon by @apalala-dev ).

How it's work?

CamerAwesome now provide a list of Sensor. You just need what you want to display (front, back camera or telephoto, wide angle camera etc.).

First Sensor provided in the array will be displayed in fullscreen (like CamerAwesome do now), each others sensors will be added in a floating preview which can be dragged by the user.

Demo

This example show sensors:

• Wide angle (back).
• Telephoto.
• Front

Example

CameraAwesomeBuilder.awesome(
  // [...]
  sensors: [
    Sensor.position(SensorPosition.back),
    Sensor.position(SensorPosition.front),
  ],
  // [...]
),

This sample code, show back sensor in fullscreen (because set at first).

User will seen a floating preview which is showing front camera (user will be able to drag floating preview to change it's position).

Roadmap

• [ ] ✨ Android integration.
• [ ] ✨ Take multiple picture from all sensors (currently, when taking a picture, only the first sensor is taken).
• [ ] ✨ Find a way to show multiple taken pictures in examples.
• [ ] ⚡️ Find a way to know how maximum camera is supported in one multi camera session (budget on iOS).
• [ ] 🚸 Create a factory to define single & multi camera (intent to improve usability).
• [ ] 🚸 Specify camera index to change zoom, brightness etc.
• [ ] 🚸 Add ability to set config for awesome camera floating preview (position & size).
• [ ] 📝 Add documentation.

This PR will close #131

Checklist

Before creating any Pull Request, confirm that it meets all requirements listed below by checking the relevant checkboxes ([x]).

• [x] 📕 I read the Contributing page.
• [x] 🤝 I match the actual coding style.
• [x] ✅ I ran flutter analyze without any issues.

Breaking Change

• [x] 🛠 My feature contain breaking change.

• Sensors enum has been renamed SensorPosition.

• sensors attribute in CameraAwesomeBuilder now accept a list of Sensor.

[aytunch]

@istornz thank you for your hard work. quick 2 questions:

1. As far as I see we can preview both cameras at the same time. Can we also save these multiple video streams to separate files as well?
2. Is there a chance we can display the multiple video stream according to our UI needs? So not full screen and maybe preview both cameras in small circular widgets in my widget tree in a row next to each other? Does the API allow developers to display previews however they like?

[Sun3]

I am also interested in this feature, is there an update?

Also will we have the ability to save the multi camera photos merged and separate?

Thank you.