动作流程控制-辅助动作

辅助动作

动作流程控制 / 辅助动作 类动作。

打印

log

动作流程控制辅助动作

用途:在日志区记录一条消息。

写法:打印 内容=<内容>

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

打印 内容="你好,世界"

# 说明:输出一条简单日志

错误示例

打印

为什么错:漏写了必填参数:内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
内容message未提供说明

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

记录日志

record_log

动作流程控制辅助动作

用途:记录一条日志消息。

写法:记录日志 日志内容=<日志内容>

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

记录日志 日志内容="示例内容"

错误示例

记录日志

为什么错:漏写了必填参数:日志内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
日志内容content未提供说明

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

播放声音

play_sound

动作流程控制辅助动作

用途:播放 wav、系统提示音,或按频率发蜂鸣声。

写法:播放声音 声音内容=<声音内容> [蜂鸣时长毫秒=<蜂鸣时长毫秒>]

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

播放声音 声音内容="示例内容" 蜂鸣时长毫秒=1

错误示例

播放声音 蜂鸣时长毫秒=1

为什么错:漏写了必填参数:声音内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
声音内容sound可填 wav 文件路径、蜂鸣频率数字,或任意文本触发系统默认提示音。
蜂鸣时长毫秒duration当声音是蜂鸣频率数字时,表示响多久,单位毫秒;不填时默认 180。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

显示大字提示

open_execution_lyric_overlay

动作流程控制辅助动作

用途:显示执行时的大字提示层,并设置提示文本。

写法:显示大字提示 提示文本=<提示文本> [文字颜色=<文字颜色>] [字体=<字体>] [字号=<字号>] [字重=<字重>] [位置百分比=<位置百分比>]

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

显示大字提示 提示文本="示例值" 文字颜色="示例值"

错误示例

显示大字提示 文字颜色="示例值"

为什么错:漏写了必填参数:提示文本。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
提示文本text要显示在大字提示层中的主提示文字。
文字颜色text_color可选;主提示文字颜色,例如 #ffd84a。
字体font_family可选;主提示文字字体名。
字号font_size可选;主提示文字字号。
字重font_weight可选;主提示文字字重,例如 400、700、900。
位置百分比position_percent可选;提示框中心点百分比坐标,格式 x,y,例如 50,50。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。