Screen Recording Detection

Android devices are capable of recording their screen. Frequently a recorded screen is also shared elsewhere (similar to screen sharing). Screen recording can pose a security risk, as sensitive information might be leaking from app screens.

Since Android 15, Malwarelytics for Android is able to detect that the screen is being recorded and can be configured to terminate the app in such a case. Info about the detections is then delivered through the MalwarelyticsRaspListener.

The screen recording detection feature is available only on Android 15+. The callbacks are not delivered on older versions of Android regardless of the configuration. Similarly, the manual check methods report valid data only on Android 15+.

Configuration

This feature can be configured during the Malwarelytics initialization in MalwarelyticsConfig.

import { MalwarelyticsConfig } from "react-native-malwarelytics";

const config: MalwarelyticsConfig = {
  android: {
    rasp: {
      screenRecording: {
        action: 'NOTIFY' // or 'EXIT' or 'NO_ACTION'
        // exitUrl: "https://your.exit.url"
      }
    }
  }
}

Available values of action:

List of available parameters:

Usage

After initialization, the screen recording detection feature can be accessed via malwarelytics.rasp. This can be used to register an observer or to trigger a manual screen recording detection check.

Registering an Observer

To receive notifications about screen recording events, you need to implement the optional onScreenRecordingDetected method in your MalwarelyticsRaspListener.

import { Malwarelytics, MalwarelyticsRaspListener, ScreenRecordingDetectionInfo } from "react-native-malwarelytics";

const listener: MalwarelyticsRaspListener = {
    // ... other listener methods
    onScreenRecordingDetected(info: ScreenRecordingDetectionInfo): void {
      console.log(`Screen recording detected: ${JSON.stringify(info)}`)
    }
}

Malwarelytics.sharedInstance.rasp.setRaspListener(listener);

The ScreenRecordingDetectionInfo object contains the following properties:

The ScreenRecordingVisibilityStatus can have the following values:

Triggering a Manual Check

The screen recording detection check can be triggered manually. Two methods are available – isScreenBeingRecorded() gives a simple boolean answer, whereas getScreenRecordingDetection() provides more details.

import { Malwarelytics } from "react-native-malwarelytics";

async function checkScreenRecording() {
    const isRecording = await Malwarelytics.sharedInstance.rasp.isScreenBeingRecorded();
    if (isRecording) {
        console.log("Screen is being recorded.");
    }

    const recordingInfo = await Malwarelytics.sharedInstance.rasp.getScreenRecordingDetection();
    console.log("Screen recording details:", recordingInfo);
}