Rileva quando gli utenti acquisiscono screenshot del dispositivo

Per creare un'esperienza più standardizzata per il rilevamento degli screenshot, Android 14 introduce un'API di rilevamento screenshot che tutela la privacy. Questa API consente alle app di registrare i callback in base all'attività. Questi callback vengono richiamati e l'utente viene avvisato quando acquisisce uno screenshot mentre l'attività è visibile.

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 gli screenshot acquisiti durante l'esecuzione di comandi di test correlati agli screenshot, tra cui ADB, o nell'ambito dei test di strumentazione che acquisiscono i contenuti attuali della schermata del dispositivo.

Passaggi per l'implementazione

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

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

Dopodiché, completa questi passaggi per ogni attività nella tua app in cui gli utenti potrebbero acquisire screenshot:

1. Implementa un callback eseguendo l'override della funzione onScreenCapture(). In questo callback, la tua app può compiere un'azione, 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.

   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 preferisci che i contenuti dell'attività di un'app non vengano mostrati negli screenshot o su display non sicuri, imposta il flag di visualizzazione FLAG_SECURE.

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

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