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

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

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

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

   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 การแสดงผล FLAG_SECURE

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

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