截图
调起 lingtools 的截图界面:用户框选区域、标注,确认后插件拿到图片;也可以长截图和录屏。需要 screen 权限。
captureScreen
ts
captureScreen(options?: CaptureScreenOptions): Promise<CaptureScreenResult>
captureScreen(callback: (result) => void, options?: CaptureScreenOptions): Promise<CaptureScreenResult>ts
const result = await window.ling.captureScreen({
tools: ['rectangle', 'lineArrow', 'mosaic', 'text', 'confirm'],
image: { format: 'png' },
})
if (result.success && result.mimeType !== 'video/mp4') {
img.src = result.data // data:image/png;base64,…
} else if (!result.success && result.code !== 'cancelled') {
ElMessage.error(result.message)
}调用时 lingtools 先隐藏自己的窗口,冻结所有显示器的画面,用户框选(可以识别窗口、跨显示器)并标注,确认后返回。
选项
| 选项 | 说明 |
|---|---|
tools | 工具栏显示的工具及顺序,必须包含 confirm。可选:move、rectangle(矩形)、lineArrow(箭头)、mosaic(马赛克)、text(文字)、scrollCapture(长截图)、record(录屏)、confirm(确认)。默认为全部 |
defaultTool | 默认选中的编辑工具 |
image.format | 'png'(默认)或 'jpeg' |
image.quality | JPEG 质量 1–100,默认 90 |
record.audio | 录屏的声音:'none'(默认)、'microphone'、'system'、'both' |
record.maxDuration | 录屏最长秒数,到时自动停止;默认不限 |
restoreWindow | 结束后恢复插件窗口并还焦点,默认 true |
copyToClipboard | 同时把图片复制到剪贴板,默认 false |
结果
不会因为用户取消而 reject,而是返回 success: false:
| 结果 | 字段 |
|---|---|
| 截图成功 | { success: true, mimeType: 'image/png' | 'image/jpeg', data, width, height },data 为 Data URL |
| 录屏成功 | { success: true, mimeType: 'video/mp4', filePath, width, height, duration },文件在插件的临时目录里,要保留请自己复制走 |
| 没有结果 | { success: false, code, message },code:cancelled 用户取消、capture_failed 捕获失败(含选区过大)、busy 已有截图或取色在进行、aborted 插件被关闭 |
以下情况才 reject:参数不合法(invalid_params)、macOS 没有屏幕录制权限(permission_denied)、在搜索卡片里调用(forbidden)。
说明
- 图片尺寸为实际像素:单屏选区按该屏的物理像素;跨缩放比例不同的屏时按其中最高的缩放比例。
- 长截图:用户在选区里向下滚动内容,lingtools 自动拼接,结束后可以继续标注。只能在单个屏幕内的选区里使用。
- 录屏:30 fps、带鼠标指针,输出 H.264 的 MP4(有声音时为 AAC);停止后先预览再确认。选择录麦克风时,用户点「开始录制」才申请麦克风权限。
- macOS 需要「屏幕录制」权限,第一次会弹系统授权框,授权后要重启 lingtools。