简介这份资源是面向C#开发者的AIDI深度学习框架调用示例包帮助开发者将AIDI的图像识别、自然语言处理等能力集成到自己的应用程序中。包内包含完整的调用DEMO工程、AIDI_dll库文件夹以及AIDI调用使用说明文档覆盖从导入dll、配置环境、初始化模型到调用API、处理结果的完整链路并附有框架架构、模型选型与性能优化等技术说明。资源共34个文件以cs源码、dll动态库、resx资源文件、csproj与sln工程文件为主另有docx说明文档、config配置与exe可执行文件压缩包约1.42MB结构清晰便于按模块查阅。目前已有252人学习。通过该DEMO读者可掌握在C#中实例化AIDI对象、加载预训练模型并执行推理的写法同时了解错误处理、结果解析、并行请求与缓存优化等实用技巧适合具备一定C#基础、希望快速上手AIDI深度学习调用的开发者参考实践。1. 从 AIDI 深度学习 Demo 到 C# 上位机落地这套调用链路到底解决什么问题产线上跑着 AIDI 训练出来的深度学习模型检测结果要显示在 C# 写的上位机界面里还要和 PLC 做联动——这个场景在工业视觉圈里越来越常见。AIDI 是工业视觉领域常用的深度学习训练平台负责模型训练和推理服务C# 上位机负责界面交互、设备通信和业务逻辑。两者之间的调用链路就是这套 Demo 要解决的核心问题。很多人第一次拿到 AIDI 深度学习 C# 调用 Demo 时最直接的需求就是怎么让我的 C# 程序把 AIDI 的推理结果拿到手然后塞进我自己的业务流程里。这篇内容会从调用方式选型、环境配置、代码实现、参数调试到踩坑排查把这条链路完整走一遍。适合有 C# 基础、正在做工业视觉上位机、需要集成深度学习推理的工程师。2. AIDI 对外调用方式与 C# 集成选型为什么不是只有一条路2.1 AIDI 常见的三种对外调用形态AIDI 深度学习平台在实际部署中对外暴露能力的方式通常有三种本地 SDK 调用、HTTP RESTful 接口调用、以及基于共享内存或本地 Socket 的进程间通信。这三种方式各有适用场景选错了后面全是返工。本地 SDK 调用一般以动态链接库DLL形式提供C# 通过 P/Invoke 或 C/CLI 包装层调用。优点是延迟最低适合节拍要求高的产线缺点是版本耦合强AIDI 升级后接口可能变而且 C# 调用 C 接口时容易出现AccessViolationException对应热词里那个 c0000005 错误码排查起来很痛苦。HTTP RESTful 接口是 AIDI 推理服务最常见的对外方式。AIDI 启动推理服务后监听一个本地端口C# 用HttpClient或RestClient发 POST 请求传图片路径或 Base64 编码拿回 JSON 格式的检测结果。优点是解耦好、跨语言、调试方便缺点是序列化和网络开销会带来额外延迟高节拍场景下需要做连接复用和批量推理。共享内存或本地 Socket 方式介于两者之间适合图像数据量大、不想走 HTTP 序列化的场景。AIDI 把推理结果写到共享内存C# 侧读取或者 AIDI 开一个 TCP 端口C# 用TcpListener接收。这种方式性能好但协议要自己定义稳定性依赖双方约定。2.2 选型判断延迟、耦合度、调试成本三个维度选哪种方式核心看三个维度单帧推理延迟要求、版本升级频率、团队调试能力。如果产线节拍在 200ms 以内且 AIDI 版本稳定优先考虑本地 SDK 或共享内存。如果节拍在 500ms 以上HTTP 接口完全够用而且调试成本最低。如果 AIDI 经常升级模型或平台版本HTTP 接口的解耦优势就体现出来了——你只需要确认接口协议没变C# 侧几乎不用动。我一般会建议先用 HTTP 接口把链路跑通验证业务逻辑没问题后如果延迟不达标再换成共享内存或 SDK。上来就啃 SDK 的 P/Invoke很容易在AccessViolationException上卡好几天。2.3 C# 侧 HTTP 调用的最小可行代码假设 AIDI 推理服务已经启动监听http://127.0.0.1:8500提供/predict接口接收图片路径返回 JSON。下面是一个最小可行的 C# 调用代码using System; using System.Net.Http; using System.Text; using System.Threading.Tasks; using Newtonsoft.Json; public class AidiClient { private static readonly HttpClient _httpClient new HttpClient(); // 初始化设置超时和默认请求头 static AidiClient() { _httpClient.Timeout TimeSpan.FromSeconds(10); _httpClient.DefaultRequestHeaders.Add(Accept, application/json); } /// summary /// 调用 AIDI 推理接口 /// /summary /// param nameimagePath本地图片绝对路径/param /// returns推理结果 JSON 字符串/returns public async Taskstring PredictAsync(string imagePath) { // 构造请求体AIDI 通常接受 image_path 字段 var requestBody new { image_path imagePath, confidence_threshold 0.5f, // 置信度阈值按需调整 return_type json }; string json JsonConvert.SerializeObject(requestBody); var content new StringContent(json, Encoding.UTF8, application/json); try { // 发送 POST 请求到 AIDI 推理服务 HttpResponseMessage response await _httpClient.PostAsync( http://127.0.0.1:8500/predict, content); response.EnsureSuccessStatusCode(); // 非 2xx 直接抛异常 string result await response.Content.ReadAsStringAsync(); return result; } catch (TaskCanceledException ex) { // 超时处理AIDI 推理服务可能卡住或图片过大 throw new Exception($AIDI 推理超时检查服务状态或图片大小: {ex.Message}); } catch (HttpRequestException ex) { // 连接失败AIDI 服务未启动或端口不对 throw new Exception($无法连接 AIDI 推理服务: {ex.Message}); } } }这段代码的逻辑很直接用静态HttpClient避免频繁创建连接设置 10 秒超时防止卡死请求体里带图片路径和置信度阈值。参数说明confidence_threshold控制检测框的过滤阈值设太低会出很多误检设太高会漏检一般从 0.5 开始调return_type指定返回格式有些 AIDI 版本支持json或xml按实际接口文档来。注意HttpClient一定要用静态实例或IHttpClientFactory不要每次new否则在高频调用下会耗尽 TCP 连接表现为随机性的SocketException。3. 把 Demo 跑起来环境配置、接口对接与结果解析3.1 AIDI 推理服务的启动与验证在写 C# 代码之前先确认 AIDI 推理服务本身是通的。常见做法是在 AIDI 平台里训练好模型后导出推理包或启动推理服务记下监听端口和接口路径。然后用 Postman 或 curl 先测一发# 用 curl 验证 AIDI 推理服务是否正常 curl -X POST http://127.0.0.1:8500/predict \ -H Content-Type: application/json \ -d {image_path: D:/test/sample.jpg, confidence_threshold: 0.5}如果返回了 JSON 格式的检测结果说明 AIDI 侧没问题可以专心搞 C# 调用。如果 curl 都不通先检查 AIDI 推理服务是否启动、端口是否被防火墙拦、图片路径是否存在。这一步能省掉后面大量扯皮时间。3.2 C# 项目环境准备与依赖安装新建一个 C# 控制台项目或 WinForms 项目目标框架建议 .NET Framework 4.7.2 以上或 .NET 6/8。需要安装的 NuGet 包包名用途备注Newtonsoft.JsonJSON 序列化/反序列化兼容性好工业项目常用System.Net.HttpHTTP 客户端.NET Framework 需手动引用RestSharp可选更简洁的 HTTP 调用如果不想手写 HttpClient安装命令# 在 Package Manager Console 中执行 Install-Package Newtonsoft.Json Install-Package RestSharp如果用的是 .NET 6System.Net.Http已经内置不需要额外安装。RestSharp 的好处是 API 更简洁但底层还是 HttpClient性能差异不大。3.3 解析 AIDI 返回的 JSON 结果AIDI 返回的 JSON 结构通常包含检测框坐标、类别、置信度等信息。不同版本的 AIDI 返回格式可能略有差异但大体结构类似{ code: 0, message: success, data: { detections: [ { label: defect, confidence: 0.92, bbox: [120, 340, 200, 420] } ], inference_time_ms: 45 } }C# 侧解析代码using Newtonsoft.Json; using System.Collections.Generic; // 定义与 AIDI 返回 JSON 对应的数据模型 public class AidiResponse { public int Code { get; set; } public string Message { get; set; } public AidiData Data { get; set; } } public class AidiData { public ListDetection Detections { get; set; } public int InferenceTimeMs { get; set; } } public class Detection { public string Label { get; set; } public float Confidence { get; set; } public int[] Bbox { get; set; } // [x1, y1, x2, y2] } // 解析示例 public AidiResponse ParseResult(string json) { var response JsonConvert.DeserializeObjectAidiResponse(json); if (response null || response.Code ! 0) { throw new Exception($AIDI 返回错误: {response?.Message}); } return response; }参数说明Code为 0 表示成功非 0 表示 AIDI 侧出错具体错误码要查 AIDI 文档Bbox是检测框的左上角和右下角坐标单位是像素InferenceTimeMs是 AIDI 侧推理耗时可以用来监控服务性能。拿到检测结果后就可以在 C# 上位机里画框、记录数据、和 PLC 做交互了。比如检测到缺陷时通过 Modbus TCP 或西门子 S7 协议给 PLC 发信号触发剔除动作。3.4 与 C# 上位机业务逻辑的对接实际项目里AIDI 调用只是整个上位机流程中的一环。典型流程是相机采图 → 保存到本地 → 调用 AIDI 推理 → 解析结果 → 界面显示 → 与 PLC 交互。这里有一个容易忽略的点图片保存和 AIDI 读取之间的时序。如果 C# 保存图片后立刻调用 AIDI而 AIDI 读文件时图片还没写完就会报错或读到半张图。常见做法是保存到临时文件后先File.Move重命名或者用文件锁确保写完再通知 AIDI。另外如果产线节拍很快建议用异步调用 队列的方式不要让 UI 线程等 AIDI 返回。可以用Task.Run包装推理调用结果通过Invoke回到 UI 线程更新界面。4. 避坑与排查AIDI 深度学习 C# 调用中最容易翻车的 5 个点4.1 现象C# 调用后报 AccessViolationException0xC0000005原因这是 C# 通过 P/Invoke 调用 AIDI 的 C SDK 时最常见的问题。通常是因为 C# 侧传递的字符串编码、数组长度或指针类型和 C 接口定义不匹配。比如 C 接口要求char*而 C# 传了string默认的 Unicode 编码或者数组维度对不上导致越界写。解决先确认 AIDI SDK 头文件里的参数类型和调用约定cdecl还是stdcallC# 的DllImport里要显式指定CallingConvention。字符串统一用[MarshalAs(UnmanagedType.LPStr)]或手动转IntPtr。如果 SDK 提供 C/CLI 包装层优先用包装层而不是直接 P/Invoke。4.2 现象HTTP 调用返回“无法将数据写入传输连接远程主机强迫关闭了一个现有的连接”原因这个错误对应热词里提到的RestClient.Execute异常。常见原因是 AIDI 推理服务处理时间过长超过了 C# 侧设置的超时时间服务端主动断开了连接。也可能是 AIDI 服务并发能力有限同时来了多个请求被拒绝。解决先加大HttpClient.Timeout比如从 10 秒调到 30 秒。然后在 AIDI 侧确认推理服务的并发配置如果只支持单路推理C# 侧就要加锁或队列避免并发调用。另外检查图片大小过大的图片会导致推理时间飙升建议在 C# 侧先做缩放再传给 AIDI。4.3 现象AIDI 返回的检测框坐标和实际图片对不上原因AIDI 训练时的输入尺寸和推理时的输入尺寸可能不一致返回的坐标是基于模型输入尺寸的需要映射回原图尺寸。如果 C# 侧直接拿返回坐标在原图上画框就会偏移。解决确认 AIDI 推理时是否做了 resize以及返回的坐标是相对坐标还是绝对坐标。如果是相对坐标乘以原图宽高即可如果是基于 resize 后的绝对坐标需要按比例缩放回去。常见做法是在 AIDI 侧配置返回原图坐标或者在 C# 侧做坐标映射。4.4 现象C# 程序运行一段时间后内存持续增长原因每次调用 AIDI 都创建了新的HttpClient或Bitmap对象没有释放导致内存泄漏。尤其是Bitmap和Graphics对象不Dispose就会一直占内存。解决HttpClient用静态实例或IHttpClientFactoryBitmap、Graphics、FileStream等实现IDisposable的对象用using包起来。如果用了 RestSharpRestClient和RestRequest也要注意复用和释放。4.5 现象AIDI 推理结果偶尔为空或置信度异常低原因可能是图片格式问题。AIDI 对输入图片的通道顺序、位深有要求比如要求 BGR 三通道 8 位而 C# 保存的是 BGRA 四通道或 16 位图。也可能是图片路径包含中文或空格AIDI 读取失败。解决在 C# 侧统一图片格式保存为 BGR 三通道 JPEG 或 PNG。路径尽量用英文和数字避免中文和空格。如果必须用中文路径确认 AIDI 侧是否支持 UTF-8 路径解析。5. 进阶技巧用 C# 封装 AIDI 调用层并做性能验证5.1 封装一个可复用的 AIDI 调用层在实际项目里不建议把 AIDI 调用代码散落在各个业务模块里。更好的做法是封装一个AidiService类统一处理连接、重试、超时、日志和结果解析。这样业务层只需要调AidiService.DetectAsync(imagePath)不关心底层是 HTTP 还是 SDK。public class AidiService : IDisposable { private readonly HttpClient _client; private readonly string _baseUrl; private readonly int _maxRetries; public AidiService(string baseUrl, int maxRetries 2) { _baseUrl baseUrl.TrimEnd(/); _maxRetries maxRetries; _client new HttpClient { Timeout TimeSpan.FromSeconds(15) }; } public async TaskAidiResponse DetectAsync(string imagePath) { int attempt 0; while (true) { try { var body new { image_path imagePath, confidence_threshold 0.5f }; var content new StringContent( JsonConvert.SerializeObject(body), Encoding.UTF8, application/json); var resp await _client.PostAsync(${_baseUrl}/predict, content); resp.EnsureSuccessStatusCode(); string json await resp.Content.ReadAsStringAsync(); return JsonConvert.DeserializeObjectAidiResponse(json); } catch (Exception) when (attempt _maxRetries) { attempt; await Task.Delay(200 * attempt); // 退避重试 } } } public void Dispose() _client?.Dispose(); }这个封装加了重试机制和退避延迟参数maxRetries控制重试次数Task.Delay(200 * attempt)实现指数退避。注意重试只对网络抖动有效如果是 AIDI 服务本身挂了重试也没用所以日志要记录清楚。5.2 性能验证延迟、吞吐量和稳定性封装完之后建议做一个简单的性能验证。用 C# 写一个循环连续调用 100 次记录每次的耗时和成功率var service new AidiService(http://127.0.0.1:8500); var sw new Stopwatch(); var times new Listlong(); for (int i 0; i 100; i) { sw.Restart(); try { var result await service.DetectAsync(D:/test/sample.jpg); times.Add(sw.ElapsedMilliseconds); } catch (Exception ex) { Console.WriteLine($第 {i} 次调用失败: {ex.Message}); } } Console.WriteLine($平均延迟: {times.Average():F1}ms); Console.WriteLine($P95 延迟: {times.OrderBy(t t).ElementAt((int)(times.Count * 0.95))}ms); Console.WriteLine($成功率: {times.Count}/100);重点看 P95 延迟和成功率。如果 P95 延迟远高于平均延迟说明有偶发的慢请求可能是 AIDI 侧的资源竞争或 GC。如果成功率不到 100%要查失败原因是超时还是连接拒绝。5.3 一个我踩过的坑别在 UI 线程里同步调用早期做 WinForms 上位机时我直接在按钮点击事件里同步调用 AIDI 的 HTTP 接口结果界面卡死操作员以为程序崩了。后来改成async/await按钮事件里await service.DetectAsync(...)界面就不卡了。但要注意await之后的代码默认回到 UI 线程如果结果解析很耗时还是要用Task.Run包一下。另一个习惯是所有 AIDI 调用都加日志记录请求时间、图片路径、返回耗时和结果摘要。出问题时翻日志比猜快得多。这个习惯帮我省了很多后悔药。希望帮到你。本文还有配套的精品资源点击获取
AIDI深度学习C#上位机调用链路实战：从HTTP接口到PLC联动
简介这份资源是面向C#开发者的AIDI深度学习框架调用示例包帮助开发者将AIDI的图像识别、自然语言处理等能力集成到自己的应用程序中。包内包含完整的调用DEMO工程、AIDI_dll库文件夹以及AIDI调用使用说明文档覆盖从导入dll、配置环境、初始化模型到调用API、处理结果的完整链路并附有框架架构、模型选型与性能优化等技术说明。资源共34个文件以cs源码、dll动态库、resx资源文件、csproj与sln工程文件为主另有docx说明文档、config配置与exe可执行文件压缩包约1.42MB结构清晰便于按模块查阅。目前已有252人学习。通过该DEMO读者可掌握在C#中实例化AIDI对象、加载预训练模型并执行推理的写法同时了解错误处理、结果解析、并行请求与缓存优化等实用技巧适合具备一定C#基础、希望快速上手AIDI深度学习调用的开发者参考实践。1. 从 AIDI 深度学习 Demo 到 C# 上位机落地这套调用链路到底解决什么问题产线上跑着 AIDI 训练出来的深度学习模型检测结果要显示在 C# 写的上位机界面里还要和 PLC 做联动——这个场景在工业视觉圈里越来越常见。AIDI 是工业视觉领域常用的深度学习训练平台负责模型训练和推理服务C# 上位机负责界面交互、设备通信和业务逻辑。两者之间的调用链路就是这套 Demo 要解决的核心问题。很多人第一次拿到 AIDI 深度学习 C# 调用 Demo 时最直接的需求就是怎么让我的 C# 程序把 AIDI 的推理结果拿到手然后塞进我自己的业务流程里。这篇内容会从调用方式选型、环境配置、代码实现、参数调试到踩坑排查把这条链路完整走一遍。适合有 C# 基础、正在做工业视觉上位机、需要集成深度学习推理的工程师。2. AIDI 对外调用方式与 C# 集成选型为什么不是只有一条路2.1 AIDI 常见的三种对外调用形态AIDI 深度学习平台在实际部署中对外暴露能力的方式通常有三种本地 SDK 调用、HTTP RESTful 接口调用、以及基于共享内存或本地 Socket 的进程间通信。这三种方式各有适用场景选错了后面全是返工。本地 SDK 调用一般以动态链接库DLL形式提供C# 通过 P/Invoke 或 C/CLI 包装层调用。优点是延迟最低适合节拍要求高的产线缺点是版本耦合强AIDI 升级后接口可能变而且 C# 调用 C 接口时容易出现AccessViolationException对应热词里那个 c0000005 错误码排查起来很痛苦。HTTP RESTful 接口是 AIDI 推理服务最常见的对外方式。AIDI 启动推理服务后监听一个本地端口C# 用HttpClient或RestClient发 POST 请求传图片路径或 Base64 编码拿回 JSON 格式的检测结果。优点是解耦好、跨语言、调试方便缺点是序列化和网络开销会带来额外延迟高节拍场景下需要做连接复用和批量推理。共享内存或本地 Socket 方式介于两者之间适合图像数据量大、不想走 HTTP 序列化的场景。AIDI 把推理结果写到共享内存C# 侧读取或者 AIDI 开一个 TCP 端口C# 用TcpListener接收。这种方式性能好但协议要自己定义稳定性依赖双方约定。2.2 选型判断延迟、耦合度、调试成本三个维度选哪种方式核心看三个维度单帧推理延迟要求、版本升级频率、团队调试能力。如果产线节拍在 200ms 以内且 AIDI 版本稳定优先考虑本地 SDK 或共享内存。如果节拍在 500ms 以上HTTP 接口完全够用而且调试成本最低。如果 AIDI 经常升级模型或平台版本HTTP 接口的解耦优势就体现出来了——你只需要确认接口协议没变C# 侧几乎不用动。我一般会建议先用 HTTP 接口把链路跑通验证业务逻辑没问题后如果延迟不达标再换成共享内存或 SDK。上来就啃 SDK 的 P/Invoke很容易在AccessViolationException上卡好几天。2.3 C# 侧 HTTP 调用的最小可行代码假设 AIDI 推理服务已经启动监听http://127.0.0.1:8500提供/predict接口接收图片路径返回 JSON。下面是一个最小可行的 C# 调用代码using System; using System.Net.Http; using System.Text; using System.Threading.Tasks; using Newtonsoft.Json; public class AidiClient { private static readonly HttpClient _httpClient new HttpClient(); // 初始化设置超时和默认请求头 static AidiClient() { _httpClient.Timeout TimeSpan.FromSeconds(10); _httpClient.DefaultRequestHeaders.Add(Accept, application/json); } /// summary /// 调用 AIDI 推理接口 /// /summary /// param nameimagePath本地图片绝对路径/param /// returns推理结果 JSON 字符串/returns public async Taskstring PredictAsync(string imagePath) { // 构造请求体AIDI 通常接受 image_path 字段 var requestBody new { image_path imagePath, confidence_threshold 0.5f, // 置信度阈值按需调整 return_type json }; string json JsonConvert.SerializeObject(requestBody); var content new StringContent(json, Encoding.UTF8, application/json); try { // 发送 POST 请求到 AIDI 推理服务 HttpResponseMessage response await _httpClient.PostAsync( http://127.0.0.1:8500/predict, content); response.EnsureSuccessStatusCode(); // 非 2xx 直接抛异常 string result await response.Content.ReadAsStringAsync(); return result; } catch (TaskCanceledException ex) { // 超时处理AIDI 推理服务可能卡住或图片过大 throw new Exception($AIDI 推理超时检查服务状态或图片大小: {ex.Message}); } catch (HttpRequestException ex) { // 连接失败AIDI 服务未启动或端口不对 throw new Exception($无法连接 AIDI 推理服务: {ex.Message}); } } }这段代码的逻辑很直接用静态HttpClient避免频繁创建连接设置 10 秒超时防止卡死请求体里带图片路径和置信度阈值。参数说明confidence_threshold控制检测框的过滤阈值设太低会出很多误检设太高会漏检一般从 0.5 开始调return_type指定返回格式有些 AIDI 版本支持json或xml按实际接口文档来。注意HttpClient一定要用静态实例或IHttpClientFactory不要每次new否则在高频调用下会耗尽 TCP 连接表现为随机性的SocketException。3. 把 Demo 跑起来环境配置、接口对接与结果解析3.1 AIDI 推理服务的启动与验证在写 C# 代码之前先确认 AIDI 推理服务本身是通的。常见做法是在 AIDI 平台里训练好模型后导出推理包或启动推理服务记下监听端口和接口路径。然后用 Postman 或 curl 先测一发# 用 curl 验证 AIDI 推理服务是否正常 curl -X POST http://127.0.0.1:8500/predict \ -H Content-Type: application/json \ -d {image_path: D:/test/sample.jpg, confidence_threshold: 0.5}如果返回了 JSON 格式的检测结果说明 AIDI 侧没问题可以专心搞 C# 调用。如果 curl 都不通先检查 AIDI 推理服务是否启动、端口是否被防火墙拦、图片路径是否存在。这一步能省掉后面大量扯皮时间。3.2 C# 项目环境准备与依赖安装新建一个 C# 控制台项目或 WinForms 项目目标框架建议 .NET Framework 4.7.2 以上或 .NET 6/8。需要安装的 NuGet 包包名用途备注Newtonsoft.JsonJSON 序列化/反序列化兼容性好工业项目常用System.Net.HttpHTTP 客户端.NET Framework 需手动引用RestSharp可选更简洁的 HTTP 调用如果不想手写 HttpClient安装命令# 在 Package Manager Console 中执行 Install-Package Newtonsoft.Json Install-Package RestSharp如果用的是 .NET 6System.Net.Http已经内置不需要额外安装。RestSharp 的好处是 API 更简洁但底层还是 HttpClient性能差异不大。3.3 解析 AIDI 返回的 JSON 结果AIDI 返回的 JSON 结构通常包含检测框坐标、类别、置信度等信息。不同版本的 AIDI 返回格式可能略有差异但大体结构类似{ code: 0, message: success, data: { detections: [ { label: defect, confidence: 0.92, bbox: [120, 340, 200, 420] } ], inference_time_ms: 45 } }C# 侧解析代码using Newtonsoft.Json; using System.Collections.Generic; // 定义与 AIDI 返回 JSON 对应的数据模型 public class AidiResponse { public int Code { get; set; } public string Message { get; set; } public AidiData Data { get; set; } } public class AidiData { public ListDetection Detections { get; set; } public int InferenceTimeMs { get; set; } } public class Detection { public string Label { get; set; } public float Confidence { get; set; } public int[] Bbox { get; set; } // [x1, y1, x2, y2] } // 解析示例 public AidiResponse ParseResult(string json) { var response JsonConvert.DeserializeObjectAidiResponse(json); if (response null || response.Code ! 0) { throw new Exception($AIDI 返回错误: {response?.Message}); } return response; }参数说明Code为 0 表示成功非 0 表示 AIDI 侧出错具体错误码要查 AIDI 文档Bbox是检测框的左上角和右下角坐标单位是像素InferenceTimeMs是 AIDI 侧推理耗时可以用来监控服务性能。拿到检测结果后就可以在 C# 上位机里画框、记录数据、和 PLC 做交互了。比如检测到缺陷时通过 Modbus TCP 或西门子 S7 协议给 PLC 发信号触发剔除动作。3.4 与 C# 上位机业务逻辑的对接实际项目里AIDI 调用只是整个上位机流程中的一环。典型流程是相机采图 → 保存到本地 → 调用 AIDI 推理 → 解析结果 → 界面显示 → 与 PLC 交互。这里有一个容易忽略的点图片保存和 AIDI 读取之间的时序。如果 C# 保存图片后立刻调用 AIDI而 AIDI 读文件时图片还没写完就会报错或读到半张图。常见做法是保存到临时文件后先File.Move重命名或者用文件锁确保写完再通知 AIDI。另外如果产线节拍很快建议用异步调用 队列的方式不要让 UI 线程等 AIDI 返回。可以用Task.Run包装推理调用结果通过Invoke回到 UI 线程更新界面。4. 避坑与排查AIDI 深度学习 C# 调用中最容易翻车的 5 个点4.1 现象C# 调用后报 AccessViolationException0xC0000005原因这是 C# 通过 P/Invoke 调用 AIDI 的 C SDK 时最常见的问题。通常是因为 C# 侧传递的字符串编码、数组长度或指针类型和 C 接口定义不匹配。比如 C 接口要求char*而 C# 传了string默认的 Unicode 编码或者数组维度对不上导致越界写。解决先确认 AIDI SDK 头文件里的参数类型和调用约定cdecl还是stdcallC# 的DllImport里要显式指定CallingConvention。字符串统一用[MarshalAs(UnmanagedType.LPStr)]或手动转IntPtr。如果 SDK 提供 C/CLI 包装层优先用包装层而不是直接 P/Invoke。4.2 现象HTTP 调用返回“无法将数据写入传输连接远程主机强迫关闭了一个现有的连接”原因这个错误对应热词里提到的RestClient.Execute异常。常见原因是 AIDI 推理服务处理时间过长超过了 C# 侧设置的超时时间服务端主动断开了连接。也可能是 AIDI 服务并发能力有限同时来了多个请求被拒绝。解决先加大HttpClient.Timeout比如从 10 秒调到 30 秒。然后在 AIDI 侧确认推理服务的并发配置如果只支持单路推理C# 侧就要加锁或队列避免并发调用。另外检查图片大小过大的图片会导致推理时间飙升建议在 C# 侧先做缩放再传给 AIDI。4.3 现象AIDI 返回的检测框坐标和实际图片对不上原因AIDI 训练时的输入尺寸和推理时的输入尺寸可能不一致返回的坐标是基于模型输入尺寸的需要映射回原图尺寸。如果 C# 侧直接拿返回坐标在原图上画框就会偏移。解决确认 AIDI 推理时是否做了 resize以及返回的坐标是相对坐标还是绝对坐标。如果是相对坐标乘以原图宽高即可如果是基于 resize 后的绝对坐标需要按比例缩放回去。常见做法是在 AIDI 侧配置返回原图坐标或者在 C# 侧做坐标映射。4.4 现象C# 程序运行一段时间后内存持续增长原因每次调用 AIDI 都创建了新的HttpClient或Bitmap对象没有释放导致内存泄漏。尤其是Bitmap和Graphics对象不Dispose就会一直占内存。解决HttpClient用静态实例或IHttpClientFactoryBitmap、Graphics、FileStream等实现IDisposable的对象用using包起来。如果用了 RestSharpRestClient和RestRequest也要注意复用和释放。4.5 现象AIDI 推理结果偶尔为空或置信度异常低原因可能是图片格式问题。AIDI 对输入图片的通道顺序、位深有要求比如要求 BGR 三通道 8 位而 C# 保存的是 BGRA 四通道或 16 位图。也可能是图片路径包含中文或空格AIDI 读取失败。解决在 C# 侧统一图片格式保存为 BGR 三通道 JPEG 或 PNG。路径尽量用英文和数字避免中文和空格。如果必须用中文路径确认 AIDI 侧是否支持 UTF-8 路径解析。5. 进阶技巧用 C# 封装 AIDI 调用层并做性能验证5.1 封装一个可复用的 AIDI 调用层在实际项目里不建议把 AIDI 调用代码散落在各个业务模块里。更好的做法是封装一个AidiService类统一处理连接、重试、超时、日志和结果解析。这样业务层只需要调AidiService.DetectAsync(imagePath)不关心底层是 HTTP 还是 SDK。public class AidiService : IDisposable { private readonly HttpClient _client; private readonly string _baseUrl; private readonly int _maxRetries; public AidiService(string baseUrl, int maxRetries 2) { _baseUrl baseUrl.TrimEnd(/); _maxRetries maxRetries; _client new HttpClient { Timeout TimeSpan.FromSeconds(15) }; } public async TaskAidiResponse DetectAsync(string imagePath) { int attempt 0; while (true) { try { var body new { image_path imagePath, confidence_threshold 0.5f }; var content new StringContent( JsonConvert.SerializeObject(body), Encoding.UTF8, application/json); var resp await _client.PostAsync(${_baseUrl}/predict, content); resp.EnsureSuccessStatusCode(); string json await resp.Content.ReadAsStringAsync(); return JsonConvert.DeserializeObjectAidiResponse(json); } catch (Exception) when (attempt _maxRetries) { attempt; await Task.Delay(200 * attempt); // 退避重试 } } } public void Dispose() _client?.Dispose(); }这个封装加了重试机制和退避延迟参数maxRetries控制重试次数Task.Delay(200 * attempt)实现指数退避。注意重试只对网络抖动有效如果是 AIDI 服务本身挂了重试也没用所以日志要记录清楚。5.2 性能验证延迟、吞吐量和稳定性封装完之后建议做一个简单的性能验证。用 C# 写一个循环连续调用 100 次记录每次的耗时和成功率var service new AidiService(http://127.0.0.1:8500); var sw new Stopwatch(); var times new Listlong(); for (int i 0; i 100; i) { sw.Restart(); try { var result await service.DetectAsync(D:/test/sample.jpg); times.Add(sw.ElapsedMilliseconds); } catch (Exception ex) { Console.WriteLine($第 {i} 次调用失败: {ex.Message}); } } Console.WriteLine($平均延迟: {times.Average():F1}ms); Console.WriteLine($P95 延迟: {times.OrderBy(t t).ElementAt((int)(times.Count * 0.95))}ms); Console.WriteLine($成功率: {times.Count}/100);重点看 P95 延迟和成功率。如果 P95 延迟远高于平均延迟说明有偶发的慢请求可能是 AIDI 侧的资源竞争或 GC。如果成功率不到 100%要查失败原因是超时还是连接拒绝。5.3 一个我踩过的坑别在 UI 线程里同步调用早期做 WinForms 上位机时我直接在按钮点击事件里同步调用 AIDI 的 HTTP 接口结果界面卡死操作员以为程序崩了。后来改成async/await按钮事件里await service.DetectAsync(...)界面就不卡了。但要注意await之后的代码默认回到 UI 线程如果结果解析很耗时还是要用Task.Run包一下。另一个习惯是所有 AIDI 调用都加日志记录请求时间、图片路径、返回耗时和结果摘要。出问题时翻日志比猜快得多。这个习惯帮我省了很多后悔药。希望帮到你。本文还有配套的精品资源点击获取
