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

รูปที่ 1 ตัวอย่างข้อความแบบป๊อปอัปที่ระบบให้ไว้ซึ่งปรากฏขึ้นเมื่อผู้ใช้จับภาพหน้าจอของแอปที่รองรับ API การตรวจจับภาพหน้าจอ

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

   หมายเหตุ: เนื่องจากระบบจะแสดงการแจ้งเตือนพร้อมกับสัญญาณการตรวจจับภาพหน้าจอทุกครั้ง นักพัฒนาแอปจึงควรแสดงการแจ้งเตือนในบริบทต่อผู้ใช้เมื่อเริ่มกิจกรรมที่ใช้ 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. ในเมธอด onStop() ของกิจกรรม ให้ยกเลิกการลงทะเบียนการเรียกกลับภาพหน้าจอ ดังนี้

   Kotlin

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

   Java

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

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

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

หมายเหตุ: พิจารณาเพิ่มการตั้งค่าในแอปที่อนุญาตให้ผู้ใช้สลับการตั้งค่านี้เพื่อให้เกิดความโปร่งใสและผู้ใช้สามารถควบคุมได้

Kotlin

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

Java

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