זיהוי מקרים שבהם משתמשים מצלמים צילומי מסך של המכשיר

כדי ליצור חוויה סטנדרטית יותר לזיהוי צילומי מסך, ב-Android 14 מוצג API לזיהוי צילומי מסך ששומר על הפרטיות. ה-API הזה מאפשר לאפליקציות לרשום פונקציות קריאה חוזרת על בסיס כל פעילות. הקריאות החוזרות האלה מופעלות, והמשתמש מקבל הודעה, כשהמשתמש מצלם צילום מסך בזמן שהפעילות הזו גלויה.

תרחישים נתמכים

ב-Android 14, ה-API של המערכת מזהה צילום מסך רק אם המשתמש מבצע שילוב ספציפי של לחיצות על כפתורים פיזיים. ממשק ה-API לא מזהה צילומי מסך שנוצרים כשמריצים פקודות בדיקה שקשורות לצילומי מסך, כולל ADB, או בבדיקות מכשור שמצלמות את התוכן הנוכחי של המסך במכשיר.

שלבי היישום

כדי להוסיף זיהוי של צילומי מסך, צריך להצהיר על הרשאת זמן ההתקנה החדשה DETECT_SCREEN_CAPTURE:

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

לאחר מכן, מבצעים את השלבים הבאים לכל פעילות באפליקציה שבה המשתמשים עשויים לצלם צילומי מסך:

1. כדי להטמיע קריאה חוזרת, מבטלים את ההגדרה של הפונקציה onScreenCapture(). ב-callback הזה, האפליקציה יכולה לבצע פעולות, כמו אזהרת משתמש אחר שמישהו צילם מסך של שיחה.

   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. ב-method onStart() של הפעילות, רושמים את הקריאה החוזרת של צילום המסך.

   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. בשיטה onStop() של הפעילות, מבטלים את הרישום של הקריאה החוזרת של צילום המסך:

   Kotlin

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

   Java

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

שליטה ביכולת ליצור צילומי מסך

אם לא רוצים שהתוכן של הפעילות באפליקציה יופיע בצילומי מסך או במסכים לא מאובטחים, צריך להגדיר את דגל התצוגה FLAG_SECURE.

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

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