ACTION 事件
ACTION 是视觉程序中的有界事件代码。当前运行时只提供五种事件;代码可计算标量并填写已声明输出,但不能直接访问设备、文件、网络或过程映像。
ACTION 使用视觉 SCL 编写。旧 C# 风格 Vision Script 不是视觉 SCL,不得作为新运行合同。
当前事件
| 事件 | 触发时机 | 当前状态 |
|---|---|---|
| OnTrigger | 作业通过准入、开始采集前 | 可用 |
| OnFrame | 真实图像帧形成后、推理前;每次调用恰好一次 | 可用 |
| OnInferenceCompleted | 推理成功并得到有限数值结果后 | 可用 |
| OnFault | 相机、图像流程或推理发生非超时故障 | 可用 |
| OnTimeout | 作业超过截止时间 | 可用 |
OnAcquisitionCompleted、OnPreprocessingCompleted、OnResultValidated、OnValidationFailed、OnQualityFail、OnResourceWarning 和 OnStateChanged 不是当前公开事件,不能写入项目。
OnInferenceCompleted 在后台作业线程触发。PLC scan 不会停下来等待该事件;完整输出仍在后续扫描边界提交。
ACTION 可以做什么
- 读取作业提交时冻结的输入快照。
- 使用
bool、整数和浮点标量进行赋值、比较和算术运算。 - 使用
if/else if/else、switch、常量边界for,以及有运行上限的while和repeat。 - 读取推理状态、合格判定和缺陷坐标这四个只读运行结果。
- 写入项目中明确声明的输出;结果只在后续扫描边界整批提交。
动态循环最多执行 1024 次。语句数、临时内存和执行时间也受预算限制;超限会让本次作业失败,不会截断后假装成功。
当前不提供的动作
以下能力不是 ACTION API:保存图像、发送邮件或短信、切换相机、启动另一视觉程序、清理缓存、直接触发 PLC 中断、直接调用通信协议、训练模型或在运行时加载模型。
图像处理和推理应放在视觉流程节点中;报警、HMI 通知和设备动作应由 PLC 逻辑根据已提交结果执行。部分关键字虽然可被编辑器识别,但尚无生产执行路由,不能作为可用功能使用。
视觉 SCL 示例
下例中的 ResultOk、ResultX 和 ResultY 已在项目中声明为输出。成功、故障和超时路径都填写完整输出,避免产生半批结果。
class InspectDecision
{
bool ResultOk;
float ResultX;
float ResultY;
public void OnInferenceCompleted()
{
ResultOk = VisionInferenceSucceeded && VisionInferencePass;
if (ResultOk)
{
ResultX = (float)VisionDefectX;
ResultY = (float)VisionDefectY;
}
else
{
ResultX = 0.0f;
ResultY = 0.0f;
}
}
public void OnFault()
{
ResultOk = false;
ResultX = 0.0f;
ResultY = 0.0f;
}
public void OnTimeout()
{
ResultOk = false;
ResultX = 0.0f;
ResultY = 0.0f;
}
}
该示例只整理已返回的推理标量。模型由 Darra AI Studio 导出,现场只消费已准备的 inference-only 会话。
提交规则
- 触发进入有界准入队列。
- 扫描边界冻结输入并创建本次调用的独占临时区。
- 后台工作线程依次执行事件和视觉流程。
- 成功、NG、故障或超时路径必须形成完整输出批次。
- 完整批次在后续扫描边界原子提交;取消、过期、输出缺失或执行失败时不写入任何字段。
同一事件在一个视觉程序中最多绑定一个 ACTION。事件代码不得保存跨调用可变状态;需要保持的设备状态应由 PLC 程序管理。
常见诊断
| 现象 | 处理 |
|---|---|
| 事件名称被拒绝 | 只使用本页列出的五种事件 |
| 输出未提交 | 检查所有终态路径是否填写了全部声明输出 |
| 循环失败 | 使用常量 for 边界,并保证动态循环能在上限内结束 |
| 调用被取消 | 检查截止时间、运行版本切换和资源准入状态 |
| 算子调用被拒绝 | 将图像或推理操作放回视觉流程节点,并核对目标运行环境的可用性 |
| 推理未完成却当成功 | 不要在 scan 内轮询等待;只读取已提交结果 |