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

已于 2024-04-01 16:00:11 修改
阅读量1k 收藏 10
点赞数 20
分类专栏： Android 文章标签： android gitee kotlin
于 2024-03-27 14:11:38 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43687253/article/details/137075974
版权

GitHub Demo项目链接：https://github.com/DoubleD0721/Screenshot

前瞻

目前Android针对截屏的监控主要有三种方式：

  1. 利用FileObserver监听某个目录中资源的变化
  2. 利用ContentObserver监听全部资源的变化
  3. 直接监听截屏快捷键(由于不同的厂商自定义的原因，使用这种方法进行监听比较困难)

本文主要使用ContentObserver的方式来实现对截屏的监控。

Android 各版本适配

主要针对Android 13及Android 14更新的存储权限进行适配。

在Android 13中，存储权限从原来的READ_EXTERNAL_STORAGE细化成为READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO三种权限，在进行权限判断的时候需要进行版本区分。

在Android 14中，存储权限从Android 13的细化权限中更新成为允许用户选择部分图片资源给应用访问。但是针对截屏增加了一个新的截屏监控权限DETECT_SCREEN_CAPTURE，该权限默认为开且用户无感知，针对用户只给部分权限的情况，我们可以通过该权限来获取用户的截屏动作，尝试一些不依赖截屏文件的操作。

权限状态Android 13及以下机型Android 14及以上机型
有全部相册权限使用媒体库监控实现监控使用媒体库监控实现监控
有部分相册权限无法进行监控使用系统API进行监控(但无法拿到截屏文件)
没有相册权限无法进行监控使用系统API进行监控(但无法拿到截屏文件)

Android 13及以下机型监控

针对Android 13及以下用户，使用监听媒体库方式进行截屏的监控

1. 建立相关截屏媒体库，分别监控内部存储及外部存储

private inner class MediaContentObserver(private val contentUri: Uri, handler: Handler?) : ContentObserver(handler) {
    override fun onChange(selfChange: Boolean, uri: Uri?) {
        // handle screenshot file
    }
}

在合适时机，通过registerActivityLifecycleCallbacks的方法将截屏的开始监控及取消监控注入到每个activity的生命周期中。将开始监控媒体库方法注入每个activity的onResume中，将停止监控注入每个activity的onPause中，保证activity在展示的时候开始监控截屏，在消失的时候结束对截屏的监控。

application.registerActivityLifecycleCallbacks(object : Application.ActivityLifecycleCallbacks {
    override fun onActivityResumed(activity: Activity) {
        CoroutineScope(Dispatchers.IO).launch {
            startListen(WeakReference(activity))
        }
    }

    override fun onActivityPaused(activity: Activity) {
        CoroutineScope(Dispatchers.IO).launch {
            stopListen(WeakReference(activity))
        }
    }

    override fun onActivityStarted(activity: Activity) {}

    override fun onActivityStopped(activity: Activity) {}

    override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

    override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

    override fun onActivityDestroyed(activity: Activity) {}

})

如果不希望这样实现，也可以直接将相关能力注入到需要被监控activity的生命周期中，而不是所有的activity。

在对应的生命周期中实现对媒体库的绑定与解绑。

private fun registerObserver(activity: Activity) {
    internalObserver = MediaContentObserver(MediaStore.Images.Media.INTERNAL_CONTENT_URI, uiHandler)
    externalObserver = MediaContentObserver(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, uiHandler)
    startListenTime = System.currentTimeMillis()
    internalObserver?.let {
        activity.applicationContext.contentResolver.registerContentObserver(
            MediaStore.Images.Media.INTERNAL_CONTENT_URI,
            Build.VERSION.SDK_INT > Build.VERSION_CODES.P, it,
        )
    }
    externalObserver?.let {
        activity.applicationContext.contentResolver.registerContentObserver(
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
            Build.VERSION.SDK_INT > Build.VERSION_CODES.P, it,
        )
    }
}

private fun unregisterObserver(activity: Activity) {
    try {
        internalObserver?.let {
            activity.contentResolver.unregisterContentObserver(it)
        }
    } catch (_: Exception) {}
    internalObserver = null

    try {
        externalObserver?.let {
            activity.contentResolver.unregisterContentObserver(it)
        }
    } catch (_: Exception) {}
    externalObserver = null
    startListenTime = 0
}

2. 监听到媒体库变化后，获取最新的文件并判断是否是截屏文件

2.1 获取最新媒体库文件

获取最新文件主要通过contentResolver通过DATE_MODIFIED来倒序获取第一个

private fun getContentResolverCursor(
    contentUri: Uri,
    context: Context,
    maxCount: Int = 1
) = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    val bundle = Bundle().apply {
        putStringArray(ContentResolver.QUERY_ARG_SORT_COLUMNS, arrayOf(MediaStore.Images.ImageColumns.DATE_MODIFIED))
        putInt(ContentResolver.QUERY_ARG_SORT_DIRECTION, ContentResolver.QUERY_SORT_DIRECTION_DESCENDING)
        putInt(ContentResolver.QUERY_ARG_LIMIT, maxCount)
    }
    context.contentResolver.query(
        contentUri,
        MEDIA_PROJECTIONS_API_16,
        bundle,
        null,
    )
} else {
    context.contentResolver.query(
        contentUri,
        MEDIA_PROJECTIONS,
        null,
        null,
        "${MediaStore.Images.ImageColumns.DATE_MODIFIED} desc limit ${maxCount}",
    )
}

其中，针对不同版本的Android机型，获取的字段也做了相应的处理

  • Android 10及以上
val MEDIA_PROJECTIONS_API_16 = arrayOf(
    MediaStore.Images.ImageColumns.DATA,
    MediaStore.Images.ImageColumns.DATE_ADDED,
    MediaStore.Images.ImageColumns.WIDTH,
    MediaStore.Images.ImageColumns.HEIGHT,
)
  • Android 10以下
val MEDIA_PROJECTIONS = arrayOf(
    MediaStore.Images.ImageColumns.DATA,
    MediaStore.Images.ImageColumns.DATE_ADDED,
)
2.2 判断是否为截屏文件

判断是否为截屏文件主要通过以下三个维度来进行判断

  • 路径维度
  • 时间维度
  • 尺寸维度
路径维度

判断获取到的文件路径是否包含screenshot相关字段

private fun isFilePathLegal(filePath: String?): Boolean {
    // File path is not empty
    if (filePath == null || TextUtils.isEmpty(filePath)) {
        return false
    }
    // File path contains screenshot KEYWORDS
    var hasValidScreenShot = false
    val lowerPath = filePath.lowercase(Locale.getDefault())
    for (keyWork: String in KEYWORDS) {
        if (lowerPath.contains(keyWork)) {
            hasValidScreenShot = true
            break
        }
    }

其中的关键字包括：

private val KEYWORDS = arrayOf(
    "screenshot", "screen_shot", "screen-shot", "screen shot",
    "screencapture", "screen_capture", "screen-capture", "screen capture",
    "screencap", "screen_cap", "screen-cap", "screen cap",
)
时间维度

判断文件创建的时间是否晚于开始监听截屏的时间同时文件创建的时间和当前时间相差小于10s

private fun isFileCreationTimeLegal(dateAdded: Long?, startListenTime: Long?) =
        if (dateAdded == null
            || startListenTime == null
            || dateAdded / 1000 < startListenTime / 1000
            || (System.currentTimeMillis() - dateAdded) > MAX_COST_TIME
        ) false else true
尺寸维度

判断获取图片的大小和手机尺寸的大小是否一致

private fun isFileSizeLegal(width: Int?, height: Int?) =
    screenRealSize?.let {
        if (width == null || height == null) {
            false
        } else if (!((width <= it.x && height <= it.y) || (height <= it.x && width <= it.y))) {
            false
        } else {
            true
        }
    } ?: false

下面是获取屏幕尺寸的方法

private fun getRealScreenSize(context: Context): Point? {
    var screenSize: Point? = null
    try {
        screenSize = Point()
        val windowManager = context.getSystemService(Context.WINDOW_SERVICE) as WindowManager
        val defaultDisplay = windowManager.defaultDisplay
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
            defaultDisplay.getRealSize(screenSize)
        } else {
            try {
                val rawWidth = Display::class.java.getMethod("getRawWidth")
                val rawHeight = Display::class.java.getMethod("getRawHeight")
                screenSize.set(
                    (rawWidth.invoke(defaultDisplay) as Int),
                    (rawHeight.invoke(defaultDisplay) as Int),
                )
            } catch (_: Exception) {
                screenSize.set(defaultDisplay.width, defaultDisplay.height)
            }
        }
    } catch (_: Exception) { }
    return screenSize
}

3. 处理截屏文件

当判断为是截屏文件后，对截屏文件进行处理，这里通过一个全局变量的listener来控制监听到截屏后的动作，针对不同的场景对listener做动态的更新。
完整的截屏文件判断流程：

fun handleMediaContentChange(
    contentUri: Uri,
    context: Context?,
    startListenTime: Long?
) {
    CoroutineScope(Dispatchers.IO).launch {
        if (context == null) return@launch
        if (screenRealSize == null) screenRealSize = getRealScreenSize(context)

        var cursor: Cursor? = null

        try {
            cursor = getContentResolverCursor(contentUri, context)
        } catch (_: Exception) { }

        if (cursor == null || !cursor.moveToFirst()) return@launch

        // Get all of colum index
        with(cursor) {
            val dataIndex = getColumnIndex(MediaStore.Images.ImageColumns.DATA) ?: -1
            val dateAddedIndex = getColumnIndex(MediaStore.Images.ImageColumns.DATE_ADDED) ?: -1
            val widthIndex = getColumnIndex(MediaStore.Images.ImageColumns.WIDTH) ?: -1
            val heightIndex = getColumnIndex(MediaStore.Images.ImageColumns.HEIGHT) ?: -1

            // Handle media row data
            // File path
            val filePath = cursor.getScreenShotFilePath(dataIndex)
            if (!isFilePathLegal(filePath)) return@with
            // File Date Added
            val dateAdded = cursor.getScreenShotFileDateAdded(dateAddedIndex)
            if (!isFileCreationTimeLegal(dateAdded, startListenTime)) return@with
            // File Size
            val (width, height) = cursor.getScreenShotFileSize(filePath, widthIndex, heightIndex)
            if (!isFileSizeLegal(width, height)) return@with

            handleScreenShot(filePath)
        }
        if (!cursor.isClosed) cursor.close()
    }
}

Android 14及以上机型

使用系统APIActivity.ScreenCaptureCallback进行监控，但是由于没有全部相册权限获取不到截屏文件的具体路径，所以只能实现一些不依赖路径的动作(如埋点上报等)

1. 声明相关callback

private var screenShotCaptureCallback = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
    Activity.ScreenCaptureCallback { 
        // handle screenshot
    }
} else null

2. 注册监听

在activity启动的时候开始对截屏进行监听，在activity消失的时候结束对截屏的监听，时机与使用媒体库监听时机一样

private fun registerCallback(activity: Activity) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        screenShotCaptureCallback?.let { callback ->
            activity.registerScreenCaptureCallback(activity.mainExecutor, callback)
        }
    }
}

private fun unregisterCallback(activity: Activity) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        screenShotCaptureCallback?.let { callback ->
            try {
                activity.unregisterScreenCaptureCallback(callback)
                startListenTime = 0
            } catch (_: IllegalStateException) {}
        }
    }
}
Doub1e_d
关注
  • 20
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Android MediaProjection截屏&录屏-适配Android
09-24
Android MediaProjection截屏&录屏 1、解决Android Q中java.lang.SecurityException: Media projections require a foreground service of type ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION 异常 2、...
Android监听用户的截屏、投屏、录屏行为
最新发布
进击的小怪兽
12-02 4549
探索Android开发中监听用户的截屏+录屏+投屏行为
Android监听截屏
weixin_47933729的博客
06-13 3305
Android系统没有提供默认的截屏事件监听方式，需要开发者自己想办法实现。查看了网上推荐的实现方式，主要是通过内容观察者（ContentObserver）监听媒体数据库的变化，根据内容名称（路径）中是否包含关键字，判断是否为截屏事件。 关键字： 第一步：对ContentResolver添加内、外存储变化监听； 第二步：当内容观察者（ContentObserver）监听到变化时，会调用onChange方法，此时，我们使用ContentResolver去查询最新的一条数据； 需要注意的是，查询外部存储一定要有
Android 监听系统截屏操作
qq_40959750的博客
01-29 1706
在Android App中监听系统截屏功能，没有系统标准的监听器或者api可以调用，需要自己实现。针对这个需求，目前大部分实现方案是监听系统的媒体数据库。
Android 截屏监听（截图分享功能）
weixin_47933729的博客
07-02 4455
一、需求背景如果检测到用户在 app 中有截图行为，那么弹出一个分享提示框，提示用户去分享这个截图。本文主要从三个方面来讲：1、截图检测的具体实现2、截图检测踩到的坑3、截图合成二、截图分享实现1、截图分享实现分为两个部分，首先是截图事件的监听。安卓系统并没有提供 api 来监听系统截图事件，也没有什么广播可以用来监听这类事件，那要怎么解决呢？我们先来看下截图源码。两个类都在目录framework/base/package/SystemUI/src/com/android/systemui/screensh
安卓截屏监听
m0_72345017的博客
10-11 1088
安卓系统并没有提供原生的接口，所以就需要自己去实现。各种定制系统截图方式五花八门，对截图按键的监听并不容易。最通用的方式也就是对图库进行监听，如果在特定时间内增加了符合规则的图片，则判定用户进行了截图操作。当有特殊需求时，例如，某个页面禁止截屏，或者当用户截屏时，提示用户需要意见反馈。就需要用到截屏监听。2.、 截图监听器ScreenShotListenManager。在6.0及以上系统需要动态申请权限。
Android 14 新 API：直接监听截屏操作，不用再观察媒体文件了～
allisonchen的专栏
04-08 4020
监听截屏 API 的使用简单、清晰，以后不需要再通过监听媒体文件的变化等逻辑来迂回实现，采用官方的方式去探测用户的截屏操作并按照文件读写的规范去提取文件。但需要留意 adb、代码、AS 等方式发起的截屏无法通过该 API 监听得到，笔者以为这些不属于用户操作，没有必要纳入到监听范围中。另外，这个监听 API 并不是级别的，每个目标Activity都得注册，所以可以考虑在中完成 API 的注册和注销。相信这个 API 后续亦会扩展到Jetpack当中，届时无论是否升级到了Android 14。
Android截屏截图的几种方法总结
08-30
主要介绍了 Android截屏截图方法汇总（Activity、View、ScrollView、ListView、RecycleView、WebView截屏截图）的相关资料,需要的朋友可以参考下
DialogFragment和AndroidAutoSize 的适配问题
01-09
相关博客：【android学习开源项目之AndroidAutoSize】AndroidAutoSize和DialogFragment的适配 https://blog.csdn.net/ljb568838953/article/details/103906449; 本demo的知识点：1.AndroidAutoSize 的使用(今日...
Android实现全屏截图或长截屏功能
08-27
主要为大家详细介绍了Android实现全屏截图或长截屏功能，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
详解Android截屏事件监听
08-31
本篇文章主要介绍了Android截屏事件监听，Android系统没有直接对截屏事件监听的接口，本文介绍了2种方法，有兴趣的可以了解一下。
android截图事件监听的原理与实现
01-20
Android系统没有对用户截屏行为提供回调的api，所以我们只能走野路子来获取用户是否截屏了。一般大家都会采用如下两种方法 1.监听截屏图片所在目录变化（FileObserver） 2.监听媒体库的变化（ContentObserver）  上面两种方法均不是万能的，需要结合使用才能达到良好的效果，首先看看如何监控目录 在android中，我们可以通过FileObserver来监听目录变化，先来看看如何使用 private static final File DIRECTORY_PICTURES = new File(Environment.getExternalStorageDire
Android 拍照、截图事件监听实现源码
01-08
Android 拍照、截图事件监听实现源码 通过监听media文件夹实现
Android实现屏幕截图并保存截图到指定文件
01-05
Android屏幕截图并保存截取屏幕的图片到指定文件，具体内容如下 注意要添加权限： <uses android:name=android.permission.WRITE_EXTERNAL_STORAGE> 完整代码： package zhangphil.test; import android.app.Activity; import android.content.Context; import android.content.res.Resources; import android.graphics.Bitmap; import android.os
Android截屏SurfaceView黑屏问题的解决办法
08-30
主要为大家详细介绍了Android截屏SurfaceView黑屏问题的解决办法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
Android 14 新 API：直接监听截屏操作，不用再观察媒体文件
chuyouyinghe的专栏
04-19 984
ScreenCaptureCallback 监听截屏 API 的使用简单、清晰，以后不需要再通过监听媒体文件的变化等逻辑来迂回实现，采用官方的方式去探测用户的截屏操作并按照文件读写的规范去提取文件。但需要留意 adb、代码、AS 等方式发起的截屏无法通过该 API 监听得到，笔者以为这些不属于用户操作，没有必要纳入到监听范围中。另外，这个监听 API 并不是 Application 级别的，每个目标 Activity 都得注册，所以可以考虑在 BaseActivity 中完成 API 的注册和注销。
详细讲解安卓截屏监听操作
vchao的博客
05-07 4267
项目中有时会遇到监听用户截屏操作的需求，应用场景也比较丰富。 eg. 1: 某个隐私页面禁止截屏，当发现用户截屏后，删除该截屏文件； eg. 2: 当用户截屏时，可能是需要进行分享，意见反馈等操作，此时进行弹窗提示，方便用户操作（支付宝就有类似功能）。
Android远程监控技术原理及实现
05-19
Android远程监控技术是一种通过网络连接远程监控和控制Android设备的技术。其原理是在Android设备中安装一个监控软件，该软件可以将设备的各种信息（如屏幕截图、应用程序使用情况、系统日志等）以及用户输入（如按键事件、触屏事件等）上传到服务器端，服务器端收集这些信息并进行处理和展示。同时，服务器端也可以向Android设备发送指令，实现远程控制和管理。 具体实现步骤如下： 1. 开发一个Android监控应用程序，该应用程序需要获取设备信息（如屏幕截图、应用程序使用情况、系统日志等）并将其上传到服务器端。 2. 在服务器端开发一个数据处理程序，用于接收并处理Android设备上传的信息，并将其展示在管理后台中。 3. 在管理后台中，通过Web界面实现对Android设备的监控和控制，可以查看设备的实时状态、操作设备、发送指令等。 4. 在应用程序中集成远程控制模块，以便管理员可以通过管理后台向Android设备发送指令，实现远程控制。 需要注意的是，Android远程监控技术需要在设备上安装应用程序，并且需要获得设备的root权限以获取更多的信息和实现更多的控制功能。此外，为了保护用户隐私，应该在监控应用程序中增加相应的安全措施，确保用户数据不被泄露。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值