Kullanıcıların cihaz ekran görüntüsü almasını algılama

1. şekil. Kullanıcı, ekran görüntüsü algılama API'sini destekleyen bir uygulamanın ekran görüntüsünü aldığında sistem tarafından sağlanan kısa mesaj örneği.

Android 14, ekran görüntülerinin algılanması için daha standart bir deneyim oluşturmak amacıyla gizliliği korumaya yönelik bir ekran görüntüsü algılama API'si sunar. Bu API, uygulamaların etkinlik bazında geri çağırma işlevleri kaydetmesine olanak tanır. Bu geri çağırmalar, kullanıcı bu etkinlik görünürken ekran görüntüsü aldığında çağrılır ve kullanıcı bilgilendirilir.

Not: Geri arama, gerçek ekran görüntüsünün resmini sağlamaz. Kullanıcı ekran görüntüsü aldığında ekranda ne görüneceğini uygulamanız belirler.

Desteklenen kullanım alanları

Android 14'te sistem API'si, ekran görüntüsünü yalnızca kullanıcı belirli bir donanım düğmesi kombinasyonuna basarsa algılar. API, ADB dahil olmak üzere ekran görüntüleriyle ilgili test komutları çalıştırılırken veya cihazın mevcut ekran içeriklerini yakalayan enstrümantasyon testlerinde alınan ekran görüntülerini algılamaz.

Uygulama adımları

Ekran görüntüsü algılama özelliğini eklemek için yeni DETECT_SCREEN_CAPTURE yükleme zamanı iznini bildirin:

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

Ardından, uygulamanızda kullanıcıların ekran görüntüsü alabileceği her etkinlik için aşağıdaki adımları tamamlayın:

1. onScreenCapture() işlevini geçersiz kılarak bir geri çağırma işlevi uygulayın. Bu geri çağırmada uygulamanız, başka bir kullanıcıyı mesajlaşma görüşmesinin ekran görüntüsünü alan biri olduğu konusunda uyarmak gibi işlemler yapabilir.

   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. Etkinliğin onStart() yönteminde, ekran görüntüsü geri çağırmasını kaydedin.

   Not: Her ekran görüntüsü algılama sinyaliyle birlikte bir bildirim gösterildiğinden, geliştiriciler, ekran görüntüsü algılama API'lerini kullanan bir etkinliğe başlarken kullanıcıya bağlam içi bildirimler sağlamalıdır. Böylece sistem bildirimi kullanıcıları şaşırtmaz.

   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. Etkinliğin onStop() yönteminde ekran görüntüsü geri çağırmasını kayıttan kaldırın:

   Kotlin

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

   Java

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

Ekran görüntüsü alma özelliğini kontrol etme

Bir uygulamanın etkinlik içeriğinin ekran görüntülerinde veya güvenli olmayan ekranlarda görünmesini istemiyorsanız FLAG_SECURE görüntüleme işaretini ayarlayın.

Not: Şeffaflık ve kullanıcı kontrolü sağlamak için uygulamanıza bu işareti etkinleştirip devre dışı bırakmalarına olanak tanıyan bir ayar ekleyebilirsiniz.

Kotlin

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

Java

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