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

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

Use Case ที่รองรับ

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

   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);