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