C# USBバーコードスキャナ：完全なスキャンアプリケーションを構築する

HIDキーボードのウェッジモードが統合を簡素化する理由とは？

ほとんどのUSBバーコードスキャナーは、デフォルトでHIDキーボードウェッジモードに設定されて出荷されます。 Windowsマシンに接続すると、オペレーティングシステムはそれをUSBストレージデバイス（設定用）とキーボード（データ入力用）の両方として認識します。 バーコードがスキャンされると、デバイスはデコードされたバーコード値をキーストロークに変換し、フォーカスのあるアプリケーションウィンドウに送信し、最後に改行を追加します。

C#開発者の視点から見ると、これはベンダーのSDK、COMライブラリ、特別なUSB APIが不要であることを意味します。入力を取得するには、KeyDownハンドラーを備えた標準的なTextBoxだけで十分です。 主な統合上の課題は、スキャナー入力と実際のキーボード入力を区別することである。 スキャナーは通常、非常に短い時間（多くの場合50ミリ秒未満）で全ての文字を出力するのに対し、人間のタイピングではキーストロークが数百ミリ秒にわたって分散される。 連打のタイミングを計ることは、意図しないキー入力を排除する確実な方法です。

プロ仕様のスキャナは、シリアル（RS-232または仮想COMポート）モードと直接USB HIDモードもサポートしており、接頭辞/接尾辞文字やスキャントリガーをより細かく制御できます。 以下のインターフェースパターンは、両方のケースに対応します。

public interface IScannerInput
{
    event EventHandler<string> BarcodeScanned;
    void StartListening();
    void StopListening();
}

public class KeyboardWedgeScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly TextBox _inputBox;
    private readonly System.Windows.Forms.Timer _burstTimer;
    private readonly System.Text.StringBuilder _buffer = new();

    public KeyboardWedgeScanner(TextBox inputBox)
    {
        _inputBox = inputBox;
        _burstTimer = new System.Windows.Forms.Timer { Interval = 80 };
        _burstTimer.Tick += OnBurstTimeout;
        _inputBox.KeyPress += OnKeyPress;
    }

    private void OnKeyPress(object sender, KeyPressEventArgs e)
    {
        if (e.KeyChar == (char)Keys.Enter)
        {
            _burstTimer.Stop();
            string value = _buffer.ToString().Trim();
            _buffer.Clear();
            if (value.Length > 0)
                BarcodeScanned?.Invoke(this, value);
        }
        else
        {
            _buffer.Append(e.KeyChar);
            _burstTimer.Stop();
            _burstTimer.Start();
        }
        e.Handled = true;
    }

    private void OnBurstTimeout(object sender, EventArgs e)
    {
        _burstTimer.Stop();
        _buffer.Clear(); // incomplete burst -- discard
    }

    public void StartListening() => _inputBox.Focus();
    public void StopListening() => _inputBox.Enabled = false;
}

public class SerialPortScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly System.IO.Ports.SerialPort _port;

    public SerialPortScanner(string portName, int baudRate = 9600)
    {
        _port = new System.IO.Ports.SerialPort(portName, baudRate);
        _port.DataReceived += OnDataReceived;
    }

    private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
    {
        string data = _port.ReadLine().Trim();
        if (data.Length > 0)
            BarcodeScanned?.Invoke(this, data);
    }

    public void StartListening() => _port.Open();
    public void StopListening() => _port.Close();
}

public interface IScannerInput
{
    event EventHandler<string> BarcodeScanned;
    void StartListening();
    void StopListening();
}

public class KeyboardWedgeScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly TextBox _inputBox;
    private readonly System.Windows.Forms.Timer _burstTimer;
    private readonly System.Text.StringBuilder _buffer = new();

    public KeyboardWedgeScanner(TextBox inputBox)
    {
        _inputBox = inputBox;
        _burstTimer = new System.Windows.Forms.Timer { Interval = 80 };
        _burstTimer.Tick += OnBurstTimeout;
        _inputBox.KeyPress += OnKeyPress;
    }

    private void OnKeyPress(object sender, KeyPressEventArgs e)
    {
        if (e.KeyChar == (char)Keys.Enter)
        {
            _burstTimer.Stop();
            string value = _buffer.ToString().Trim();
            _buffer.Clear();
            if (value.Length > 0)
                BarcodeScanned?.Invoke(this, value);
        }
        else
        {
            _buffer.Append(e.KeyChar);
            _burstTimer.Stop();
            _burstTimer.Start();
        }
        e.Handled = true;
    }

    private void OnBurstTimeout(object sender, EventArgs e)
    {
        _burstTimer.Stop();
        _buffer.Clear(); // incomplete burst -- discard
    }

    public void StartListening() => _inputBox.Focus();
    public void StopListening() => _inputBox.Enabled = false;
}

public class SerialPortScanner : IScannerInput
{
    public event EventHandler<string> BarcodeScanned;
    private readonly System.IO.Ports.SerialPort _port;

    public SerialPortScanner(string portName, int baudRate = 9600)
    {
        _port = new System.IO.Ports.SerialPort(portName, baudRate);
        _port.DataReceived += OnDataReceived;
    }

    private void OnDataReceived(object sender, System.IO.Ports.SerialDataReceivedEventArgs e)
    {
        string data = _port.ReadLine().Trim();
        if (data.Length > 0)
            BarcodeScanned?.Invoke(this, data);
    }

    public void StartListening() => _port.Open();
    public void StopListening() => _port.Close();
}

キーボードウェッジ実装におけるバーストタイマーが重要なポイントです。 キー入力のたびにリセットされ、文字の入力が停止した場合にのみ作動します。つまり、キーボード入力が遅い通常のユーザーの場合、入力が不完全な場合はバーコードスキャンとして扱われるのではなく、入力内容が破棄されます。

複数のスキャナーブランドをどのように扱っていますか？

Enterprise環境では、ハネウェル、ゼブラ(旧シンボル／モトローラ)、データロジックのスキャナが同じフロアで混在して使用されていることがよくある。 各ベンダーは、独自のデフォルトの終端文字、ボーレート、および接頭辞／接尾辞の規則を持っています。 構成モデルによって、アプリケーションの柔軟性が維持されます。

public class ScannerConfiguration
{
    public string ScannerType { get; set; } = "KeyboardWedge";
    public string PortName { get; set; } = "COM3";
    public int BaudRate { get; set; } = 9600;
    public string Terminator { get; set; } = "\r\n";
    public bool EnableBeep { get; set; } = true;
    public Dictionary<string, string> BrandSettings { get; set; } = new();

    public static ScannerConfiguration GetHoneywellConfig() => new()
    {
        ScannerType = "Serial",
        BaudRate = 115200,
        BrandSettings = new Dictionary<string, string>
        {
            { "Prefix", "STX" },
            { "Suffix", "ETX" },
            { "TriggerMode", "Manual" }
        }
    };

    public static ScannerConfiguration GetZebraConfig() => new()
    {
        ScannerType = "KeyboardWedge",
        BrandSettings = new Dictionary<string, string>
        {
            { "ScanMode", "Continuous" },
            { "BeepVolume", "High" }
        }
    };
}

public class ScannerConfiguration
{
    public string ScannerType { get; set; } = "KeyboardWedge";
    public string PortName { get; set; } = "COM3";
    public int BaudRate { get; set; } = 9600;
    public string Terminator { get; set; } = "\r\n";
    public bool EnableBeep { get; set; } = true;
    public Dictionary<string, string> BrandSettings { get; set; } = new();

    public static ScannerConfiguration GetHoneywellConfig() => new()
    {
        ScannerType = "Serial",
        BaudRate = 115200,
        BrandSettings = new Dictionary<string, string>
        {
            { "Prefix", "STX" },
            { "Suffix", "ETX" },
            { "TriggerMode", "Manual" }
        }
    };

    public static ScannerConfiguration GetZebraConfig() => new()
    {
        ScannerType = "KeyboardWedge",
        BrandSettings = new Dictionary<string, string>
        {
            { "ScanMode", "Continuous" },
            { "BeepVolume", "High" }
        }
    };
}

これらの設定を構成ファイルまたはデータベースに保存することで、倉庫スタッフは再配置を必要とせずにスキャナーのモデルを交換できるようになります。 ScannerType フィールドは、起動時にどの IScannerInput 実装がインスタンス化されるかを決定します。

NuGetを介してIronBarcodeを追加する最速の方法は何ですか？

Visual StudioでPackage Manager Consoleを開き、実行してください：

Install-Package IronBarCode

Install-Package IronBarCode

または、 .NET CLI を使用してください。

dotnet add package IronBarCode

dotnet add package IronBarCode

どちらのコマンドも、 NuGetから最新リリースを取得し、アセンブリ参照をプロジェクトファイルに追加します。このライブラリは.NET Standard 2.0 を対象としているため、追加の互換性シムなしで.NET Framework 4.6.2 から.NET 10 まで動作します。

インストール後、 IronBarcodeのメソッドを呼び出す前にライセンスキーを設定してください。 開発および評価目的では、IronBarcodeのライセンスページから無料トライアルキーを入手できます。

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

コンテナ化されたデプロイメントの場合、 IronBarcodeはLinux上のDockerと連携し、クラウド関数に関してはAWS LambdaとAzure Functionsをサポートしています。

フォーマット検証における最適なアプローチとは？

IronBarcodeは、Code 128 、 EAN-13 、 Code 39 、 QRコード、データマトリックスなど、 IronBarcode種類以上のバーコードシンボルをサポートしています。 USBスキャナアプリケーションの場合、検証パターンはスキャンされた文字列をバーコード画像として再エンコードし、デコーダを通して直ちに読み戻します。 この往復通信により、文字列が宣言されたフォーマットに対して有効な値であることが確認されます。

public class BarcodeValidator
{
    public async Task<ValidationResult> ValidateAsync(string scannedText, BarcodeEncoding preferredFormat = BarcodeEncoding.Code128)
    {
        var result = new ValidationResult { RawInput = scannedText };

        try
        {
            var barcode = BarcodeWriter.CreateBarcode(scannedText, preferredFormat);
            var readResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());

            if (readResults.Any())
            {
                var first = readResults.First();
                result.IsValid = true;
                result.Format = first.BarcodeType;
                result.Value = first.Value;
                result.Confidence = first.Confidence;
            }
            else
            {
                result.IsValid = false;
                result.Error = "No barcode could be decoded from the scanned input.";
            }
        }
        catch (Exception ex)
        {
            result.IsValid = false;
            result.Error = ex.Message;
        }

        return result;
    }
}

public record ValidationResult
{
    public string RawInput { get; init; } = "";
    public bool IsValid { get; set; }
    public BarcodeEncoding Format { get; set; }
    public string Value { get; set; } = "";
    public float Confidence { get; set; }
    public string Error { get; set; } = "";
}

public class BarcodeValidator
{
    public async Task<ValidationResult> ValidateAsync(string scannedText, BarcodeEncoding preferredFormat = BarcodeEncoding.Code128)
    {
        var result = new ValidationResult { RawInput = scannedText };

        try
        {
            var barcode = BarcodeWriter.CreateBarcode(scannedText, preferredFormat);
            var readResults = await BarcodeReader.ReadAsync(barcode.ToBitmap());

            if (readResults.Any())
            {
                var first = readResults.First();
                result.IsValid = true;
                result.Format = first.BarcodeType;
                result.Value = first.Value;
                result.Confidence = first.Confidence;
            }
            else
            {
                result.IsValid = false;
                result.Error = "No barcode could be decoded from the scanned input.";
            }
        }
        catch (Exception ex)
        {
            result.IsValid = false;
            result.Error = ex.Message;
        }

        return result;
    }
}

public record ValidationResult
{
    public string RawInput { get; init; } = "";
    public bool IsValid { get; set; }
    public BarcodeEncoding Format { get; set; }
    public string Value { get; set; } = "";
    public float Confidence { get; set; }
    public string Error { get; set; } = "";
}

サプライチェーンアプリケーションで使用されるGS1-128バーコードの場合、スキャンされた文字列には、GTINの場合は(17)のように、括弧内にアプリケーション識別子の接頭辞が含まれます。 IronBarcode は、BarcodeEncoding.GS1_128 を指定すると、これらのアプリケーション識別子を自動的に解析します。

開発者はどのEAN-13チェックサムロジックを実装すべきか？

小売店のPOSアプリケーションでは、価格検索に値を渡す前に、EAN-13チェックデジットを個別に検証する必要がある場合がよくあります。EAN-13のLuhnアルゴリズムによるチェックサムは、最初の12桁で1と3の重みが交互に現れます。

public static bool ValidateEan13Checksum(string value)
{
    if (value.Length != 13 || !value.All(char.IsDigit))
        return false;

    int sum = 0;
    for (int i = 0; i < 12; i++)
    {
        int digit = value[i] - '0';
        sum += (i % 2 == 0) ? digit : digit * 3;
    }

    int expectedCheck = (10 - (sum % 10)) % 10;
    return expectedCheck == (value[12] - '0');
}

public static bool ValidateEan13Checksum(string value)
{
    if (value.Length != 13 || !value.All(char.IsDigit))
        return false;

    int sum = 0;
    for (int i = 0; i < 12; i++)
    {
        int digit = value[i] - '0';
        sum += (i % 2 == 0) ? digit : digit * 3;
    }

    int expectedCheck = (10 - (sum % 10)) % 10;
    return expectedCheck == (value[12] - '0');
}

この純粋な論理チェックはエンコード前に実行され、大量のデータを扱う小売環境において、スキャンごとに往復画像生成を行うオーバーヘッドを回避する。 GS1の仕様によると、先頭のゼロを削除した場合、UPC-A(12桁)のチェックデジットアルゴリズムは同じです。

アプリケーションはスキャン後にいつ新しいバーコードを作成すべきでしょうか？

倉庫での受入業務でよく見られるのは、"スキャンしてラベルを貼り直す"というワークフローです。入荷品には仕入先のバーコード(多くの場合EAN-13またはITF-14)が付いており、倉庫管理システムは、独自のロケーションコードとロットコードが記載された内部コード128ラベルを印刷する必要があります。 IronBarcodeの生成機能を使えば、これを数行で処理できます。

public class InventoryLabelGenerator
{
    private readonly string _outputDirectory;

    public InventoryLabelGenerator(string outputDirectory)
    {
        _outputDirectory = outputDirectory;
        Directory.CreateDirectory(_outputDirectory);
    }

    public async Task<string> GenerateLabelAsync(string internalCode, string locationCode)
    {
        string fullCode = $"{internalCode}|{locationCode}|{DateTime.UtcNow:yyyyMMdd}";

        // Primary Code 128 label for scanners
        var linearBarcode = BarcodeWriter.CreateBarcode(fullCode, BarcodeEncoding.Code128);
        linearBarcode.ResizeTo(500, 140);
        linearBarcode.SetMargins(12);
        linearBarcode.AddAnnotationTextAboveBarcode(fullCode);
        linearBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);

        // QR code companion for mobile apps
        var qrCode = BarcodeWriter.CreateQrCode(fullCode);
        qrCode.ResizeTo(200, 200);
        qrCode.SetMargins(8);

        string timestamp = DateTime.UtcNow.ToString("yyyyMMddHHmmss");
        string pngPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.png");
        string pdfPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.pdf");

        await Task.Run(() =>
        {
            linearBarcode.SaveAsPng(pngPath);
            linearBarcode.SaveAsPdf(pdfPath);
        });

        return pngPath;
    }
}

public class InventoryLabelGenerator
{
    private readonly string _outputDirectory;

    public InventoryLabelGenerator(string outputDirectory)
    {
        _outputDirectory = outputDirectory;
        Directory.CreateDirectory(_outputDirectory);
    }

    public async Task<string> GenerateLabelAsync(string internalCode, string locationCode)
    {
        string fullCode = $"{internalCode}|{locationCode}|{DateTime.UtcNow:yyyyMMdd}";

        // Primary Code 128 label for scanners
        var linearBarcode = BarcodeWriter.CreateBarcode(fullCode, BarcodeEncoding.Code128);
        linearBarcode.ResizeTo(500, 140);
        linearBarcode.SetMargins(12);
        linearBarcode.AddAnnotationTextAboveBarcode(fullCode);
        linearBarcode.ChangeBarCodeColor(IronSoftware.Drawing.Color.Black);

        // QR code companion for mobile apps
        var qrCode = BarcodeWriter.CreateQrCode(fullCode);
        qrCode.ResizeTo(200, 200);
        qrCode.SetMargins(8);

        string timestamp = DateTime.UtcNow.ToString("yyyyMMddHHmmss");
        string pngPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.png");
        string pdfPath = Path.Combine(_outputDirectory, $"{internalCode}_{timestamp}.pdf");

        await Task.Run(() =>
        {
            linearBarcode.SaveAsPng(pngPath);
            linearBarcode.SaveAsPdf(pdfPath);
        });

        return pngPath;
    }
}

PDF形式で保存する機能は、ネットワーク共有経由でPDF入力を受け付けるラベルプリンターにとって特に便利です。 ベクター品質のサーマルラベル出力用にSVG形式でエクスポートすることも、ラベルプリンターAPIに直接送信するためにバイトストリームとしてエクスポートすることもできます。

IronBarcodeは、カスタムカラー、余白調整、人間が読みやすいテキストオーバーレイ、QRコードの場合はブランドロゴ入りのモバイルラベルへのロゴ埋め込みなど、幅広いスタイルカスタマイズをサポートしています。

本番環境におけるキューベースの実装はどのようなものですか？

1分間に数十回のスキャンを処理するアプリケーションでは、UIスレッド上の単純な同期ハンドラがボトルネックとなる。 以下のパターンでは、ConcurrentQueue<t> とバックグラウンド処理ループを使用して、スキャンキャプチャと処理を分離しています。IronBarcodeの非同期 API は、 UI をブロックすることなく検証を処理します。

using IronBarCode;
using System.Collections.Concurrent;

public partial class HighVolumeScanner : Form
{
    private readonly ConcurrentQueue<(string Data, DateTime Timestamp)> _scanQueue = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly CancellationTokenSource _cts = new();
    private IScannerInput _scanner;

    public HighVolumeScanner()
    {
        InitializeComponent();
        IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
        _semaphore = new SemaphoreSlim(Environment.ProcessorCount);
        InitializeScanner();
        _ = RunProcessingLoopAsync();
    }

    private void InitializeScanner()
    {
        _scanner = System.IO.Ports.SerialPort.GetPortNames().Any()
            ? new SerialPortScanner("COM3", 115200)
            : new KeyboardWedgeScanner(txtScannerInput);

        _scanner.BarcodeScanned += (_, barcode) =>
            _scanQueue.Enqueue((barcode, DateTime.UtcNow));

        _scanner.StartListening();
    }

    private async Task RunProcessingLoopAsync()
    {
        while (!_cts.Token.IsCancellationRequested)
        {
            if (_scanQueue.TryDequeue(out var scan))
            {
                await _semaphore.WaitAsync(_cts.Token);
                _ = Task.Run(async () =>
                {
                    try { await ProcessScanAsync(scan.Data, scan.Timestamp); }
                    finally { _semaphore.Release(); }
                }, _cts.Token);
            }
            else
            {
                await Task.Delay(10, _cts.Token);
            }
        }
    }

    private async Task ProcessScanAsync(string rawData, DateTime scanTime)
    {
        var options = new BarcodeReaderOptions
        {
            Speed = ReadingSpeed.Balanced,
            ExpectMultipleBarcodes = false,
            ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode,
            MaxParallelThreads = 1
        };

        var testBarcode = BarcodeWriter.CreateBarcode(rawData, BarcodeEncoding.Code128);
        var results = await BarcodeReader.ReadAsync(testBarcode.ToBitmap(), options);

        if (results.Any())
        {
            var item = results.First();
            BeginInvoke(() => UpdateInventoryDisplay(item.Value, scanTime));
        }
        else
        {
            BeginInvoke(() => LogRejectedScan(rawData, scanTime));
        }
    }

    protected override void OnFormClosing(FormClosingEventArgs e)
    {
        _cts.Cancel();
        _scanner.StopListening();
        base.OnFormClosing(e);
    }
}

using IronBarCode;
using System.Collections.Concurrent;

public partial class HighVolumeScanner : Form
{
    private readonly ConcurrentQueue<(string Data, DateTime Timestamp)> _scanQueue = new();
    private readonly SemaphoreSlim _semaphore;
    private readonly CancellationTokenSource _cts = new();
    private IScannerInput _scanner;

    public HighVolumeScanner()
    {
        InitializeComponent();
        IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
        _semaphore = new SemaphoreSlim(Environment.ProcessorCount);
        InitializeScanner();
        _ = RunProcessingLoopAsync();
    }

    private void InitializeScanner()
    {
        _scanner = System.IO.Ports.SerialPort.GetPortNames().Any()
            ? new SerialPortScanner("COM3", 115200)
            : new KeyboardWedgeScanner(txtScannerInput);

        _scanner.BarcodeScanned += (_, barcode) =>
            _scanQueue.Enqueue((barcode, DateTime.UtcNow));

        _scanner.StartListening();
    }

    private async Task RunProcessingLoopAsync()
    {
        while (!_cts.Token.IsCancellationRequested)
        {
            if (_scanQueue.TryDequeue(out var scan))
            {
                await _semaphore.WaitAsync(_cts.Token);
                _ = Task.Run(async () =>
                {
                    try { await ProcessScanAsync(scan.Data, scan.Timestamp); }
                    finally { _semaphore.Release(); }
                }, _cts.Token);
            }
            else
            {
                await Task.Delay(10, _cts.Token);
            }
        }
    }

    private async Task ProcessScanAsync(string rawData, DateTime scanTime)
    {
        var options = new BarcodeReaderOptions
        {
            Speed = ReadingSpeed.Balanced,
            ExpectMultipleBarcodes = false,
            ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode,
            MaxParallelThreads = 1
        };

        var testBarcode = BarcodeWriter.CreateBarcode(rawData, BarcodeEncoding.Code128);
        var results = await BarcodeReader.ReadAsync(testBarcode.ToBitmap(), options);

        if (results.Any())
        {
            var item = results.First();
            BeginInvoke(() => UpdateInventoryDisplay(item.Value, scanTime));
        }
        else
        {
            BeginInvoke(() => LogRejectedScan(rawData, scanTime));
        }
    }

    protected override void OnFormClosing(FormClosingEventArgs e)
    {
        _cts.Cancel();
        _scanner.StopListening();
        base.OnFormClosing(e);
    }
}

SemaphoreSlim は、同時検証タスクを論理プロセッサの数に制限し、バーストスキャンイベント中にスレッドが暴走するのを防ぎます。 BeginInvoke は、UI の更新を安全にメインスレッドにマーシャリングします。

スキャン量に応じてパフォーマンスを調整するにはどうすれば良いですか？

BarcodeReaderOptions.Speed プロパティは、ReadingSpeed.Balanced、および ReadingSpeed.Detailed を受け入れます。 文字列値が既知であるUSBスキャナ入力の場合、Balanced が適切です。デコーダはフォーマットを確認するだけでよく、画像内のバーコードを探す必要はありません。 IronBarcodeの読み取り速度に関するドキュメントによると、Faster モードでは歪み補正アルゴリズムの一部がスキップされるため、スキャナーの出力がきれいな場合は安全ですが、画像ベースのシナリオでは破損したバーコードが見落とされる可能性があります。

各速度モードをいつ使用すべきかをまとめた表を以下に示します。

USBスキャナーからの入力に加えて画像やPDFも処理するアプリケーションの場合、 IronBarcodeは同じAPIインターフェースを使用してPDFドキュメントや複数ページのTIFFファイルからバーコードを読み取ることができます。

開発者はどのような障害モードを想定しておくべきか？

USBスキャナーアプリケーションは、予測可能な形で不具合を起こす。 最も一般的な問題点とその対策は以下のとおりです。

スキャナの接続解除-- USBスキャナが取り外されると、キーボードウェッジのTextBoxは仮想キーボードを失います。 最も簡単な対策は、_inputBox.Focused を定期的にチェックし、スキャナが接続されている HID デバイスにまだリストされている場合は、それを再フォーカスするタイマーを使用することです。 シリアルスキャナの場合、SerialPort.GetPortNames() は再接続を検出します。

曖昧なバーコード形式― 一部の製品には、複数のシンボル体系で有効なバーコードが付いています。 例えば、12桁の文字列は有効なUPC-Aであると同時に有効なCode 128でもあります。BarcodeReaderOptions に ExpectBarcodeTypes を指定することで、デコーダーを想定されるフォーマットに制約し、曖昧さを排除できます。 IronBarcodeのトラブルシューティングガイドには、フォーマット固有の認識に関するヒントが記載されています。

無効なフォーマット例外-- BarcodeWriter.CreateBarcode が選択されたエンコーディングのルールに違反する文字列 (たとえば、数値のみの EAN-13 フィールド内の英字) を受け取った場合、IronBarCode.Exceptions.InvalidBarcodeException がスローされます。 呼び出しをtry-catchブロックで囲み、文字列のみの検証パスにフォールバックすることで、アプリケーションの実行を維持できます。

キーストロークのタイミング衝突-- オペレーターが同じテキストボックスに手動で入力する環境では、前述のバーストタイマー方式が主な防御策となります。 二次的なガードとして最小文字数が定められています。実際のバーコードのほとんどは少なくとも8文字なので、それより短い文字列はキーボード入力として扱われます。

Microsoft .NETのSystem.IO.Ports.SerialPortに関するドキュメントは、シリアルスキャナの接続に関するトラブルシューティング、特に ReadTimeout および WriteTimeout 設定に関するトラブルシューティングに役立ちます。 小売業における規制遵守のため、 GS1一般仕様では、各アプリケーション識別子の有効な値の範囲が定義されています。

アプリケーションをモバイルプラットフォームやウェブプラットフォームに拡張するにはどうすればよいですか？

上記のスキャナインターフェイスパターン(BarcodeScanned イベント)は、ハードウェアを処理ロジックから抽象化します。 実装を切り替えることで、同じ検証コードと生成コードを異なるプラットフォームで実行できるようになります。

• .NET MAUIは、モバイル受信ステーションとして使用されるAndroidおよびiOSタブレット向けに、カメラベースのスキャナ実装を提供します。
• Blazor Server は、同じ BarcodeScanned イベントにフィードするJavaScriptカメラアクセスを使用したブラウザベースのスキャンをサポートしています
• AndroidおよびiOSネイティブ実装により、モバイル開発者はバックエンドで同じIronBarcodeデコーダを使用してカメラスキャン機能を利用できるようになります。

クラウドネイティブアーキテクチャの場合、検証およびラベル生成の手順は、キューメッセージによってトリガーされるAzure Functionsとして実行でき、デスクトップアプリケーションはスキャナの入力ゲートウェイとしてのみ機能します。 この分離は、コンプライアンス監査のためにラベル印刷ロジックを一元化する必要がある場合に特に有効です。