Skip to content

截图 ​

调起 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.qualityJPEG 质量 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。