feat(camera): adds multi-shot camera feature (#1616) #2392

shiv19 · 2025-07-31T14:02:16Z

Summary

This pull request introduces significant enhancements to the Camera plugin, focusing on multi-camera support and landscape mode functionality for both Android and iOS platforms. The changes include new features and UI improvements to improve the user experience when capturing and previewing images using the @capacitor/camera package

Resolves #1616

ℹ️ Disclaimer
This code was generated with the help of GPT-4.1, Gemini 2.5 Pro, Claude 3.7 Sonnet and Claude Sonnet 4, with human guidance and UX review.

Demos

Android - https://github.com/user-attachments/assets/5813e036-065d-49dc-bd1f-2097c657fdc8

iOS - user-attachments/assets/f70930f8-495d-4b65-bb1c-a73479a28218

Example Usage

const options: ImageOptions = {
          quality: 80,
          width: maxWidth,
          height: maxHeight,
          source: CameraSource.CameraMulti,
          resultType: CameraResultType[outputType],
          correctOrientation: true,
          saveToGallery: true,
};
return Camera.getPhoto(options);

Example Response

{
    "photos": [
        {
            "format": "jpeg",
            "exif": {
                "ColorSpace": "65535",
                "ComponentsConfiguration": "???",
                "DateTime": "2025:07:31 12:57:39",
                "DateTimeDigitized": "2025:07:31 12:57:39",
                "DateTimeOriginal": "2025:07:31 12:57:39",
                "ExifVersion": "0210",
                "ExposureTime": "0.01",
                "Flash": "0",
                "FlashpixVersion": "0100",
                "FocalLength": "1000/1000",
                "FNumber": "4.0",
                "ImageLength": "640",
                "ImageWidth": "1280",
                "LightSource": "0",
                "Make": "Google",
                "Model": "sdk_gphone16k_arm64",
                "Orientation": "1",
                "PhotographicSensitivity": "200",
                "ResolutionUnit": "2",
                "SubSecTime": "871",
                "SubSecTimeDigitized": "000",
                "SubSecTimeOriginal": "000",
                "WhiteBalance": "0",
                "XResolution": "72/1",
                "YCbCrPositioning": "1",
                "YResolution": "72/1"
            },
            "path": "file:///data/user/0/<your_app_package_name_here>/cache/1000000027.1753941688084.jpeg",
            "webPath": "http://192.168.1.2:8101/_capacitor_file_/data/user/0/<your_app_package_name_here>/cache/1000000027.1753941688084.jpeg",
            "saved": false
        },
        {
            "format": "jpeg",
            "exif": {
                "ColorSpace": "65535",
                "ComponentsConfiguration": "???",
                "DateTime": "2025:07:31 12:57:45",
                "DateTimeDigitized": "2025:07:31 12:57:45",
                "DateTimeOriginal": "2025:07:31 12:57:45",
                "ExifVersion": "0210",
                "ExposureTime": "0.01",
                "Flash": "0",
                "FlashpixVersion": "0100",
                "FocalLength": "1000/1000",
                "FNumber": "4.0",
                "ImageLength": "640",
                "ImageWidth": "1280",
                "LightSource": "0",
                "Make": "Google",
                "Model": "sdk_gphone16k_arm64",
                "Orientation": "1",
                "PhotographicSensitivity": "200",
                "ResolutionUnit": "2",
                "SubSecTime": "312",
                "SubSecTimeDigitized": "000",
                "SubSecTimeOriginal": "000",
                "WhiteBalance": "0",
                "XResolution": "72/1",
                "YCbCrPositioning": "1",
                "YResolution": "72/1"
            },
            "path": "file:///data/user/0/<your_app_package_name_here>/cache/1000000028.1753941688118.jpeg",
            "webPath": "http://192.168.1.2:8101/_capacitor_file_/data/user/0/<your_app_package_name_here>/cache/1000000028.1753941688118.jpeg",
            "saved": false
        },
        {
            "format": "jpeg",
            "exif": {
                "ColorSpace": "65535",
                "ComponentsConfiguration": "???",
                "DateTime": "2025:07:31 12:57:38",
                "DateTimeDigitized": "2025:07:31 12:57:38",
                "DateTimeOriginal": "2025:07:31 12:57:38",
                "ExifVersion": "0210",
                "ExposureTime": "0.01",
                "Flash": "0",
                "FlashpixVersion": "0100",
                "FocalLength": "1000/1000",
                "FNumber": "4.0",
                "ImageLength": "640",
                "ImageWidth": "1280",
                "LightSource": "0",
                "Make": "Google",
                "Model": "sdk_gphone16k_arm64",
                "Orientation": "1",
                "PhotographicSensitivity": "200",
                "ResolutionUnit": "2",
                "SubSecTime": "329",
                "SubSecTimeDigitized": "000",
                "SubSecTimeOriginal": "000",
                "WhiteBalance": "0",
                "XResolution": "72/1",
                "YCbCrPositioning": "1",
                "YResolution": "72/1"
            },
            "path": "file:///data/user/0/<your_app_package_name_here>/cache/1000000026.1753941688143.jpeg",
            "webPath": "http://192.168.1.2:8101/_capacitor_file_/data/user/0/<your_app_package_name_here>/cache/1000000026.1753941688143.jpeg",
            "saved": false
        }
    ]
}

Changes Included

feat(camera): adds multi-camera feature for Android
- Introduced the ability to use multiple cameras on Android devices.
feat(camera): multi shot camera UI improvements with immersive mode support
- Enhanced the multi-shot camera UI and added immersive mode for a better user experience.
feat(camera): iOS multi camera base implementation
- Added the foundational implementation for multi-camera support on iOS.
feat(camera): multi camera image preview support for android
- Enabled image preview functionality for multi-camera captures on Android.
feat(camera): added support for landscape mode multi shot camera on android
- Implemented landscape mode support for multi-shot camera on Android devices.
bugfix(camera): camera preview landscape mode and thumbnail strip bugfix for android
- Fixed issues related to camera preview and thumbnail strip in landscape mode on Android.
feat(camera): landscape mode support for iOS
- Added landscape mode support for the camera on iOS devices.

Motivation

Sometimes users want to be able to take multiple photos and attach them in the app. The previous UX was jarring and most users instead resort to the phone camera app and then attach files from the gallery, with the multi camera support, users can now take multiple photos without leaving your app.

Testing

Verified multi-camera functionality on both Android and iOS devices.
Tested landscape mode for camera preview and image capture.
Ensured UI improvements and bug fixes work as intended.
Mainly tested using S22 Ultra for Android and iPhone 12 for iOS. I recommend testing this further before merging.

Known quirks

Android currently saves the images to your camera roll, but iOS doesn't.
iOS zooming UX is slightly different from Android, but both support pinch to zoom.
When previewing a thumbnail by tapping on it, you can't swipe to the next item in the thumbnail preview list.

Related Issues

@capacitor/camera take multiple photos via the camera in one session #1616 (Multi-camera feature for Android)

Please review the changes and provide feedback or approval for merging into main.

Packed plugin (if anyone wants to try it locally)

capacitor-camera-7.0.1.tgz

…upport

…ndroid

…s no exif data on android

shiv19 · 2025-08-01T02:39:20Z

The thumbnail bar logic needs optimizations on Android.

…r android

shiv19 · 2025-08-01T13:18:37Z

Made improvements to image processing on the Android side.
Now we proactively add a processing thumbnail to give the user immediate feedback.
If images are processing when the user clicks done, we wait for the images to finish processing.

…ogger

shiv19 · 2025-08-01T15:21:58Z

Latest iOS Demo: (also updated the link in the PR desc)
https://github.com/user-attachments/assets/f70930f8-495d-4b65-bb1c-a73479a28218

shiv19 · 2025-08-01T15:25:02Z

Latest Android Demo: (also updated the link in the PR desc)
https://github.com/user-attachments/assets/5813e036-065d-49dc-bd1f-2097c657fdc8

shiv19 · 2025-08-01T15:25:47Z

Latest packed plugin: (also updated the link in the PR desc)
capacitor-camera-7.0.1.tgz

shiv19 · 2025-08-01T15:29:03Z

Works on Android tablet ✅

Can't test it on iPad since I don't have one and simulator doesn't simulate camera.

isbecker and others added 9 commits July 31, 2025 12:38

feat(camera): adds multi-camera feature for Android (ionic-team#1616)

bde22c2

feat(camera): multi shot camera UI improvements with immersive mode s…

89d7895

…upport

feat(camera): iOS multi camera base implementation

cd97eb7

feat(camera): multi camera image preview support for android

7ecd892

feat(camera): added support for landscape mode multi shot camera on a…

888d632

…ndroid

feat(camera): landscape mode ux improvements for android

9b17244

feat(camera): landscape mode support for iOS

a5338fd

chore(camera): updated readme

7eec596

feat(camera): ui improvements and image rotation handler when there i…

bec2abb

…s no exif data on android

shiv19 added 3 commits August 1, 2025 19:12

feat(camera): multi camera image thumbnail processing improvements fo…

b4e20cf

…r android

feat(camera): wait for processing before closing camera - android

fa3b05f

chore(camera): lint android

95898f7

shiv19 added 2 commits August 1, 2025 21:07

feat(camera): zoom button support for landscape mode in android

2466d03

feat(camera): safe area awareness for android multi camera

1f6f101

shiv19 marked this pull request as draft August 1, 2025 14:37

shiv19 added 4 commits August 1, 2025 21:44

chore(camera): cleanup camera fragment logs and switch to capacitor l…

c4b5d37

…ogger

feat(camera): improved thumbnail loading ux, fixed saveToGallery option

c62fd7e

fix(camera): wait for processing to complete before confirming selection

77a64a8

feat(camera): added support for quality, width and heigh to ios multicam

8dc217d

shiv19 marked this pull request as ready for review August 1, 2025 15:19

shiv19 added 2 commits August 1, 2025 23:03

chore(camera): match the android discard photos alert message with iOS

b56d88d

Merge branch 'main' into feat/multi-camera

ee29b2a

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(camera): adds multi-shot camera feature (#1616) #2392

feat(camera): adds multi-shot camera feature (#1616) #2392

Uh oh!

shiv19 commented Jul 31, 2025 •

edited

Loading

Uh oh!

shiv19 commented Aug 1, 2025

Uh oh!

shiv19 commented Aug 1, 2025

Uh oh!

shiv19 commented Aug 1, 2025 •

edited

Loading

Uh oh!

shiv19 commented Aug 1, 2025 •

edited

Loading

Uh oh!

shiv19 commented Aug 1, 2025 •

edited

Loading

Uh oh!

shiv19 commented Aug 1, 2025 •

edited

Loading

Uh oh!

Uh oh!

feat(camera): adds multi-shot camera feature (#1616) #2392

Are you sure you want to change the base?

feat(camera): adds multi-shot camera feature (#1616) #2392

Uh oh!

Conversation

shiv19 commented Jul 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Demos

Example Usage

Example Response

Changes Included

Motivation

Testing

Known quirks

Related Issues

Packed plugin (if anyone wants to try it locally)

Uh oh!

shiv19 commented Aug 1, 2025

Uh oh!

shiv19 commented Aug 1, 2025

Uh oh!

shiv19 commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

shiv19 commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

shiv19 commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

shiv19 commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

shiv19 commented Jul 31, 2025 •

edited

Loading

shiv19 commented Aug 1, 2025 •

edited

Loading

shiv19 commented Aug 1, 2025 •

edited

Loading

shiv19 commented Aug 1, 2025 •

edited

Loading

shiv19 commented Aug 1, 2025 •

edited

Loading