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\MobileScreenshots;
 
// Protect a sensitive screen
MobileScreenshots::block();
 
// Detect when users take screenshots
MobileScreenshots::startDetection();
 
// Capture the screen programmatically
$captureId = MobileScreenshots::capture();

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

// Block screenshots
MobileScreenshots::block();
 
// Allow screenshots again
MobileScreenshots::allow();
 
// Check current status
$blocked = MobileScreenshots::isBlocked();

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

// Check if currently being recorded
$result = MobileScreenshots::isRecording();
// Returns: ['recording' => true/false]
 
// Start listening for recording changes
MobileScreenshots::startRecordingDetection();
 
// Stop listening
MobileScreenshots::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 MobileScreenshots::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 '@srwiez/nativephp-mobile-screenshots';
 
// Detection
await mobileScreenshots.startDetection();
await mobileScreenshots.stopDetection();
 
// Blocking
await mobileScreenshots.block();
await mobileScreenshots.allow();
const { blocked } = await mobileScreenshots.isBlocked();
 
// Capture
const { id } = await mobileScreenshots.capture();
 
// Recording detection (iOS)
const { recording } = await mobileScreenshots.isRecording();
await mobileScreenshots.startRecordingDetection();
await mobileScreenshots.stopRecordingDetection();

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