Per creare un'esperienza più standardizzata per il rilevamento degli screenshot, Android 14 introduce un'API di rilevamento degli screenshot che tutela la privacy. Questa API consente alle app di registrare i callback in base alle attività. Questi callback vengono richiamati e l'utente riceve una notifica quando l'utente 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 di pulsanti hardware. L'API non rileva gli screenshot acquisiti durante l'esecuzione dei comandi di test relativi agli screenshot, incluso ADB, o all'interno di test di strumentazione che acquisiscono i contenuti attuali dello schermo del dispositivo.
Passaggi per l'implementazione
Per aggiungere il rilevamento di screenshot, dichiara la nuova autorizzazione al momento dell'installazione di DETECT_SCREEN_CAPTURE
:
<uses-permission android:name="android.permission.DETECT_SCREEN_CAPTURE" />
Poi, completa questi passaggi per ogni attività nella tua app in cui gli utenti potrebbero acquisire screenshot:
Per implementare un callback, esegui l'override della funzione
onScreenCapture()
. In questo callback, la tua app può agire, 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. } };
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); }
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); }
Controllo della possibilità di acquisire screenshot
Se non vuoi che i contenuti dell'attività di un'app vengano visualizzati negli screenshot o su display non protetti, imposta il flag di visualizzazione FLAG_SECURE
.
Kotlin
activity.getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE)
Java
activity.getWindow().setFlags(LayoutParams.FLAG_SECURE, LayoutParams.FLAG_SECURE);