composer require srwiez/nativephp-mobile-screenshots
 
php artisan vendor:publish --tag=nativephp-plugins-provider
 
php artisan native:plugin:register srwiez/nativephp-mobile-screenshots

use SRWieZ\NativePHP\Mobile\Screenshots\Facades\Screenshots;
 
// Protect a sensitive screen
Screenshots::block();
 
// Detect when users take screenshots
Screenshots::startDetection();
 
// Capture the screen programmatically
$captureId = Screenshots::capture();

// Start listening for screenshots
Screenshots::startDetection();
 
// Stop listening
Screenshots::stopDetection();

// Block screenshots
Screenshots::block();
 
// Customize or disable the iOS recording overlay
Screenshots::block(privacyText: 'Recording is disabled on this screen');
Screenshots::block(privacyOverlay: false);
 
// Allow screenshots again
Screenshots::allow();
 
// Keep blocking after an app restart (see "Blocking from the first frame")
Screenshots::block(persist: true);
 
// Check current status
$blocked = Screenshots::isBlocked();

// Block now, and again on every app start
Screenshots::block(persist: true);
 
// Allow now, and forget the persisted block
Screenshots::allow(persist: true);

// Returns a capture ID to correlate with events
$captureId = Screenshots::capture();

// Check if currently being recorded (on Android, start detection first)
$recording = Screenshots::isRecording(); // bool
 
// Start listening for recording changes
Screenshots::startRecordingDetection();
 
// Stop listening
Screenshots::stopRecordingDetection();

Screenshots::isAvailable();        // the plugin's native side is installed
Screenshots::canDetectRecording(); // recording detection works on this device

use Native\Mobile\Attributes\On;
use Native\Mobile\Edge\NativeComponent;
use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotDetected;
 
class AccountScreen extends NativeComponent
{
    #[On(ScreenshotDetected::class)]
    public function screenshotDetected(?string $path = null, ?int $timestamp = null): void
    {
        // $path is only set by Android's MediaStore detection
    }
}

use Livewire\Attributes\On;
use Livewire\Component;
use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotCaptured;
 
class AccountScreen extends Component
{
    #[On('native:'.ScreenshotCaptured::class)]
    public function screenshotCaptured(string $path, ?string $id = null): void
    {
        // Process the captured image at $path
    }
}

use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Log;
use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotDetected;
 
Event::listen(function (ScreenshotDetected $event) {
    Log::warning('User took a screenshot', ['at' => $event->timestamp]);
});

import { mobileScreenshots } from '../../vendor/srwiez/nativephp-mobile-screenshots/resources/js/mobileScreenshots.js';
 
// Detection
await mobileScreenshots.startDetection();
await mobileScreenshots.stopDetection();
 
// Blocking
await mobileScreenshots.block();
await mobileScreenshots.block({ privacy_overlay: false });
await mobileScreenshots.block({ persist: true }); // also after an app restart
await mobileScreenshots.allow();
await mobileScreenshots.allow({ persist: true }); // forget the persisted block
const { blocked } = await mobileScreenshots.isBlocked();
 
// Capture
const { id } = await mobileScreenshots.capture();
 
// Recording detection (iOS 17+, Android 15+)
const { recording } = await mobileScreenshots.isRecording();
await mobileScreenshots.startRecordingDetection();
await mobileScreenshots.stopRecordingDetection();

// For maximum protection on both platforms:
 
// 1. Always block when showing sensitive content
Screenshots::block();
 
// 2. Start detection to log/audit attempts
Screenshots::startDetection();
 
// 3. Detect screen recording (iOS 17+, Android 15+; fires events only)
Screenshots::startRecordingDetection();
 
// block() handles privacy screen during recording on iOS

use Native\Mobile\Testing\FakeBridge;
 
$bridge = FakeBridge::enable()->withRecording();
 
// ... exercise your component ...
 
$bridge->assertBlocked();
$bridge->assertDetectionStarted();