跳到主要内容

后台屏幕录制

后台录制屏幕区域为视频文件，通过会话 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

    步骤执行出错时的消息

后台屏幕录制

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

使用说明​

本模块与屏幕截图共享基础使用说明；本页上方参数表是当前模块自身的定义。