使用MediaProjectionManager实现Android高效截图与分享的最佳实践问询

一、性能优化核心策略 #

• 按需启停，避免长期占用：只在用户触发截图操作时申请MediaProjection权限、创建VirtualDisplay，截图完成后立即释放所有资源（停止投影、关闭ImageReader、释放虚拟显示），不要后台持续持有资源。
• 动态降低截图分辨率：如果业务不需要全高清截图，按比例缩小分辨率（比如乘以0.5-0.8的缩放系数），减少像素数据量。注意VirtualDisplay和ImageReader的宽高要保持一致，避免拉伸变形。
• 优化ImageReader配置：
  • 优先选用ImageFormat.JPEG格式，直接生成压缩后的图像，比RGBA格式节省75%的内存占用；如果需要后续编辑再用RGBA格式。
  • 将maxImages设为1，单次截图只需要缓存一张图像，避免多余内存占用。
• 异步处理截图数据：截图后的编码、保存、分享操作全部放到后台线程（推荐用Coroutine），不要阻塞主线程。比如在ImageReader的回调中仅获取Image对象，立即交给后台处理并关闭Image，避免内存泄漏。
• 复用资源（按需）：如果是短时间内多次截图场景，可以复用VirtualDisplay和ImageReader；但如果间隔时间较长，用完就释放资源更稳妥。

二、潜在限制与注意事项 #

• 权限约束：必须通过用户交互触发MediaProjection权限申请，Android 10+禁止后台启动截图流程；保存或分享截图时，Android 10+需要WRITE_EXTERNAL_STORAGE权限，Android 13+改用READ_MEDIA_IMAGES等细化权限。
• 内容限制：无法截图系统安全界面（锁屏、支付页面）及部分应用的隐私窗口，这些区域会被涂黑处理。
• 性能瓶颈：4K等高分辨率屏幕下，即使缩放仍会产生大量像素数据，建议截图前显示轻量加载提示，避开应用动画、渲染密集的时段。
• 分享兼容性：不同平台对图片大小、格式有要求，比如部分社交平台限制单图大小，需提前做压缩处理；用Intent.ACTION_SEND分享时，必须通过FileProvider生成Uri并授予临时读取权限，否则会触发权限异常。

三、示例代码（分步实现） #

1. 申请MediaProjection权限 #

private const val REQUEST_CODE_SCREEN_CAPTURE = 100

fun triggerScreenshot() {
    val mediaProjectionManager = getSystemService(MEDIA_PROJECTION_SERVICE) as MediaProjectionManager
    val intent = mediaProjectionManager.createScreenCaptureIntent()
    startActivityForResult(intent, REQUEST_CODE_SCREEN_CAPTURE)
}

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_SCREEN_CAPTURE && resultCode == RESULT_OK) {
        data?.let { startScreenshotProcess(resultCode, it) }
    }
}

2. 高效截图核心逻辑 #

private var mediaProjection: MediaProjection? = null
private var virtualDisplay: VirtualDisplay? = null
private var imageReader: ImageReader? = null

private fun startScreenshotProcess(resultCode: Int, data: Intent) {
    val displayMetrics = resources.displayMetrics
    val scale = 0.8f // 缩放系数，按需调整
    val screenWidth = (displayMetrics.widthPixels * scale).toInt()
    val screenHeight = (displayMetrics.heightPixels * scale).toInt()

    // 初始化ImageReader，用JPEG格式减少内存
    imageReader = ImageReader.newInstance(screenWidth, screenHeight, ImageFormat.JPEG, 1)

    mediaProjection = (getSystemService(MEDIA_PROJECTION_SERVICE) as MediaProjectionManager)
        .getMediaProjection(resultCode, data)

    // 创建虚拟显示，绑定ImageReader的Surface
    virtualDisplay = mediaProjection?.createVirtualDisplay(
        "ScreenshotDisplay",
        screenWidth,
        screenHeight,
        displayMetrics.densityDpi,
        DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
        imageReader?.surface,
        null,
        null
    )

    // 设置截图回调，异步处理
    imageReader?.setOnImageAvailableListener({ reader ->
        lifecycleScope.launch(Dispatchers.IO) {
            val image = reader.acquireLatestImage() ?: return@launch
            val screenshotFile = saveImageToLocal(image)
            image.close() // 立即关闭Image，避免内存泄漏

            // 回到主线程发起分享
            launch(Dispatchers.Main) {
                shareScreenshot(screenshotFile)
                releaseAllResources()
            }
        }
    }, null)
}

private fun saveImageToLocal(image: Image): File {
    val buffer = image.planes[0].buffer
    val bytes = ByteArray(buffer.remaining())
    buffer.get(bytes)
    val saveDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES)!!
    val screenshotFile = File(saveDir, "screenshot_${System.currentTimeMillis()}.jpg")
    FileOutputStream(screenshotFile).use { it.write(bytes) }
    return screenshotFile
}

3. 分享截图实现 #

private fun shareScreenshot(file: File) {
    val uri = FileProvider.getUriForFile(
        this,
        "${packageName}.fileprovider",
        file
    )

    val shareIntent = Intent(Intent.ACTION_SEND).apply {
        type = "image/jpeg"
        putExtra(Intent.EXTRA_STREAM, uri)
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    }

    startActivity(Intent.createChooser(shareIntent, "分享截图"))
}

// 释放资源，避免内存泄漏
private fun releaseAllResources() {
    virtualDisplay?.release()
    mediaProjection?.stop()
    imageReader?.close()
    virtualDisplay = null
    mediaProjection = null
    imageReader = null
}

4. 配置FileProvider（AndroidManifest.xml） #

<application ...>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

5. res/xml/file_paths.xml #

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="screenshots" path="Pictures/" />
</paths>

内容的提问来源于stack exchange，提问作者abacaba228