使用IronBarcode的MAUI條碼掃描器：逐步指南

建置 MAUI 條碼掃描器需要哪些先決條件？

在開始之前，請確保您的開發環境已準備就緒：

• 已安裝.NET MAUI工作負載的Visual Studio 2022 （版本 17.8 或更高版本）。
• .NET 10 SDK -- 從.NET官方網站下載 -具備基本的 C# 知識－熟悉 async/await 模式會有幫助
• 用於相機測試的實體設備或模擬器 IronBarcode許可證－提供免費試用版供評估

在建立專案之前確保 Visual Studio 已安裝 MAUI 工作負載，可以節省後續大量的故障排除時間。 您可以在 Visual Studio 安裝程式的"單一元件"下搜尋".NET多平台應用程式 UI 開發"來驗證這一點。

如何設定 MAUI 條碼掃描項目？

首先在 Visual Studio 2022 中建立一個新的.NET MAUI應用程式專案。將其命名為 BarcodeScannerApp，並選擇.NET 10 作為目標框架。 Visual Studio 會產生標準的 MAUI 專案結構，其中包含 Android、iOS、macOS 和 Windows 等平台特定的資料夾。

Install-Package BarCode

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

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

如何設定安卓和iOS系統的相機權限？

平台特定的相機權限對於條碼掃描功能至關重要。 每個平台都需要在其清單檔案中進行特定配置，然後 MediaPicker.CapturePhotoAsync() 才能成功。

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

如何建立條碼掃描器介面？

在 MainPage.xaml 中設計一個使用者介面，使用戶在掃描過程中獲得清晰的回饋。 簡潔而實用的佈局包括影像預覽、結果顯示區和掃描觸發按鈕：

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </VerticalStackLayout>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </VerticalStackLayout>
</ContentPage>

此佈局提供了兩種掃描路徑：使用相機拍攝新照片和從圖庫中選擇現有影像。 對於使用者預先拍攝條碼或透過電子郵件接收影像的工作流程來說，這一點很重要。 FormatLabel 顯示偵測到的條碼格式以及解碼值，這有助於偵錯和使用者驗證。

如何實現條碼閱讀器功能？

在 MainPage.xaml.cs 中實作核心掃描邏輯。 以下程式碼同時處理相機拍攝和圖庫選擇，並具有適當的非同步模式和錯誤處理：

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

此實作使用共享的 ScanFromSource 輔助方法，以避免在相機和圖庫路徑之間重複影像處理邏輯。 AnyBitmap.FromBytes 方法可自動處理 JPEG、PNG、WebP 和其他常見影像格式—無需手動偵測格式。

結果物件公開了 first.BarcodeType(格式枚舉)和 first.BarcodeImage(偵測到的條碼區域的裁切影像)等屬性。 請參閱BarcodeResult 類別文件以取得完整清單。

如何配置進階掃描選項？

IronBarcode公開了一個 BarcodeReaderOptions 對象，您可以根據特定用例微調檢測行為。 了解這些選項有助於您根據應用程式的需求，在速度和準確性之間取得平衡。

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

您如何處理常見的故障排除場景？

即使使用配置良好的 MAUI 條碼掃描器，也可能出現因裝置特定行為、影像品質問題或平台限製而導致的問題。

下一步計劃是什麼？

現在您已經擁有一個可正常運作的 MAUI 條碼掃描器和IronBarcode，根據您的應用程式需求，有幾種方法可供選擇：

-產生條碼-- IronBarcode包含一個 條碼產生 API ，可根據字串資料建立二維碼、Code 128 標籤和其他格式的條碼。 -批次掃描-- 使用 BarcodeReader.ReadAsync 和 ExpectMultipleBarcodes = true 在循環中處理多個影像檔案； 請參閱批量掃描範例

• PDF 條碼擷取-- IronBarcode可使用相同的 BarcodeReader 類別讀取嵌入在 PDF 文件中的條碼； 查閱PDF 條碼讀取文檔 -樣式和品牌－使用​​顏色、標誌和註釋自訂產生的條碼的視覺輸出； 查看條碼樣式選項 -其他 IronSoftware 產品——如果您的 MAUI 應用還需要 PDF 生成、OCR 或電子表格支持，請探索完整的Iron Suite套件，以獲得一致的跨平台功能。

首先申請免費試用許可證，在評估期內可以不受限制地部署。 有關生產許可選項和批量定價，請訪問IronBarcode定價頁面。 IronBarcode文件入口網站和IronBarcode GitHub儲存庫提供了更多程式碼範例和社群支援。