截屏监听:ScreenCaptureCallback

Quibbler 20天前 89

截屏监听: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() {
            //截屏时会回调该方法
        }
        
    }


        在ActivityonResume()方法中注册监听截屏:

    @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:直接监听截屏操作,不用再观察媒体文件了

        

不忘初心的阿甘
最新回复 (0)
    • 安卓笔记本
      2
        登录 注册 QQ
返回
仅供学习交流,切勿用于商业用途。如有错误欢迎指出:fluent0418@gmail.com