截屏监听：ScreenCaptureCallback

截屏监听：ScreenCaptureCallback

非系统应用是没有办法监听用户截屏操作的，当然开发者有很多奇技淫巧去完成这个需求：ContentObserver监听媒体库、FileObserver监听文件，再对比图像文件名称(一般包含时间命名)、路径(一般包含screenshot等字符)、时间戳等信息过滤截图。

从Android 14即API 34开始，Android提供了一个官方接口ScreenCaptureCallback去实现截屏监听：

/**
     * Interface for observing screen captures of an {@link Activity}.
     */
    public interface ScreenCaptureCallback {
        /**
         * Called when one of the monitored activities is captured.
         * This is not invoked if the activity window
         * has {@link WindowManager.LayoutParams#FLAG_SECURE} set.
         */
        void onScreenCaptured();
    }

需要权限android.permission.DETECT_SCREEN_CAPTURE，作为普通(normal)权限，只需要在AndroidManifest.xml中声明即可，无需动态申请：

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

首先实现ScreenCaptureCallback接口，

@RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    private val screenCaptureCallback = object : Activity.ScreenCaptureCallback {
    
        override fun onScreenCaptured() {
            //截屏时会回调该方法
        }
        
    }

在Activity的onResume()方法中注册监听截屏：

@RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    override fun onResume() {
        super.onResume()
        registerScreenCaptureCallback(mainExecutor, screenCaptureCallback)
    }

注意只能监听当前注册的Activity界面的截屏，只要当前界面不可见，即便发生截屏也不会回调截屏方法onScreenCaptured()。没有给整个应用添加截屏监听的接口，如果需要，可以放到自定义的BaseActivity中，或者通过ActivityLifecycleCallbacks实现全部界面的监听。

相应的注册操作要在onPause()中取消注册截屏监听：

@RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
    override fun onPause() {
        super.onPause()
        unregisterScreenCaptureCallback(screenCaptureCallback)
    }

如果当前界面禁止截屏，不会有该回调通知。只有当前界面发生截屏(成功)操作的时候，会回调onScreenCaptured()方法。看到没，这个方法没有任何参数，只会回调该方法，告诉应用发生了截屏，仅此而已。所以，如果需要获取截屏图像，还是需要额外通过媒体库等途径获取。

该截屏监听只能在Android 14级以上才能使用，需要做好兼容。

相关博客：

        Android截屏监控(已适配Android 14)

        探索智能截屏检测：Android-ScreenshotDetection 库

        Android 14 新 API：直接监听截屏操作，不用再观察媒体文件了