Detecta cuando los usuarios toman capturas de pantalla del dispositivo

Figura 1: Un ejemplo del mensaje de aviso proporcionado por el sistema que aparece cuando el usuario toma una captura de pantalla de una app que admite la API de detección de capturas de pantalla.

Para crear una experiencia más estandarizada para detectar capturas de pantalla, Android 14 presenta una API de detección de capturas de pantalla que preserva la privacidad. Esta API permite que las apps registren devoluciones de llamada por actividad. Estas devoluciones de llamada se invocan y se le notifica al usuario cuando toma una captura de pantalla mientras esa actividad está visible.

Nota: La devolución de llamada no proporciona una imagen de la captura de pantalla real. Depende de tu app determinar qué apareció en la pantalla cuando el usuario tomó una captura de pantalla.

Casos de uso compatibles

En Android 14, la API del sistema solo detecta una captura de pantalla si el usuario realiza una combinación específica de presiones de botones de hardware. La API no detecta las capturas de pantalla que se toman cuando se ejecutan comandos de prueba relacionados con capturas de pantalla, incluido ADB, o dentro de pruebas de instrumentación que capturan el contenido actual de la pantalla del dispositivo.

Pasos de implementación

Para agregar la detección de capturas de pantalla, declara el nuevo permiso de tiempo de instalación DETECT_SCREEN_CAPTURE:

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

Luego, completa estos pasos para cada actividad de tu app en la que los usuarios puedan capturar capturas de pantalla:

1. Para implementar una devolución de llamada, anula la función onScreenCapture(). En esta devolución de llamada, tu app puede tomar medidas, como advertir a otro usuario que alguien tomó una captura de pantalla de una conversación de mensajería.

   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. En el método onStart() de la actividad, registra la devolución de llamada de captura de pantalla.

   Nota: Dado que se muestra un aviso con cada indicador de detección de capturas de pantalla, los desarrolladores deben proporcionar avisos contextuales al usuario cuando inician una actividad que usa APIs de detección de capturas de pantalla para que el aviso del sistema no sea una sorpresa para los usuarios.

   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. En el método onStop() de la actividad, anula el registro de la devolución de llamada de captura de pantalla:

   Kotlin

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

   Java

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

Controla la capacidad de tomar capturas de pantalla

Si no quieres que el contenido de la actividad de una app aparezca en capturas de pantalla o en pantallas no seguras, establece la marca de visualización FLAG_SECURE.

Nota: Para brindar transparencia y control del usuario, considera agregar un parámetro de configuración en tu app que permita a los usuarios activar o desactivar esta marca.

Kotlin

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

Java

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