사용자가 기기 스크린샷을 찍을 때 감지

그림 1. 사용자가 스크린샷 감지 API를 지원하는 앱의 스크린샷을 찍을 때 표시되는 시스템 제공 토스트 메시지 예시

스크린샷 감지를 위한 보다 표준화된 환경을 만들기 위해 Android 14에서는 개인 정보 보호 스크린샷 감지 API를 도입했습니다. 이 API를 사용하면 앱에서 활동별로 콜백을 등록할 수 있습니다. 활동이 표시되는 동안 사용자가 스크린샷을 찍으면 이러한 콜백이 호출되고 사용자에게 알림이 전송됩니다.

참고: 콜백은 실제 스크린샷 이미지를 제공하지 않습니다. 사용자가 스크린샷을 찍을 때 화면에 표시된 내용은 앱에서 결정합니다.

지원되는 사용 사례

Android 14에서 시스템 API는 사용자가 하드웨어 버튼을 특정 조합으로 누르는 경우에만 스크린샷을 감지합니다. 이 API는 ADB 등 스크린샷과 관련된 테스트 명령어를 실행할 때 또는 기기의 현재 화면 콘텐츠를 캡처하는 계측 테스트 내에서 찍은 스크린샷을 감지하지 않습니다.

구현 단계

스크린샷 감지를 추가하려면 새 DETECT_SCREEN_CAPTURE 설치 시간 권한을 선언합니다.

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

그런 다음 사용자가 스크린샷을 캡처할 수 있는 앱의 각 활동에 다음 단계를 완료합니다.

1. onScreenCapture() 함수를 재정의하여 콜백을 구현합니다. 이 콜백에서는 앱이 다른 사용자에게 누군가 메시지 대화의 스크린샷을 촬영했음을 알리는 등의 조치를 취할 수 있습니다.

   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. 활동의 onStart() 메서드에서 스크린샷 콜백을 등록합니다.

   참고: 모든 스크린샷 감지 신호와 함께 알림이 표시되는 점을 감안할 때 개발자는 사용자가 스크린샷 감지 API를 사용하는 활동을 시작할 때 컨텍스트 내 알림을 사용자에게 제공하여 사용자가 시스템 알림에 놀라지 않도록 해야 합니다.

   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)
   }

   자바

   @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. 활동의 onStop() 메서드에서 스크린샷 콜백을 등록 취소합니다.

   Kotlin

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

   Java

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

스크린샷 캡처 기능 제어

앱 활동의 콘텐츠가 스크린샷이나 비보안 디스플레이에 표시되지 않게 하려면 FLAG_SECURE 디스플레이 플래그를 설정하세요.

참고: 투명성과 사용자 제어를 제공하려면 사용자가 이 플래그를 전환할 수 있는 설정을 앱에 추가해 보세요.

Kotlin

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

Java

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