ตรวจจับเมื่อผู้ใช้จับภาพหน้าจอของอุปกรณ์

Android 14 เปิดตัว API การตรวจจับภาพหน้าจอที่รักษาความเป็นส่วนตัวเพื่อสร้างประสบการณ์การใช้งานที่เป็นมาตรฐานมากขึ้นสำหรับการตรวจจับภาพหน้าจอ API นี้ช่วยให้แอปสามารถลงทะเบียน Callback ตามกิจกรรมได้ ระบบจะเรียกใช้ Callback เหล่านี้และแจ้งเตือนผู้ใช้เมื่อผู้ใช้จับภาพหน้าจอขณะที่กิจกรรมนั้นปรากฏอยู่

กรณีการใช้งานที่รองรับ

ใน Android 14, API ของระบบจะตรวจจับภาพหน้าจอเฉพาะเมื่อผู้ใช้กดปุ่มกดร่วมกันบางปุ่มเท่านั้น API จะไม่ตรวจจับภาพหน้าจอที่ถ่ายเมื่อเรียกใช้คำสั่งทดสอบที่เกี่ยวข้องกับภาพหน้าจอ รวมถึง ADB หรือภายในการทดสอบการวัดคุมที่จับภาพเนื้อหาหน้าจอปัจจุบันของอุปกรณ์

ขั้นตอนในการเริ่มต้น

หากต้องการเพิ่มการตรวจจับภาพหน้าจอ ให้ประกาศสิทธิ์ DETECT_SCREEN_CAPTURE ใหม่ในเวลาติดตั้ง

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

จากนั้นทำตามขั้นตอนต่อไปนี้สำหรับกิจกรรมแต่ละอย่างในแอปที่ผู้ใช้อาจจับภาพหน้าจอ

1. ใช้ Callback โดยลบล้างฟังก์ชัน 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. ในเมธอด onStart() ของกิจกรรม ให้ลงทะเบียน Callback ของภาพหน้าจอ

   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() ของกิจกรรม ให้ยกเลิกการลงทะเบียน Callback ของภาพหน้าจอ ดังนี้

   Kotlin

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

   Java

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

ควบคุมความสามารถในการจับภาพหน้าจอ

หากไม่ต้องการให้เนื้อหาของกิจกรรมในแอปปรากฏในภาพหน้าจอหรือบนจอแสดงผลที่ไม่ปลอดภัย ให้ตั้งค่า Flag การแสดงผล FLAG_SECURE

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

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