检测用户何时截取设备屏幕截图

איור 1. דוגמה להודעת הטוסט שמופיעה מהמערכת כשהמשתמש מצלם מסך של אפליקציה שתומכת ב-API לזיהוי צילומי מסך.

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

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

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

ב-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. ב-method‏ 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)
   }
   

   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. ב-method‏ 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);