.NET MAUI 條碼掃描器 SDK：幾分鐘內建置跨平台掃描器

我們都知道 .NET MAUI 的承諾：一次寫好程式碼，隨處部署。 但是，當您需要整合硬體功能 (特別是 BarCode 掃描) 時，這種"無縫"的體驗往往會遇到障礙。

如果您曾經嘗試過以手動方式橋接原生攝影機 API，您就會知道這很快就會變成平台特定配置的兔子洞。 這並不難。 在本教程中，我們將跳過數小時的設定，使用 IronBarcode 函式庫，在短短幾分鐘內建立一個可運作的跨平台掃描器。

準備好開始？ 取得您的免費試用版，讓我們一起編碼。

!{--010011000100100101000010010100100100000101010010010110010101111101001110010101010101010101010101010101010101010 0100010111110100100101001101010100010000010100110001001100010111110100001001001100010011110010101010

如何在 .NET MAUI 中設定 BarCode Scanner SDK？ 設定 .NET MAUI BarCode 掃描器 SDK 需要建立新專案、安裝 NuGet 套件以及設定平台權限。 整個設定過程只需在 Visual Studio 中花費幾分鐘即可完成。 ### 建立 .NET MAUI 專案 開啟 Visual Studio 並建立新的 .NET MAUI App 專案。 將您的 MAUI 專案命名為描述性的名稱，例如"BarcodeScanner"，並選擇 .NET 8 或更新版本作為您的目標框架。 Visual Studio 會產生預設的專案結構，並針對 Android 和 iOS 設定特定平台的資料夾。 ### 安裝 IronBarcode。 使用套件管理員控制台安裝 IronBarcode NuGet 套件： ```shell :ProductInstall ``` 此指令會下載並安裝條碼掃描器 SDK 以及所有 .NET MAUI 應用程式所需的相依性。 ### 設定平台權限 即使是從影像檔案而非即時攝影機進行掃描，為您的 .NET MAUI 條碼掃描器應用程式設定下列權限也是良好的做法。 針對 Android，請在 Platforms/Android/AndroidManifest.xml 中加入下列內容： ```xml ``` 對於 iOS，請將這些項目新增至 Platforms/iOS/Info.plist： ```xml NSPhotoLibraryUsageDescription Access needed to select barcode images for scanning. NSCameraUsageDescription Camera permission for barcode scanning. ``` ### 初始化 SDK 在您的 MauiProgram.cs 檔案中設定 IronBarcode： ```csharp public static class MauiProgram { public static MauiApp CreateMauiApp() { var builder = MauiApp.CreateBuilder(); builder .UseMauiApp() .ConfigureFonts(fonts => { fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular"); }); return builder.Build(); } } ``` 在應用程式的初始化程式碼中設定您的授權金鑰，以啟用完整的功能。 IronBarcode 提供[免費試用授權](trial-license)供開發及測試使用。

如何從影像檔中讀取 BarCode？ 任何 MAUI 條碼掃描器的核心功能都是能夠從選取的影像中讀取條碼。 IronBarcode 的 BarcodeReader 類讓這一切變得非常簡單。 ### 設計使用者介面 在 MainPage.xaml 中建立簡潔的介面，讓使用者可以選擇影像檔案並檢視掃描的 BarCode 資料： ```xml ``` ### 實施 BarCode 掃描 將掃描邏輯新增至 MainPage.xaml.cs。 此程式碼處理影像選擇與 BarCode 偵測： ```csharp using IronBarCode; public partial class MainPage : ContentPage { public MainPage() { InitializeComponent(); } private async void OnSelectImageClicked(object sender, EventArgs e) { var result = await FilePicker.PickAsync(new PickOptions { FileTypes = FilePickerFileType.Images, PickerTitle = "Select a barcode image" }); if (result != null) { // Display the selected image SelectedImageView.Source = ImageSource.FromFile(result.FullPath); // Read barcodes from the image file var barcodes = BarcodeReader.Read(result.FullPath); if (barcodes.Any()) { ResultLabel.Text = $"Found: {barcodes.First().Value}"; } else { ResultLabel.Text = "No barcodes detected in selected image."; } } } } ``` ### 輸出  `BarcodeReader.Read()` 方法會分析選取的影像，並傳回所有偵測到的條碼。 IronBarcode 可自動辨識多種條碼符號，包括 QR 碼、Code 128、Code 39、EAN-13 以及 [許多其他格式](/csharp/barcode/docs/)。

如何從 PDF 文件掃描 BarCode？ IronBarcode 與眾不同的一項強大功能是直接從 PDF 檔案讀取條碼。 這對於處理文件工作流程的 .NET MAUI 應用程式來說至關重要。 ```csharp private async void OnSelectPdfClicked(object sender, EventArgs e) { var result = await FilePicker.PickAsync(new PickOptions { PickerTitle = "Select a PDF with barcodes" }); if (result != null) { // Read barcodes from PDF document var barcodes = BarcodeReader.ReadPdf(result.FullPath); string output = ""; foreach (var barcode in barcodes) { output += $"Page {barcode.PageNumber}: {barcode.Value}\n"; } await DisplayAlert("Scan Results", output, "OK"); } } ``` ### 輸出 。 `ReadPdf()`方法會掃描 PDF 的所有頁面，並將條碼資料與頁碼一併傳回，讓您可以輕鬆處理包含多個條碼的文件。

如何處理多個 BarCode 和 QR 碼？ 對於需要從單一掃描檢測多個條碼或特定條碼格式過濾的情況，請設定 BarcodeReaderOptions 類： ```csharp var options = new BarcodeReaderOptions { ExpectMultipleBarcodes = true, ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128, Speed = ReadingSpeed.Balanced }; var barcodes = BarcodeReader.Read(imagePath, options); foreach (var barcode in barcodes) { Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}"); } ``` 此配置可掃描多種條碼，同時將偵測範圍限制在特定條碼符號，以提高效能。 速度屬性可讓您根據應用程式的需求，在掃描速度與精確度之間取得平衡。

此 BarCode SDK 的主要優點為何？ IronBarcode 為 .NET MAUI 條碼掃描專案提供多項優點： * 跨平台支援：從單一代碼庫部署至 Android、iOS 平台和 Windows * 多種輸入來源：掃描影像、記憶體串流和 PDF 檔案中的 BarCode * 廣泛的格式支援：解碼數十種 1D 和 2D 條碼符號的 BarCode * 簡單的 API：僅需幾行程式碼即可整合快速的 BarCode 掃描功能 * 無外部依賴：.NET 函式庫可獨立運作，不需要額外的原生 SDK ## 結論 使用 IronBarcode 建立一個 .NET MAUI 條碼掃描器，展示了如何簡單直接地將條碼掃描功能整合到跨平台應用程式中。 從安裝 NuGet 套件到從影像和 PDF 讀取 BarCode，整個過程只需要最少的設定和程式碼。 .NET MAUI 的跨平台框架功能與 IronBarcode 強大的掃描 SDK 相結合，使開發人員能夠建立功能強大的條碼掃描應用程式，並在移動和桌面上無縫運行。 準備好在您的 .NET MAUI 專案中加入 BarCode 掃描功能了嗎？ [開始免費試用](trial-license)或[探索生產部署的授權選項](/csharp/barcode/licensing/)。