不管你是用.net framework還是用.net core或者更高版本.net環(huán)境，這篇文章也許都能幫到你！因為接下來我會提供一個簡單粗暴的方式，來快速實現(xiàn)多款掃碼器的通用掃碼功能。目前本地測試過的包括基恩士系列、康耐視系列、以及其他支持以太網(wǎng)通信的多款小眾廠家等。

下面開始重點操作：

首先，在你的項目里面引用Wesky.Net.OpenTools 包，1.0.7以及以上版本均可。

如果你是在.netframework環(huán)境下面開放，或者是沒有使用依賴注入的項目中使用，使用方式可以直接new一個對象來使用，有關(guān)使用如下代碼：

ICodeReader reader = new CodeReader();
ReaderClientInfo clientInfo = new ReaderClientInfo(); // 掃碼器客戶端實例
clientInfo.Ip = IPAddress.Parse("192.168.1.102"); // 掃碼器IP
clientInfo.Port = 3000; // 掃碼器端口號
clientInfo.Count = 3;  // 沒掃到碼重試次數(shù)
clientInfo.SendTimeOut = 3000; // 請求超時 毫秒
clientInfo.ReceiveTimeOut = 3000; // 接收掃碼內(nèi)容超時 毫秒
clientInfo.Brand = "SR"; // 掃碼器品牌
clientInfo.Command = "CMD"; // 掃碼器觸發(fā)指令，指令可通過各個掃碼器廠家提供的配置軟件，配置為通用的
clientInfo.ReaderNo = 1;  // 掃碼器編號，可自定義，例如有10個，就可以配置1-10號
clientInfo.CloseCommand = ""; // 停止觸發(fā)指令，如果沒有則默認(rèn)空字符串即可


ReaderResultInfo res = reader.ReaderConnection(ref clientInfo); // 通信連接，連接掃碼器服務(wù)端，參數(shù)返回客戶端實例 以及 標(biāo)準(zhǔn)返回值類型ReaderResultInfo


if (!res.IsSucceed)
{
    Console.WriteLine($"與掃碼器建立通信連接失敗:{res.Message}");
    return;
}
res = reader.ReaderRead(ref clientInfo); // 傳入掃碼器客戶端實例，進行掃碼。并參數(shù)內(nèi)返回最新的掃碼器客戶端實例
if (!res.IsSucceed)
{
   Console.WriteLine($"掃碼異常:{res.Message}");
    return;
}
else
{
    Console.WriteLine($"掃到碼:{res.Value}  掃碼耗時:{res.ElapsedMilliseconds}");
}

當(dāng)然，強烈建議你們的項目使用.net core或以上環(huán)境。畢竟.net core是開源的，還可以跨平臺，不管你是在Windows運行還是在Linux，都可以運行。

下面是在.net core或以上環(huán)境下的使用。例如我新建一個.net 8的webapi項目，

對ICodeReader接口和CodeReader類進行依賴注入的注冊，建議使用瞬時生命周期，可以提高多個掃碼器同時存在時的并發(fā)掃碼效率。

例如：builder.Services.AddTransient<ICodeReader, CodeReader>(); 

建議新建一個全局實體類屬性，用于存儲掃碼器的所有客戶端實例，用于保持實例長連接。

例如：

public class ReaderClients
{
    public static ReaderClientInfo[] Clients { get; set; }=new ReaderClientInfo[0];
}

控制器內(nèi)所有代碼如下：

public class ScannerController : ControllerBase
 {
     private readonly ICodeReader _reader;
     public ScannerController(ICodeReader reader)
     {
         _reader = reader;
     }


     [HttpPost]
     public IActionResult Connection([FromBody] List<ReaderClientInfo> clientInfos)
     {
         // 創(chuàng)建一個StringBuilder對象用于存儲返回的結(jié)果信息
         var result = new StringBuilder();
         try
         {
             if (clientInfos == null || clientInfos.Count == 0)
             {
                 return Ok("沒有可用客戶連接信息"); // No available client connection info.
             }


             // 為全局靜態(tài)數(shù)組分配空間
             ReaderClients.Clients = new ReaderClientInfo[clientInfos.Count];


             // 用于追蹤失敗的連接，以便存儲到全局?jǐn)?shù)組中
             for (int i = 0; i < clientInfos.Count; i++)
             {
                 var clientInfo = clientInfos[i];
                 // 嘗試與讀卡器設(shè)備建立連接
                 var res = _reader.ReaderConnection(ref clientInfo);
                 if (res.IsSucceed)
                 {
                     // 連接成功，記錄成功信息
                     result.AppendLine($"{DateTime.Now:yyyy/MM/dd HH:mm:ss}>>>與掃碼器設(shè)備通信連接成功:{res.Message}");
                 }
                 else
                 {
                     // 連接失敗，記錄失敗信息并將客戶端信息存儲到全局靜態(tài)數(shù)組中
                     ReaderClients.Clients[i] = clientInfo;
                     result.AppendLine($"{DateTime.Now:yyyy/MM/dd HH:mm:ss}>>>通信連接失敗");
                 }
             }


             // 返回所有連接結(jié)果
             return Ok(result.ToString());
         }
         catch (Exception ex)
         {
             // 異常處理，返回異常信息
             return Ok($"{DateTime.Now:yyyy/MM/dd HH:mm:ss}>>>通信連接失敗: {ex.Message}");
         }
     }


     [HttpPost]
     public IActionResult BeginScanner(int count)
     {
         const string timeFormat = "yyyy/MM/dd HH:mm:ss";
         StringBuilder result = new StringBuilder();
         if (ReaderClients.Clients == null || !ReaderClients.Clients.Any())
         {
             return Ok($"{DateTime.Now.ToString(timeFormat)} >>> 沒有可連接的掃碼器客戶端，無法啟動掃描功能。");
         }
         try
         {
             for (int now = 1; now <= count; now++)
             {
                 var res = _reader.ReaderRead(ref ReaderClients.Clients[0]); // 假設(shè)第一個客戶端已連接。下標(biāo)0代表第一個掃碼器，請根據(jù)實際情況修改。
                 if (res.IsSucceed)
                 {
                     result.AppendLine($"{DateTime.Now.ToString(timeFormat)} >>> 第{now}次掃碼，掃碼結(jié)果：{res.Message}");
                 }
                 else
                 {
                     result.AppendLine($"{DateTime.Now.ToString(timeFormat)} >>> 第{now}次掃碼，掃碼失?。簕res.Value} 掃碼耗時：{res.ElapsedMilliseconds}毫秒");
                 }
             }
         }
         catch (Exception ex)
         {
             result.AppendLine($"{DateTime.Now.ToString(timeFormat)} >>> 掃碼異常：{ex.Message}");
         }
         return Ok(result.ToString());
     }
 }

其他介紹：掃碼器配置參數(shù)和通用返回值參數(shù)對應(yīng)實體類說明。

掃碼器客戶端配置實體類：

/// <summary>
/// Represents the client configuration for a scanner.
/// 表示掃描器的客戶端配置。
/// </summary>
public class ReaderClientInfo
{
    /// <summary>
    /// The IP address of the scanner.
    /// 掃描器的IP地址。
    /// </summary>
    public IPAddress Ip { get; set; }


    /// <summary>
    /// The port number for the scanner connection.
    /// 掃描器連接的端口號。
    /// </summary>
    public int Port { get; set; }


    /// <summary>
    /// Number of retry attempts if no code is scanned.
    /// 如果沒有掃描到碼的重試次數(shù)。
    /// </summary>
    public short Count { get; set; }


    /// <summary>
    /// The socket connection to the scanner.
    /// 掃描器的Socket連接。
    /// </summary>
    public Socket Client { get; set; }


    /// <summary>
    /// The identifier number of the scanner.
    /// 掃描器的編號。
    /// </summary>
    public ushort ReaderNo { get; set; }


    /// <summary>
    /// Timeout in milliseconds for sending requests.
    /// 發(fā)送請求的超時時間（毫秒）。
    /// </summary>
    public int SendTimeOut { get; set; } = 3000;


    /// <summary>
    /// Timeout in milliseconds for receiving responses.
    /// 接收響應(yīng)的超時時間（毫秒）。
    /// </summary>
    public int ReceiveTimeOut { get; set; } = 3000;


    /// <summary>
    /// The brand of the scanner, such as Keyence, Cognex, OPT, etc.
    /// 掃描器的品牌，例如基恩士、康耐視、OPT等等。
    /// </summary>
    public string Brand { get; set; }


    /// <summary>
    /// Command to trigger the scan.
    /// 觸發(fā)掃描的命令。
    /// </summary>
    public string Command { get; set; }


    /// <summary>
    /// Command to stop triggering the scanner (used by Keyence).
    /// 停止觸發(fā)掃描器的命令（基恩士使用）。
    /// </summary>
    public string CloseCommand { get; set; }


    /// <summary>
    /// Start character for commands, if applicable (empty string if none).
    /// 命令的起始字符（如果有），沒有則為空字符串。
    /// </summary>
    public string Start { get; set; } = string.Empty;


    /// <summary>
    /// End character for commands, such as '\r\n' for Keyence; empty if not used.
    /// 命令的結(jié)束字符，如基恩士使用的'\r\n'；如果不使用則為空字符串。
    /// </summary>
    public string End { get; set; } = string.Empty;
}

返回值實體類：

/// <summary>
/// Represents the result information from a scanner.
/// 表示掃描器的結(jié)果信息。
/// </summary>
public class ReaderResultInfo
{
/// <summary>
/// Indicates whether the scan was successful.
/// 指示掃描是否成功。
/// </summary>
public bool IsSucceed { get; set; } = false;


/// <summary>
/// The error message if the scan failed.
/// 如果掃描失敗，錯誤信息。
/// </summary>
public string Message { get; set; } = string.Empty;


/// <summary>
/// The result of the scan.
/// 掃描結(jié)果。
/// </summary>
public string Value { get; set; } = string.Empty;


/// <summary>
/// The time taken for the scan in milliseconds.
/// 掃描所耗費的時間（毫秒）。
/// </summary>
public long ElapsedMilliseconds { get; set; } = 0;


/// <summary>
/// The number identifying the scanner.
/// 掃描器編號。
/// </summary>
public ushort ReaderNo { get; set; } = 0;


/// <summary>
/// The brand of the scanner.
/// 掃描器品牌。
/// </summary>
public string Brand { get; set; } = string.Empty;
}

轉(zhuǎn)自微信公眾號Dotnet Dancer