跳到主要内容

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 会话。

提交规则​

  1. 触发进入有界准入队列。
  2. 扫描边界冻结输入并创建本次调用的独占临时区。
  3. 后台工作线程依次执行事件和视觉流程。
  4. 成功、NG、故障或超时路径必须形成完整输出批次。
  5. 完整批次在后续扫描边界原子提交;取消、过期、输出缺失或执行失败时不写入任何字段。

同一事件在一个视觉程序中最多绑定一个 ACTION。事件代码不得保存跨调用可变状态;需要保持的设备状态应由 PLC 程序管理。

常见诊断​

现象处理
事件名称被拒绝只使用本页列出的五种事件
输出未提交检查所有终态路径是否填写了全部声明输出
循环失败使用常量 for 边界,并保证动态循环能在上限内结束
调用被取消检查截止时间、运行版本切换和资源准入状态
算子调用被拒绝将图像或推理操作放回视觉流程节点,并核对目标运行环境的可用性
推理未完成却当成功不要在 scan 内轮询等待;只读取已提交结果