ZXing.Net.Mobile 技术文档

1. 安装指南

ZXing.Net.Mobile 是一个基于开源条码库 ZXing (Zebra Crossing) 的 C#/.NET 库，支持 Xamarin.iOS、Xamarin.Android、Tizen 和 UWP。以下是安装方式：

通过 NuGet 包管理器安装：

Install-Package ZXing.Net.Mobile

2. 项目使用说明

ZXing.Net.Mobile 提供了非常简单的 API 用于扫描条码。下面是一个最简单的使用示例：

buttonScan.Click += (sender, e) => {
    #if __ANDROID__
    // 在 Android 上初始化扫描器，以便它可以跟踪当前上下文
    MobileBarcodeScanner.Initialize (Application);
    #endif

    var scanner = new ZXing.Mobile.MobileBarcodeScanner();
    var result = await scanner.Scan();

    if (result != null)
        Console.WriteLine("扫描的条码: " + result.Text);
};

3. 项目API使用文档

以下是部分主要 API 的使用说明：

• MobileBarcodeScanner.Initialize(Application)：在 Android 平台上初始化扫描器。
• scanner.Scan()：启动扫描流程，返回扫描结果。
• scanner.Scan(options)：启动扫描流程，可以指定扫描选项。
• scanner.UseCustomOverlay = true：使用自定义覆盖层。
• scanner.CustomOverlay = myCustomOverlayInstance：指定自定义覆盖层实例。

扫描选项 MobileBarcodeScanningOptions 可以指定需要扫描的条码格式：

var options = new ZXing.Mobile.MobileBarcodeScanningOptions();
options.PossibleFormats = new List<ZXing.BarcodeFormat>() { 
    ZXing.BarcodeFormat.Ean8, ZXing.BarcodeFormat.Ean13 
};

4. 项目安装方式

如前所述，ZXing.Net.Mobile 可以通过 NuGet 包管理器进行安装：

Install-Package ZXing.Net.Mobile

在各个平台上的初始化步骤如下：

• Android：在主 Activity 的 OnCreate 方法中调用 Xamarin.Essentials.Platform.Init(Application) 和 ZXing.Net.Mobile.Forms.Android.Platform.Init()。

• iOS：在 AppDelegate 的 FinishedLaunching 方法中调用 ZXing.Net.Mobile.Forms.iOS.Platform.Init()。

• Windows Universal UWP：在主 Page 的构造函数中添加 ZXing.Net.Mobile.Forms.WindowsUniversal.Platform.Init()。

• macOS：在 AppDelegate 的 FinishedLaunching 方法中调用 ZXing.Net.Mobile.Forms.MacOS.Platform.Init()。

以上就是关于 ZXing.Net.Mobile 的技术文档，详细介绍了安装指南、使用说明以及 API 使用文档。希望对您有所帮助。