1. 先搞清楚 VisionPro 串流到底解决了什么问题如果你在工业视觉或者自动化检测领域工作听到“VisionPro”和“串流”这两个词第一反应可能是把相机图像实时传到电脑上处理。但这里有个关键点需要先明确我们讨论的“原生串流”核心不是解决“图像怎么传进来”而是解决“处理结果和中间数据怎么高效、低延迟地送出去”。很多刚接触 VisionPro 二次开发的朋友容易把精力全花在图像采集和算法工具链上觉得只要模板匹配、卡尺测量、Blob分析这些工具跑通了任务就完成了。等到项目真正要上线需要把检测结果比如坐标、角度、NG/OK判断实时发送给PLC、机械臂或者MES系统时才发现卡壳了。用传统的文件读写、共享内存或者简单的TCP发送在高速、连续的生产节拍下要么延迟大要么丢数据要么稳定性堪忧。VisionPro 的原生串流功能就是针对这个痛点设计的。它不是一个外挂工具而是深度集成在 VisionPro 框架内的数据通道。你可以把它理解为一个专为视觉检测结果打造的高速数据总线。它的“神奇”之处在于你可以在 VisionPro 的作业Job内部直接配置将某个工具的输出结果比如 CogPMAlignTool 的GetPose()坐标、CogCaliperTool 的边缘位置绑定到串流输出上。当作业运行时这些结果会自动、实时地通过以太网发送到指定的网络端点几乎不需要你在脚本里写复杂的网络通信代码。这适合谁看如果你是正在做 VisionPro 二次开发需要将检测结果集成到自动化产线。被现场各种通信协议如TCP/IP、UDP、Profinet等对接搞得头疼。想要提升系统响应速度降低从“拍到结果”到“执行动作”的延迟。希望检测任务和结果发送任务解耦让系统更稳定。那么VisionPro 的原生串流就是你接下来最该仔细研究的部分。它能让你的视觉系统从“能检测”升级到“能高效协同”。2. 运行前必须确认的环境与前置条件在兴奋地开始配置串流之前得先把“地基”打好。很多串流测试失败问题都出在环境配置这一步而不是串流本身。2.1 软件与授权准备首先VisionPro 的串流功能不是所有版本都默认包含的。你需要确认你的 VisionPro 许可证License是否包含了VisionPro® Communications或相应的网络通信模块。通常商业版或开发版会包含但一些精简版可能没有。最直接的验证方法是打开 VisionPro QuickBuild在工具箱里搜索“Stream”看能否找到CogStream相关的工具。其次确保你的开发环境是完整的。我一般会按这个顺序检查VisionPro 主版本如 VisionPro 9.x, 10.x。不同大版本间接口可能有差异你的代码和配置要对应。.NET FrameworkVisionPro 开发主要基于 .NET。确认你的 Visual Studio 项目引用了正确的Cognex.VisionPro.dll和Cognex.VisionPro.Comm.dll如果串流功能在独立程序集里。脚本权限如果你计划在 QuickBuild 的脚本工具里调用串流确保脚本执行策略没有问题。2.2 网络环境与硬件配置串流对网络环境比较敏感在办公室随便接接可能没问题上了车间就可能状况百出。网络拓扑视觉控制器运行VisionPro的工控机和目标设备如PLC、上位机最好在同一个局域网段避免跨路由器或复杂网络。直连或者通过交换机连接是最佳选择。IP与防火墙给工控机设置一个固定的IP地址而不是动态获取。关闭Windows防火墙或者为VisionPro应用和端口添加出入站规则。这是最容易被忽略的坑常常表现为“本机测试正常一联外部设备就超时”。网卡与性能对于高速应用节拍100ms建议使用千兆或更高速率的工业网卡。在设备管理器中禁用不必要的网络适配器防止网络流量被错误路由。目标端准备你需要知道接收端设备的IP地址和端口号。并且你需要在接收端准备好一个简单的测试程序来监听端口、接收数据并打印出来。不要一开始就想着直接连PLC先用一个网络调试助手如 TCP/UDP Socket调试工具验证数据能发出来格式正确。2.3 VisionPro 项目基础你的 VisionPro 作业Job本身应该是能稳定运行的。这意味着图像采集无论是来自相机、图像文件还是模拟器是稳定的。你的核心检测工具链如九点标定、模板匹配、卡尺工具已经调试完毕能输出正确的结果。你清楚需要发送哪些数据。例如是发送模板匹配的TranslationX和TranslationY还是发送一个包含多个测量值的自定义结构体。先把检测功能跑稳再叠加串流是最高效的排查顺序。3. 从零开始配置一个基础的串流任务这里我们以最常见的 TCP 协议为例演示如何在 VisionPro QuickBuild 中配置一个将模板匹配坐标发送出去的串流任务。我会假设你已经有一个能正常进行模板匹配的作业。3.1 在 QuickBuild 中添加并配置 Stream 工具打开你的 VisionPro 作业.vpp 文件。在工具箱中搜索“Stream”将CogStream工具拖放到作业编辑区。它通常位于“通信”或“高级”分类下。选中CogStream工具在属性面板中进行配置Protocol选择TcpClient如果你的接收端是服务器或TcpServer如果你的VisionPro作为服务器。初学者建议先让 VisionPro 作为TcpClient去连接一个固定的服务器如网络调试助手。RemoteHostName填写接收端服务器的IP地址例如192.168.1.100。RemotePort填写接收端服务器监听的端口号例如8080。ConnectionTimeout和SendTimeout可以先用默认值如果出现连接或发送超时再调整。配置连接行为在属性中找到AutoConnect选项。如果设为True作业启动时会自动尝试连接如果设为False你需要在脚本中手动调用Connect()方法。初期测试建议设为True。3.2 将检测结果绑定到 Stream这是串流的核心——告诉 VisionPro 你要发送什么数据。在CogStream工具的属性中找到Outputs集合点击编辑…按钮。在弹出的“集合编辑器”中点击“添加”来创建一个新的输出项。为这个输出项设置关键属性Name起一个有意义的名字如Send_MatchPosition。Value这里就是绑定数据源的地方。点击Value属性旁的“…”按钮会弹出“表达式编辑器”。链接数据在表达式编辑器中你可以浏览到当前作业中所有工具的输出。找到你的模板匹配工具例如CogPMAlignTool1展开其输出选择你想要发送的属性例如Results[0].GetPose().TranslationX。这样就把X坐标绑定到了这个串流输出上。重复步骤2-3可以添加多个输出项分别绑定Y坐标、角度、匹配分数等。配置Message属性可选但重要Message定义了数据的封装格式。你可以使用类似“X:{0}, Y:{1}”的格式化字符串其中{0}、{1}会依次被Outputs集合中各项的Value替换。这样接收端收到的就是一条完整的、可读的字符串。你也可以设置为发送JSON格式如“{“x”: {0}, “y”: {1}}”方便上位机解析。3.3 编写脚本控制发送时机默认情况下CogStream工具会在其被作业执行后自动发送绑定的数据。但有时我们需要更精细的控制比如只在匹配成功时发送或者累积几次结果再发送。这就需要用到脚本。在作业中插入一个“脚本”工具CogScript位置可以在CogStream工具之前或之后取决于你的逻辑。一个典型的发送脚本可能长这样C# 示例// 假设你的 CogStream 工具实例名是 CogStream1 // 假设你的模板匹配工具实例名是 CogPMAlignTool1 // 获取模板匹配结果 CogPMAlignResults results CogPMAlignTool1.Results; if (results ! null results.Count 0) { // 检查匹配分数例如大于0.8认为匹配成功 if (results[0].Score 0.8) { // 方法1如果CogStream的AutoSend为True工具执行后会自动发送。 // 我们只需要确保它已连接。 if (!CogStream1.Connected) { CogStream1.Connect(); } // 脚本执行到这里后续的CogStream工具会自动执行并发送数据。 // 方法2如果CogStream的AutoSend为False则需要手动发送。 // CogStream1.Send(); } else { // 匹配失败可以发送一个特定的错误码或什么都不做 // 例如CogStream1.Message “Match Failed”; // CogStream1.Send(); } } else { // 没有结果处理异常情况 }关键点脚本工具和CogStream工具在作业中的执行顺序决定了数据绑定的时机和发送的时机。通常顺序是图像采集 - 图像处理/检测工具 - 脚本处理逻辑-CogStream发送数据。3.4 运行测试与验证启动接收端首先在你的接收端电脑上打开网络调试助手创建一个TCP服务器监听你在CogStream中配置的端口如8080。运行VisionPro作业在QuickBuild中运行你的作业。观察CogStream工具的运行时状态看是否显示“已连接”Connected。触发图像处理给视觉系统提供一张包含待测目标的图像。查看接收数据在网络调试助手的接收区你应该能看到按照Message格式发送过来的字符串例如“X:125.34, Y:87.56”。验证数据正确性对比网络调试助手收到的数据和VisionPro界面中模板匹配工具显示的结果是否一致。走到这一步一个最基本的单向串流发送就通了。但这只是开始真正的挑战在于让它稳定、可靠地工作在产线上。4. 深入核心脚本编写与高级数据获取当基础串流跑通后你会很快遇到更复杂的需求发送自定义格式的数据、打包多个工具的结果、或者根据复杂条件决定发送内容。这时就必须深入脚本编写了。4.1 在脚本中动态构建发送数据前面我们在CogStream的Outputs里静态绑定了数据。但在脚本里我们可以更灵活地操作CogStream对象。// 访问CogStream工具 CogStream myStream (CogStream)Job.GetTool(“CogStream1”); // 假设我们有多个检测工具的结果 CogPMAlignResults matchResult CogPMAlignTool1.Results; CogCaliperTool myCaliper (CogCaliperTool)Job.GetTool(“CogCaliperTool1”); CogCaliperResults caliperResult myCaliper.Results; // 构建一个复杂的JSON字符串 string jsonData “{”; if (matchResult ! null matchResult.Count 0) { jsonData $“\”matchX\”: {matchResult[0].GetPose().TranslationX},”; jsonData $“\”matchY\”: {matchResult[0].GetPose().TranslationY},”; jsonData $“\”matchScore\”: {matchResult[0].Score},”; } if (caliperResult ! null caliperResult.Count 0) { // 假设我们取第一个边缘对的位置 if (caliperResult.EdgePairs ! null caliperResult.EdgePairs.Count 0) { jsonData $“\”edgePosition\”: {caliperResult.EdgePairs[0].Center},”; } } // 移除最后一个多余的逗号 if (jsonData.EndsWith(“,”)) jsonData jsonData.TrimEnd(‘,’); jsonData “}”; // 将构建好的字符串设置为要发送的消息 myStream.Message jsonData; // 确保连接并发送 if (!myStream.Connected) { myStream.Connect(); } myStream.Send();这种方式特别适合需要将多个工具的检测结果打包成一个结构化消息如JSON、XML发送给MES或数据库的场景。4.2 获取并处理复杂的视觉工具结果VisionPro 工具的结果对象往往层次很深在脚本中正确获取是关键。模板匹配 (CogPMAlignTool)最常用的是Results[0].GetPose()它返回一个CogTransform2DLinear对象包含TranslationX,TranslationY,Rotation等。Results[0].Score是匹配分数。卡尺工具 (CogCaliperTool)结果在CogCaliperTool.Results中里面包含找到的EdgePairs边缘对集合。每个EdgePairs有Center中心位置、Width宽度等属性。你需要根据卡尺的投影和搜索方向来理解这些数据的含义。九点标定 (CogCalibNPointToNPoint)标定后你会得到一个Calibrated的坐标系。在脚本中你可以通过UncalibratedPoint和CalibratedPoint的转换将像素坐标转换为物理坐标毫米这个物理坐标才是串流给机械臂最常用的数据。Blob分析 (CogBlobTool)结果包含多个Blobs每个Blob有CenterOfMassX/Y,Area,Perimeter等。你需要遍历集合并可能根据面积、位置进行筛选。一个常见的坑是空引用。在脚本中访问任何工具的Results属性前务必检查其是否为null以及Count是否大于0。否则作业运行时很容易因未处理异常而中断。4.3 错误处理与日志记录生产环境下的串流脚本必须健壮。至少要做以下处理try { // … 你的数据准备和发送逻辑 … myStream.Send(); } catch (System.Net.Sockets.SocketException sockEx) { // 网络异常连接失败、发送超时 CogSysLog.Error(“Stream Send Failed (Network): “ sockEx.Message); // 可以尝试重连或记录错误计数 myStream.Disconnect(); System.Threading.Thread.Sleep(100); // myStream.Connect(); // 谨慎使用自动重连避免死循环 } catch (Cognex.VisionPro.Exception cogEx) { // VisionPro 相关异常 CogSysLog.Error(“Stream Send Failed (VisionPro): “ cogEx.Message); } catch (Exception ex) { // 其他未知异常 CogSysLog.Error(“Stream Send Failed (General): “ ex.Message); }使用CogSysLog将错误信息记录到 VisionPro 的系统日志便于后期排查。同时考虑在发送失败时是重试、跳过还是触发报警这需要根据具体的生产节拍和工艺要求来定。5. 性能调优与生产环境避坑指南当你的串流功能在实验室跑通后准备上产线前下面这些经验能帮你避开大部分坑。5.1 网络延迟与稳定性优化减少数据量只发送必要的数据。不要为了省事把整个图像或所有中间结果都塞进串流。只发送最终判决OK/NG和关键坐标。如果必须发送图像考虑压缩如JPEG或降低分辨率。选择合适协议TCP可靠保证数据顺序和送达但有连接开销适合对可靠性要求极高的指令和关键数据。UDP无连接速度快延迟低但可能丢包、乱序。适合高频、可容忍少量丢失的实时状态数据如连续坐标流。VisionPro 的CogStream也支持 UDP。生产环境建议关键指令如“触发拍照”、“结果OK”用TCP高频实时数据如机器人引导的连续坐标可评估使用UDP并在应用层增加简单的序列号和校验。调整超时与缓冲在CogStream属性中适当调整SendTimeout和ReceiveBufferSize。对于高速应用超时时间不宜设得太长否则一次发送卡顿会阻塞整个作业。缓冲区大小要根据数据包大小设置太小会导致频繁发送太大可能增加延迟。网络隔离视觉系统所在的网段尽量与办公网络、互联网隔离减少广播风暴和无关流量干扰。5.2 VisionPro 作业内部的优化发送频率与节拍匹配你的串流发送频率必须和产线节拍匹配。不要在作业的每一帧都发送而是只在真正有检测结果需要上报时发送。利用脚本条件判断。避免在串流工具上做复杂计算CogStream的Message格式化或Outputs的表达式如果太复杂会增加发送前的准备时间。尽量在之前的脚本工具中完成数据计算和格式化然后将格式化好的字符串直接赋给Message。注意工具执行顺序确保所有生成发送数据所需的工具都在CogStream工具之前执行完毕。在 QuickBuild 中用“链接”功能明确工具间的数据依赖和执行顺序。处理“粘包”问题如果接收端是自主开发的程序TCP流式传输可能存在“粘包”两次发送的数据被一次接收。解决方案是在消息末尾添加明确的分隔符如换行符\n或者采用“长度内容”的报文格式。在CogStream的Message里加上\n是最简单的办法。5.3 故障排查清单当串流不工作时按这个顺序查基础连接接收端的服务器程序是否真的启动了端口监听了吗VisionPro 机器和接收端机器之间能 ping 通吗防火墙是否关闭或已添加例外CogStream的RemoteHostName和RemotePort写对了吗Protocol选对了吗Client/Server角色VisionPro 内部作业运行时CogStream工具的状态显示是“Connected”吗你的脚本有执行到发送那一步吗在发送前加一行日志输出CogSysLog.Message(“About to send...”)来确认。你绑定的数据源Outputs里的Value在当前图像处理周期里有有效值吗会不会是null或零检查 VisionPro 的“输出窗口”或“系统日志”有没有关于串流的错误或警告信息数据内容先用网络调试助手接收看收到的是什么。是空数据、乱码还是格式不对对比收到的数据和 VisionPro 界面显示的数据是否一致。如果发送JSON格式是否正确括号配对字符串引号性能与稳定性在连续运行一段时间后串流会断开吗观察网络连接状态。发送延迟是否随着运行时间增长检查是否有内存泄漏在任务管理器中观察 VisionPro 进程内存增长。在高节拍下数据会不会丢在接收端统计接收到的消息数量与 VisionPro 处理的图像帧数做对比。5.4 关于“输出端子不支持数组传输”的误解这是一个常见的困惑。VisionPro 工具的输出属性通常是单个值如一个double类型的X坐标或一个对象如一个CogTransform2DLinear位姿。当你需要发送一组同类型数据比如多个Blob的中心坐标时CogStream的单个Output无法直接绑定一个数组。解决方案不是去找一个不存在的“数组输出端子”而是在脚本中拼接如前所述在脚本工具里遍历 Blob 结果将多个坐标拼接成一个字符串比如“x1,y1;x2,y2;x3,y3”然后将这个整个字符串赋值给CogStream.Message。发送多条消息遍历每个 Blob为每个 Blob 构建一条独立的消息并依次发送。但这会增加网络开销和接收端解析复杂度。使用更高级的序列化在脚本中将数据集合序列化成 JSON 数组或 XML然后发送。这是最灵活、最通用的方式也是与上位机系统集成最推荐的方式。所以不是功能不支持而是需要你通过脚本进行一步数据转换和封装。这恰恰体现了 VisionPro 脚本在集成中的重要性。6. 从串流到系统集成进阶思路当单点串流稳定后你的视野可以放到整个系统层面。双向通信CogStream不仅支持发送Send也支持接收Receive。你可以配置它接收来自PLC的触发信号、参数变更指令或复位命令。在脚本中处理OnReceived事件实现视觉系统的外部控制。与机器人/PLC的深度集成对于机器人引导串流发送的物理坐标需要与机器人坐标系对齐。这通常需要严格的“手眼标定”和通信协议对齐如Ethernet/IP、Profinet、Modbus TCP。VisionPro 负责提供精准坐标专业的通信库如第三方DLL负责协议封装脚本作为两者间的桥梁。状态上报与心跳除了检测结果视觉系统还应定时向上位机发送“心跳”信号或状态信息如相机连接状态、光源亮度、自检结果让整个系统知道视觉单元是健康的。队列与异步发送对于超高节拍应用如果网络瞬时拥堵同步发送Send可能会阻塞视觉处理。可以考虑在脚本中使用生产者-消费者队列模型将待发送数据放入队列由另一个线程异步发送避免影响主检测循环。但这需要更复杂的脚本编程。VisionPro 的原生串流其“神奇”不在于用了多高深的技术而在于它把工业视觉系统中最繁琐、最容易出错的通信环节封装成了可视化配置和简单的API调用。它让开发者能更专注于视觉算法本身而不是底层Socket编程。但要想让它真正在生产线上“神奇”地稳定工作离不开对网络、系统、VisionPro框架以及具体工艺需求的深入理解。从打通第一个坐标数据开始一步步构建健壮的错误处理、性能优化和系统集成这才是从开发走向落地的完整路径。
VisionPro原生串流实战：打通视觉检测与自动化系统的数据通道
1. 先搞清楚 VisionPro 串流到底解决了什么问题如果你在工业视觉或者自动化检测领域工作听到“VisionPro”和“串流”这两个词第一反应可能是把相机图像实时传到电脑上处理。但这里有个关键点需要先明确我们讨论的“原生串流”核心不是解决“图像怎么传进来”而是解决“处理结果和中间数据怎么高效、低延迟地送出去”。很多刚接触 VisionPro 二次开发的朋友容易把精力全花在图像采集和算法工具链上觉得只要模板匹配、卡尺测量、Blob分析这些工具跑通了任务就完成了。等到项目真正要上线需要把检测结果比如坐标、角度、NG/OK判断实时发送给PLC、机械臂或者MES系统时才发现卡壳了。用传统的文件读写、共享内存或者简单的TCP发送在高速、连续的生产节拍下要么延迟大要么丢数据要么稳定性堪忧。VisionPro 的原生串流功能就是针对这个痛点设计的。它不是一个外挂工具而是深度集成在 VisionPro 框架内的数据通道。你可以把它理解为一个专为视觉检测结果打造的高速数据总线。它的“神奇”之处在于你可以在 VisionPro 的作业Job内部直接配置将某个工具的输出结果比如 CogPMAlignTool 的GetPose()坐标、CogCaliperTool 的边缘位置绑定到串流输出上。当作业运行时这些结果会自动、实时地通过以太网发送到指定的网络端点几乎不需要你在脚本里写复杂的网络通信代码。这适合谁看如果你是正在做 VisionPro 二次开发需要将检测结果集成到自动化产线。被现场各种通信协议如TCP/IP、UDP、Profinet等对接搞得头疼。想要提升系统响应速度降低从“拍到结果”到“执行动作”的延迟。希望检测任务和结果发送任务解耦让系统更稳定。那么VisionPro 的原生串流就是你接下来最该仔细研究的部分。它能让你的视觉系统从“能检测”升级到“能高效协同”。2. 运行前必须确认的环境与前置条件在兴奋地开始配置串流之前得先把“地基”打好。很多串流测试失败问题都出在环境配置这一步而不是串流本身。2.1 软件与授权准备首先VisionPro 的串流功能不是所有版本都默认包含的。你需要确认你的 VisionPro 许可证License是否包含了VisionPro® Communications或相应的网络通信模块。通常商业版或开发版会包含但一些精简版可能没有。最直接的验证方法是打开 VisionPro QuickBuild在工具箱里搜索“Stream”看能否找到CogStream相关的工具。其次确保你的开发环境是完整的。我一般会按这个顺序检查VisionPro 主版本如 VisionPro 9.x, 10.x。不同大版本间接口可能有差异你的代码和配置要对应。.NET FrameworkVisionPro 开发主要基于 .NET。确认你的 Visual Studio 项目引用了正确的Cognex.VisionPro.dll和Cognex.VisionPro.Comm.dll如果串流功能在独立程序集里。脚本权限如果你计划在 QuickBuild 的脚本工具里调用串流确保脚本执行策略没有问题。2.2 网络环境与硬件配置串流对网络环境比较敏感在办公室随便接接可能没问题上了车间就可能状况百出。网络拓扑视觉控制器运行VisionPro的工控机和目标设备如PLC、上位机最好在同一个局域网段避免跨路由器或复杂网络。直连或者通过交换机连接是最佳选择。IP与防火墙给工控机设置一个固定的IP地址而不是动态获取。关闭Windows防火墙或者为VisionPro应用和端口添加出入站规则。这是最容易被忽略的坑常常表现为“本机测试正常一联外部设备就超时”。网卡与性能对于高速应用节拍100ms建议使用千兆或更高速率的工业网卡。在设备管理器中禁用不必要的网络适配器防止网络流量被错误路由。目标端准备你需要知道接收端设备的IP地址和端口号。并且你需要在接收端准备好一个简单的测试程序来监听端口、接收数据并打印出来。不要一开始就想着直接连PLC先用一个网络调试助手如 TCP/UDP Socket调试工具验证数据能发出来格式正确。2.3 VisionPro 项目基础你的 VisionPro 作业Job本身应该是能稳定运行的。这意味着图像采集无论是来自相机、图像文件还是模拟器是稳定的。你的核心检测工具链如九点标定、模板匹配、卡尺工具已经调试完毕能输出正确的结果。你清楚需要发送哪些数据。例如是发送模板匹配的TranslationX和TranslationY还是发送一个包含多个测量值的自定义结构体。先把检测功能跑稳再叠加串流是最高效的排查顺序。3. 从零开始配置一个基础的串流任务这里我们以最常见的 TCP 协议为例演示如何在 VisionPro QuickBuild 中配置一个将模板匹配坐标发送出去的串流任务。我会假设你已经有一个能正常进行模板匹配的作业。3.1 在 QuickBuild 中添加并配置 Stream 工具打开你的 VisionPro 作业.vpp 文件。在工具箱中搜索“Stream”将CogStream工具拖放到作业编辑区。它通常位于“通信”或“高级”分类下。选中CogStream工具在属性面板中进行配置Protocol选择TcpClient如果你的接收端是服务器或TcpServer如果你的VisionPro作为服务器。初学者建议先让 VisionPro 作为TcpClient去连接一个固定的服务器如网络调试助手。RemoteHostName填写接收端服务器的IP地址例如192.168.1.100。RemotePort填写接收端服务器监听的端口号例如8080。ConnectionTimeout和SendTimeout可以先用默认值如果出现连接或发送超时再调整。配置连接行为在属性中找到AutoConnect选项。如果设为True作业启动时会自动尝试连接如果设为False你需要在脚本中手动调用Connect()方法。初期测试建议设为True。3.2 将检测结果绑定到 Stream这是串流的核心——告诉 VisionPro 你要发送什么数据。在CogStream工具的属性中找到Outputs集合点击编辑…按钮。在弹出的“集合编辑器”中点击“添加”来创建一个新的输出项。为这个输出项设置关键属性Name起一个有意义的名字如Send_MatchPosition。Value这里就是绑定数据源的地方。点击Value属性旁的“…”按钮会弹出“表达式编辑器”。链接数据在表达式编辑器中你可以浏览到当前作业中所有工具的输出。找到你的模板匹配工具例如CogPMAlignTool1展开其输出选择你想要发送的属性例如Results[0].GetPose().TranslationX。这样就把X坐标绑定到了这个串流输出上。重复步骤2-3可以添加多个输出项分别绑定Y坐标、角度、匹配分数等。配置Message属性可选但重要Message定义了数据的封装格式。你可以使用类似“X:{0}, Y:{1}”的格式化字符串其中{0}、{1}会依次被Outputs集合中各项的Value替换。这样接收端收到的就是一条完整的、可读的字符串。你也可以设置为发送JSON格式如“{“x”: {0}, “y”: {1}}”方便上位机解析。3.3 编写脚本控制发送时机默认情况下CogStream工具会在其被作业执行后自动发送绑定的数据。但有时我们需要更精细的控制比如只在匹配成功时发送或者累积几次结果再发送。这就需要用到脚本。在作业中插入一个“脚本”工具CogScript位置可以在CogStream工具之前或之后取决于你的逻辑。一个典型的发送脚本可能长这样C# 示例// 假设你的 CogStream 工具实例名是 CogStream1 // 假设你的模板匹配工具实例名是 CogPMAlignTool1 // 获取模板匹配结果 CogPMAlignResults results CogPMAlignTool1.Results; if (results ! null results.Count 0) { // 检查匹配分数例如大于0.8认为匹配成功 if (results[0].Score 0.8) { // 方法1如果CogStream的AutoSend为True工具执行后会自动发送。 // 我们只需要确保它已连接。 if (!CogStream1.Connected) { CogStream1.Connect(); } // 脚本执行到这里后续的CogStream工具会自动执行并发送数据。 // 方法2如果CogStream的AutoSend为False则需要手动发送。 // CogStream1.Send(); } else { // 匹配失败可以发送一个特定的错误码或什么都不做 // 例如CogStream1.Message “Match Failed”; // CogStream1.Send(); } } else { // 没有结果处理异常情况 }关键点脚本工具和CogStream工具在作业中的执行顺序决定了数据绑定的时机和发送的时机。通常顺序是图像采集 - 图像处理/检测工具 - 脚本处理逻辑-CogStream发送数据。3.4 运行测试与验证启动接收端首先在你的接收端电脑上打开网络调试助手创建一个TCP服务器监听你在CogStream中配置的端口如8080。运行VisionPro作业在QuickBuild中运行你的作业。观察CogStream工具的运行时状态看是否显示“已连接”Connected。触发图像处理给视觉系统提供一张包含待测目标的图像。查看接收数据在网络调试助手的接收区你应该能看到按照Message格式发送过来的字符串例如“X:125.34, Y:87.56”。验证数据正确性对比网络调试助手收到的数据和VisionPro界面中模板匹配工具显示的结果是否一致。走到这一步一个最基本的单向串流发送就通了。但这只是开始真正的挑战在于让它稳定、可靠地工作在产线上。4. 深入核心脚本编写与高级数据获取当基础串流跑通后你会很快遇到更复杂的需求发送自定义格式的数据、打包多个工具的结果、或者根据复杂条件决定发送内容。这时就必须深入脚本编写了。4.1 在脚本中动态构建发送数据前面我们在CogStream的Outputs里静态绑定了数据。但在脚本里我们可以更灵活地操作CogStream对象。// 访问CogStream工具 CogStream myStream (CogStream)Job.GetTool(“CogStream1”); // 假设我们有多个检测工具的结果 CogPMAlignResults matchResult CogPMAlignTool1.Results; CogCaliperTool myCaliper (CogCaliperTool)Job.GetTool(“CogCaliperTool1”); CogCaliperResults caliperResult myCaliper.Results; // 构建一个复杂的JSON字符串 string jsonData “{”; if (matchResult ! null matchResult.Count 0) { jsonData $“\”matchX\”: {matchResult[0].GetPose().TranslationX},”; jsonData $“\”matchY\”: {matchResult[0].GetPose().TranslationY},”; jsonData $“\”matchScore\”: {matchResult[0].Score},”; } if (caliperResult ! null caliperResult.Count 0) { // 假设我们取第一个边缘对的位置 if (caliperResult.EdgePairs ! null caliperResult.EdgePairs.Count 0) { jsonData $“\”edgePosition\”: {caliperResult.EdgePairs[0].Center},”; } } // 移除最后一个多余的逗号 if (jsonData.EndsWith(“,”)) jsonData jsonData.TrimEnd(‘,’); jsonData “}”; // 将构建好的字符串设置为要发送的消息 myStream.Message jsonData; // 确保连接并发送 if (!myStream.Connected) { myStream.Connect(); } myStream.Send();这种方式特别适合需要将多个工具的检测结果打包成一个结构化消息如JSON、XML发送给MES或数据库的场景。4.2 获取并处理复杂的视觉工具结果VisionPro 工具的结果对象往往层次很深在脚本中正确获取是关键。模板匹配 (CogPMAlignTool)最常用的是Results[0].GetPose()它返回一个CogTransform2DLinear对象包含TranslationX,TranslationY,Rotation等。Results[0].Score是匹配分数。卡尺工具 (CogCaliperTool)结果在CogCaliperTool.Results中里面包含找到的EdgePairs边缘对集合。每个EdgePairs有Center中心位置、Width宽度等属性。你需要根据卡尺的投影和搜索方向来理解这些数据的含义。九点标定 (CogCalibNPointToNPoint)标定后你会得到一个Calibrated的坐标系。在脚本中你可以通过UncalibratedPoint和CalibratedPoint的转换将像素坐标转换为物理坐标毫米这个物理坐标才是串流给机械臂最常用的数据。Blob分析 (CogBlobTool)结果包含多个Blobs每个Blob有CenterOfMassX/Y,Area,Perimeter等。你需要遍历集合并可能根据面积、位置进行筛选。一个常见的坑是空引用。在脚本中访问任何工具的Results属性前务必检查其是否为null以及Count是否大于0。否则作业运行时很容易因未处理异常而中断。4.3 错误处理与日志记录生产环境下的串流脚本必须健壮。至少要做以下处理try { // … 你的数据准备和发送逻辑 … myStream.Send(); } catch (System.Net.Sockets.SocketException sockEx) { // 网络异常连接失败、发送超时 CogSysLog.Error(“Stream Send Failed (Network): “ sockEx.Message); // 可以尝试重连或记录错误计数 myStream.Disconnect(); System.Threading.Thread.Sleep(100); // myStream.Connect(); // 谨慎使用自动重连避免死循环 } catch (Cognex.VisionPro.Exception cogEx) { // VisionPro 相关异常 CogSysLog.Error(“Stream Send Failed (VisionPro): “ cogEx.Message); } catch (Exception ex) { // 其他未知异常 CogSysLog.Error(“Stream Send Failed (General): “ ex.Message); }使用CogSysLog将错误信息记录到 VisionPro 的系统日志便于后期排查。同时考虑在发送失败时是重试、跳过还是触发报警这需要根据具体的生产节拍和工艺要求来定。5. 性能调优与生产环境避坑指南当你的串流功能在实验室跑通后准备上产线前下面这些经验能帮你避开大部分坑。5.1 网络延迟与稳定性优化减少数据量只发送必要的数据。不要为了省事把整个图像或所有中间结果都塞进串流。只发送最终判决OK/NG和关键坐标。如果必须发送图像考虑压缩如JPEG或降低分辨率。选择合适协议TCP可靠保证数据顺序和送达但有连接开销适合对可靠性要求极高的指令和关键数据。UDP无连接速度快延迟低但可能丢包、乱序。适合高频、可容忍少量丢失的实时状态数据如连续坐标流。VisionPro 的CogStream也支持 UDP。生产环境建议关键指令如“触发拍照”、“结果OK”用TCP高频实时数据如机器人引导的连续坐标可评估使用UDP并在应用层增加简单的序列号和校验。调整超时与缓冲在CogStream属性中适当调整SendTimeout和ReceiveBufferSize。对于高速应用超时时间不宜设得太长否则一次发送卡顿会阻塞整个作业。缓冲区大小要根据数据包大小设置太小会导致频繁发送太大可能增加延迟。网络隔离视觉系统所在的网段尽量与办公网络、互联网隔离减少广播风暴和无关流量干扰。5.2 VisionPro 作业内部的优化发送频率与节拍匹配你的串流发送频率必须和产线节拍匹配。不要在作业的每一帧都发送而是只在真正有检测结果需要上报时发送。利用脚本条件判断。避免在串流工具上做复杂计算CogStream的Message格式化或Outputs的表达式如果太复杂会增加发送前的准备时间。尽量在之前的脚本工具中完成数据计算和格式化然后将格式化好的字符串直接赋给Message。注意工具执行顺序确保所有生成发送数据所需的工具都在CogStream工具之前执行完毕。在 QuickBuild 中用“链接”功能明确工具间的数据依赖和执行顺序。处理“粘包”问题如果接收端是自主开发的程序TCP流式传输可能存在“粘包”两次发送的数据被一次接收。解决方案是在消息末尾添加明确的分隔符如换行符\n或者采用“长度内容”的报文格式。在CogStream的Message里加上\n是最简单的办法。5.3 故障排查清单当串流不工作时按这个顺序查基础连接接收端的服务器程序是否真的启动了端口监听了吗VisionPro 机器和接收端机器之间能 ping 通吗防火墙是否关闭或已添加例外CogStream的RemoteHostName和RemotePort写对了吗Protocol选对了吗Client/Server角色VisionPro 内部作业运行时CogStream工具的状态显示是“Connected”吗你的脚本有执行到发送那一步吗在发送前加一行日志输出CogSysLog.Message(“About to send...”)来确认。你绑定的数据源Outputs里的Value在当前图像处理周期里有有效值吗会不会是null或零检查 VisionPro 的“输出窗口”或“系统日志”有没有关于串流的错误或警告信息数据内容先用网络调试助手接收看收到的是什么。是空数据、乱码还是格式不对对比收到的数据和 VisionPro 界面显示的数据是否一致。如果发送JSON格式是否正确括号配对字符串引号性能与稳定性在连续运行一段时间后串流会断开吗观察网络连接状态。发送延迟是否随着运行时间增长检查是否有内存泄漏在任务管理器中观察 VisionPro 进程内存增长。在高节拍下数据会不会丢在接收端统计接收到的消息数量与 VisionPro 处理的图像帧数做对比。5.4 关于“输出端子不支持数组传输”的误解这是一个常见的困惑。VisionPro 工具的输出属性通常是单个值如一个double类型的X坐标或一个对象如一个CogTransform2DLinear位姿。当你需要发送一组同类型数据比如多个Blob的中心坐标时CogStream的单个Output无法直接绑定一个数组。解决方案不是去找一个不存在的“数组输出端子”而是在脚本中拼接如前所述在脚本工具里遍历 Blob 结果将多个坐标拼接成一个字符串比如“x1,y1;x2,y2;x3,y3”然后将这个整个字符串赋值给CogStream.Message。发送多条消息遍历每个 Blob为每个 Blob 构建一条独立的消息并依次发送。但这会增加网络开销和接收端解析复杂度。使用更高级的序列化在脚本中将数据集合序列化成 JSON 数组或 XML然后发送。这是最灵活、最通用的方式也是与上位机系统集成最推荐的方式。所以不是功能不支持而是需要你通过脚本进行一步数据转换和封装。这恰恰体现了 VisionPro 脚本在集成中的重要性。6. 从串流到系统集成进阶思路当单点串流稳定后你的视野可以放到整个系统层面。双向通信CogStream不仅支持发送Send也支持接收Receive。你可以配置它接收来自PLC的触发信号、参数变更指令或复位命令。在脚本中处理OnReceived事件实现视觉系统的外部控制。与机器人/PLC的深度集成对于机器人引导串流发送的物理坐标需要与机器人坐标系对齐。这通常需要严格的“手眼标定”和通信协议对齐如Ethernet/IP、Profinet、Modbus TCP。VisionPro 负责提供精准坐标专业的通信库如第三方DLL负责协议封装脚本作为两者间的桥梁。状态上报与心跳除了检测结果视觉系统还应定时向上位机发送“心跳”信号或状态信息如相机连接状态、光源亮度、自检结果让整个系统知道视觉单元是健康的。队列与异步发送对于超高节拍应用如果网络瞬时拥堵同步发送Send可能会阻塞视觉处理。可以考虑在脚本中使用生产者-消费者队列模型将待发送数据放入队列由另一个线程异步发送避免影响主检测循环。但这需要更复杂的脚本编程。VisionPro 的原生串流其“神奇”不在于用了多高深的技术而在于它把工业视觉系统中最繁琐、最容易出错的通信环节封装成了可视化配置和简单的API调用。它让开发者能更专注于视觉算法本身而不是底层Socket编程。但要想让它真正在生产线上“神奇”地稳定工作离不开对网络、系统、VisionPro框架以及具体工艺需求的深入理解。从打通第一个坐标数据开始一步步构建健壮的错误处理、性能优化和系统集成这才是从开发走向落地的完整路径。