Rileva quando gli utenti acquisiscono screenshot del dispositivo

Figura 1. Esempio di messaggio toast fornito dal sistema che viene visualizzata quando l'utente acquisisce lo screenshot di un'app che supporta l'API di rilevamento degli screenshot.

Per creare un'esperienza di rilevamento degli screenshot più standardizzata, Android 14 introduce un rilevamento di screenshot incentrato sulla tutela della privacy tramite Google Cloud CLI o tramite l'API Compute Engine. Questa API consente alle app di registrare i callback in base all'attività. Questi callback vengono richiamati e l'utente riceve una notifica quando acquisisce uno screenshot mentre l'attività è visibile.

Nota: il callback non fornisce un'immagine dello screenshot effettivo. Spetta alla tua app determinare cosa è apparso sullo schermo quando l'utente ha acquisito uno screenshot.

Casi d'uso supportati

In Android 14, l'API di sistema rileva uno screenshot solo se l'utente esegue una combinazione specifica di pressioni dei pulsanti hardware. L'API non rileva screenshot acquisiti durante l'esecuzione di comandi di test correlati agli screenshot; incluso ADB o all'interno dei test di strumentazione che acquisiscono i contenuti correnti dello schermo.

Passaggi per l'implementazione

Per aggiungere il rilevamento di screenshot, dichiara la nuova DETECT_SCREEN_CAPTURE autorizzazione al momento dell'installazione:

<uses-permission android:name="android.permission.DETECT_SCREEN_CAPTURE" />

Poi completa questi passaggi per ogni attività nella tua app in cui gli utenti potrebbero acquisisci screenshot:

1. Implementa un callback eseguendo l'override della funzione onScreenCapture(). In questo il callback, la tua app può intervenire, ad esempio avvisare un altro utente che qualcuno ha acquisito uno screenshot di una conversazione di messaggi.

   Kotlin

   val screenCaptureCallback = Activity.ScreenCaptureCallback {
       // Add logic to take action in your app.
   }

   Java

   final Activity.ScreenCaptureCallback screenCaptureCallback =
       new Activity.ScreenCaptureCallback() {
           @Override
           public void onScreenCaptured() {
               // Add logic to take action in your app.
           }
       };

2. Nel metodo onStart() dell'attività, registra il callback dello screenshot.

   Nota: dato che viene mostrata una notifica a ogni segnale di rilevamento degli screenshot, gli sviluppatori devono fornire notifiche contestuali all'utente quando avviando un'attività che utilizza API di rilevamento di screenshot in modo che il sistema non sorprende gli utenti.

   Kotlin

   override fun onStart() {
       super.onStart()
       // Pass in the callback created in the previous step 
       // and the intended callback executor (e.g. Activity's mainExecutor).
       registerScreenCaptureCallback(mainExecutor, screenCaptureCallback)
   }

   Java

   @Override
   protected void onStart() {
       super.onStart();
       // Pass in the callback created in the previous step 
       // and the intended callback executor (e.g. Activity's mainExecutor).
       registerScreenCaptureCallback(executor, screenCaptureCallback);
   }

3. Nel metodo onStop() dell'attività, annulla la registrazione del callback dello screenshot:

   Kotlin

   override fun onStop() {
       super.onStop()
       unregisterScreenCaptureCallback(screenCaptureCallback)
   }

   Java

   @Override
   protected void onStop() {
       super.onStop();
       unregisterScreenCaptureCallback(screenCaptureCallback);
   }

Controlla la possibilità di acquisire screenshot

Se non vuoi che i contenuti dell'attività di un'app vengano mostrati negli screenshot, oppure sui display non sicuri, imposta il flag di visualizzazione FLAG_SECURE.

Nota: per garantire trasparenza e controllo da parte dell'utente, ti consigliamo di aggiungere un'impostazione nella tua app che consenta agli utenti di attivare/disattivare questo flag.

Kotlin

activity.getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE)

Java

activity.getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE);