跳到主要内容

后台屏幕录制

后台把一块屏幕录成视频文件。用会话 ID 把「开始 / 暂停 / 继续 / 结束」拆到不同步骤。需要框选界面时用 屏幕录制。

当前模块定义​

sys:screenRecording图片处理Action
标准模块
输入 17 · 输出 6 · 枚举 5

输入参数

  • 操作operationEnum必填

    录屏会话操作类型。

    填写 固定输入默认 start
    4 个选项开始录屏、暂停录屏、继续录屏
    开始录屏默认start
    暂停录屏pause
    继续录屏resume
    结束录屏stop
  • 会话 IDsessionIdText可选

    录屏会话标识（GUID）。开始录屏时留空将自动生成；暂停/继续/结束时必须提供。

    填写 输入或变量
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true
  • 录制范围regionTypeEnum必填

    要录制的屏幕区域类型。

    填写 固定输入条件 仅：start默认 fixed_area
    固定区域默认fixed_area
    主屏幕primary_screen
    所有屏幕full_screen
  • 录制区域areaText可选

    固定区域坐标，格式：left,top,right,bottom。默认不包含右边和底边像素。

    填写 输入或变量条件 仅：start, fixed_area
  • 包含右下边像素includeRightBottomBorderBoolean可选

    包含时，0,0,2,2 表示 3×3 区域；否则为 2×2。

    填写 固定输入条件 仅：start, fixed_area默认 true
  • 输出文件路径outputFilePathText可选

    留空时使用 Quicker 临时目录下的时间戳文件名。

    填写 输入或变量条件 仅：start
  • 输出格式outputFormatEnum必填

    录屏输出文件格式。

    填写 固定输入条件 仅：start默认 mp4
    MP4默认mp4
    GIFgif
    AVIavi
  • 导出画质exportQualityEnum必填

    录屏导出画质：标准、高清或原始。

    填写 固定输入条件 仅：start默认 standard
    标准默认standard
    高清high
    原始original
  • 帧率framesPerSecondInteger可选

    录制帧率，将自动规整到 10/15/24/30/60。

    填写 输入或变量条件 仅：start默认 30
  • 显示鼠标光标showCursorBoolean可选

    是否在录制画面中显示鼠标光标。

    填写 固定输入条件 仅：start默认 true
  • 编码策略encodingStrategyEnum必填

    边录边编码：录制时实时生成成品文件，停止后立即可用（需要 QuickerAvCodec）。先录后编码：先录制中间文件，停止后通过 ffmpeg 转码为目标格式，等待时间取决于录制时长和分辨率。

    填写 固定输入条件 仅：start默认 encodeWhileRecording
    实时编码默认encodeWhileRecording
    录制结束后转码recordThenEncode
  • 开始后立即返回returnImmediatelyBoolean可选

    启用后步骤在启动录制后立即成功返回；结束录屏请使用单独的结束步骤。

    填写 固定输入条件 仅：start默认 true
  • 开始前延迟delayInteger可选

    等待多少毫秒后开始录制。

    填写 输入或变量条件 仅：start默认 0
  • 等待编码完成waitForCompletionBoolean可选

    结束录屏时是否等待文件写入完成。

    填写 固定输入条件 仅：stop默认 true
  • 结束后删除会话removeSessionAfterStopBoolean可选

    结束录屏成功后从会话注册表移除。

    填写 固定输入条件 仅：stop默认 true
  • 加入录屏历史addToHistoryBoolean可选

    结束录屏时显式将成品复制到本机录屏历史。后台录屏默认不加入历史。

    填写 固定输入条件 仅：stop默认 false

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 会话 IDsessionIdOutText

    录屏会话标识，供后续暂停/继续/结束步骤使用。

  • 文件路径filePathText

    录制完成的视频文件路径。

  • 录制时长durationSecondsNumber

    录制时长（秒）。

  • 录制区域rectText

    实际录制区域(left,top,right,bottom)。

  • 错误消息errMessageText

    步骤执行出错时的消息

概述​

本模块没有选区 UI。开始录制时指定范围；之后用同一个会话 ID 暂停、继续或结束。界面与历史说明见 截图与贴图概览。

后台屏幕录制

后台录制屏幕区域为视频文件，通过会话 ID 跨步骤控制录制生命周期。
操作
录屏会话操作类型。
会话 ID
 
录屏会话标识（GUID）。开始录屏时留空将自动生成；暂停/继续/结束时必须提供。
录制范围
要录制的屏幕区域类型。
录制区域
 
固定区域坐标，格式：left,top,right,bottom。默认不包含右边和底边像素。
输出文件路径
 
留空时使用 Quicker 临时目录下的时间戳文件名。
输出格式
录屏输出文件格式。
导出画质
录屏导出画质：标准、高清或原始。
帧率
30
录制帧率，将自动规整到 10/15/24/30/60。
编码策略
边录边编码：录制时实时生成成品文件，停止后立即可用（需要 QuickerAvCodec）。先录后编码：先录制中间文件，停止后通过 ffmpeg 转码为目标格式，等待时间取决于录制时长和分辨率。
开始前延迟
0
等待多少毫秒后开始录制。
是否成功
-- 选择变量 --
操作是否成功
会话 ID
-- 选择变量 --
录屏会话标识，供后续暂停/继续/结束步骤使用。
文件路径
-- 选择变量 --
录制完成的视频文件路径。
录制时长
-- 选择变量 --
录制时长（秒）。
录制区域
-- 选择变量 --
实际录制区域(left,top,right,bottom)。
错误消息
-- 选择变量 --
步骤执行出错时的消息
保存(S)取消

参数说明​

操作：开始录屏、暂停录屏、继续录屏、结束录屏。

会话 ID：GUID。开始时留空会自动生成；暂停 / 继续 / 结束时必须填。

失败后停止：失败是否中止动作。默认开启。

仅「开始录屏」：

录制范围：固定区域、主屏幕、所有屏幕。

录制区域：仅固定区域。格式 left,top,right,bottom。默认不包含右边和底边像素。

包含右下边像素：仅固定区域。打开时 0,0,2,2 是 3×3；关闭时是 2×2。默认开启。

输出文件路径：留空则写到 Quicker 临时目录，文件名带时间戳。

输出格式：MP4、GIF、AVI。

导出画质：标准、高清、原始。

帧率：会规整到 10 / 15 / 24 / 30 / 60。默认 30。

显示鼠标光标：画面里是否画出鼠标。默认开启。

编码策略：实时编码（停录后立即可用，需要 QuickerAvCodec）；或录制结束后再转码（停录后要等 ffmpeg）。

开始后立即返回：打开后本步骤启动录制就成功返回；结束请另写一步。默认开启。

开始前延迟：等多少毫秒再开录。

仅「结束录屏」：

等待编码完成：是否等文件写完。默认开启。

结束后删除会话：成功结束后从会话表里删掉。默认开启。

加入录屏历史：是否把成品复制到本机录屏历史。后台录屏默认不加入。

输出​

  • 是否成功：本步是否成功。
  • 会话 ID：给后续暂停 / 继续 / 结束用。
  • 文件路径：录完后的视频路径。
  • 录制时长：秒。
  • 录制区域：实际录到的范围，格式 left,top,right,bottom。
  • 错误消息：失败时的说明。

相关链接​

屏幕录制弹出选区界面，可视化开录、停录。屏幕截图只要一张静图，不用录视频。截图与贴图概览录屏历史与相关功能入口。