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();
 
// Check current status
$blocked = Screenshots::isBlocked();

// 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();

use Native\Mobile\Attributes\OnNative;
use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotDetected;
 
#[OnNative(ScreenshotDetected::class)]
public function handleScreenshot($path = null, $timestamp = null)
{
    // $path is only available on Android
    Log::warning('User took a screenshot', ['path' => $path]);
}

use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotCaptured;
 
#[OnNative(ScreenshotCaptured::class)]
public function handleCaptured($path, $id = null, $success = true)
{
    // Process the captured image at $path
}

use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenshotCaptureFailed;
 
#[OnNative(ScreenshotCaptureFailed::class)]
public function handleFailed($error, $id = null)
{
    Log::error('Screenshot capture failed', ['error' => $error]);
}

use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenRecordingStarted;
 
#[OnNative(ScreenRecordingStarted::class)]
public function handleRecordingStarted($timestamp = null)
{
    // User started screen recording
    // Call Screenshots::block() if you want to show a privacy screen
}

use SRWieZ\NativePHP\Mobile\Screenshots\Events\ScreenRecordingStopped;
 
#[OnNative(ScreenRecordingStopped::class)]
public function handleRecordingStopped($timestamp = null)
{
    // User stopped screen recording
}

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.allow();
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();