captureDisplay

abstract fun captureDisplay(displayId: Int, outputPath: String)

捕获指定屏幕并保存为图像文件。

该方法会截取指定屏幕的完整内容,并保存到指定路径。如果目标文件已存在, 会先删除原有文件再写入新内容。适用于获取当前屏幕状态作为操作依据或证据。

Parameters

displayId

屏幕标识符: - 0 表示物理屏幕的镜像 - 其他值表示对应的虚拟屏幕

outputPath

图像保存路径,需包含文件名及扩展名(如 "/sdcard/screen.png")

Throws

当应用缺乏屏幕截图权限或文件写入权限时抛出

当输出路径无效或屏幕ID不存在时抛出