README

A NativePHP plugin that opens a persistent camera interface on iOS and Android. The user can tap Take Photo repeatedly to capture multiple images — the camera stays open between shots. Each captured image is saved to the mobile_public disk with a UUID filename and an ImageCaptured event is dispatched to PHP after every capture.

Platform: iOS 18.2+ and Android 8.0 (API 26)+. Requires NativePHP Mobile v4 (nativephp/mobile ^4.0) and PHP 8.4.

Installation

composer require pteal79/rapid-camera-capture

# Publish the plugins provider (first time only)
php artisan vendor:publish --tag=nativephp-plugins-provider

# Register the plugin
php artisan native:plugin:register pteal79/rapid-camera-capture

# Verify
php artisan native:plugin:list

Requirements

Permissions

Android requests android.permission.CAMERA when the camera opens; the plugin manifest adds it to the app.

iOS Permissions

The following is added to your app's Info.plist automatically via the plugin manifest:

Key	Description
`NSCameraUsageDescription`	Required for camera access

Usage

Open the Camera

use PTeal79\RapidCameraCapture\Facades\RapidCameraCapture;

RapidCameraCapture::open();

The camera interface is presented full-screen. The user can tap Take Photo as many times as they like. Each photo is saved immediately. The camera closes when the user taps Close.

Handle Captured Images (SuperNative)

use Native\Mobile\Attributes\On;
use PTeal79\RapidCameraCapture\Events\ImageCaptured;

#[On(ImageCaptured::class)]
public function onImageCaptured(string $filename = '', string $path = ''): void
{
    // $filename — UUID-based, e.g. "550e8400-e29b-41d4-a716-446655440000.jpg"
    // $path     — absolute path on the device filesystem

    // Show it with <native:image :src="$path" />, or read it from the disk:
    // Storage::disk('mobile_public')->get($filename);
    $this->photos[] = $path;
}

Events

`ImageCaptured`

Fired after every successful photo capture, before the camera is ready for the next shot.

Property	Type	Description
`filename`	string	UUID filename, e.g. `{uuid}.jpg`
`path`	string	Absolute path to the file on device

JavaScript Usage

import { RapidCameraCapture, Events } from '@pteal79/rapid-camera-capture';
import { On, Off } from '#nativephp';

// Open the camera
await RapidCameraCapture.open();

// React to each captured image
const handler = ({ filename, path }) => {
    console.log('New photo:', filename);
};

On(Events.ImageCaptured, handler);

// Clean up
Off(Events.ImageCaptured, handler);

How It Works

On iOS the plugin uses AVCaptureSession with AVCapturePhotoOutput and AVCaptureVideoPreviewLayer for a live, persistent camera preview. Unlike UIImagePickerController, the session stays active so the user can capture an unlimited number of photos in one session. Each JPEG is written to the app's mobile_public storage directory with a UUID filename, then LaravelBridge.shared.send dispatches the ImageCaptured event back to PHP.

On Android a full-screen activity uses CameraX (ImageCapture at maximum quality, with a PreviewView), saves each JPEG the same way, and sends the same event. It asks for the camera permission itself when it opens.

License

MIT

pteal79 / rapid-camera-capture

Package info

Security

Statistics