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

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

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

Not: Geri arama, gerçek ekran görüntüsünün bir görüntüsünü sağlamaz. Kullanıcı ekran görüntüsü aldığında ekranda nelerin göründüğünü belirlemek uygulamanıza bağlıdır.

Desteklenen kullanım alanları

Android 14'te sistem API'si, yalnızca kullanıcı donanım düğmesine belirli bir sayıda bastığında ekran görüntüsü algılar. API, ekran görüntüleriyle ilgili test komutlarını (ADB dahil) veya cihazın mevcut ekran içeriklerini yakalayan araç testlerini çalıştırırken 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 belirtin:

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

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

1. onScreenCapture() işlevini geçersiz kılarak bir geri çağırma uygulayın. Bu geri çağırma sırasında uygulamanız işlem yapabilir (ör. başka bir kullanıcıyı bir mesajlaşma görüşmesinin ekran görüntüsünü aldığını konusunda uyarabilir).

   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ği için geliştiriciler, ekran görüntüsü algılama API'leri kullanan bir etkinlik başlatırken kullanıcıya bağlam içi bildirimler sunmalı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ın kaydını silin:

   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 uygulama etkinliği içeriğinin ekran görüntülerinde veya güvenli olmayan ekranlarda görünmesini istemiyorsanız FLAG_SECURE görüntü işaretini ayarlayın.

Not: Şeffaflık ve kullanıcı kontrolü sağlamak için uygulamanıza, kullanıcıların bu işareti etkinleştirmesine veya devre dışı bırakması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);