本主题介绍如何在 UWP 应用程序中设置基本相机条形码扫描仪。

注意

Windows 10/11 内置的软件解码器由 Digimarc Corporation 提供。

以下代码片段仅用于演示目的。 有关完整的工作示例，请参阅条形码扫描仪示例。

注意

软件解码器需要具备网络摄像头功能才能从摄像头接收帧，以解码条形码并在应用程序中提供预览。

使用 BarcodeScanner.GetDeviceSelector 方法之一获取每个连接的条形码扫描仪的 BarcodeScanner 对象。

如果预计设备列表在应用程序的生命周期内不会发生更改，请使用 DeviceInformation.FindAllAsync 获取一次性快照。 但是，如果条形码扫描仪列表在应用程序的生命周期内可能会更改，请改用 DeviceWatcher。

重要

使用 GetDefaultAsync 枚举 PointOfService 设备可能会导致不一致的行为，因为它只返回在类中找到的第一个设备（这可能随会话的变化而改变）。

在此代码片段中，我们将创建一个 DeviceInformationCollection 对象并使用 ****DeviceInformation.FindAllAsync 填充它。

提示

有关使用 DeviceInformation.FindAllAsync 的详细信息，请参阅枚举设备快照。

在此代码片段中，我们使用 DeviceInformation.CreateWatcher 创建一个 DeviceWatcher。

提示

有关详细信息，请参阅枚举和监视设备和 DeviceWatcher。

相机条码扫描仪由一个相机（连接到计算机）和一个软件解码器组成，Windows 会为它们动态配对，从而为通用 Windows 平台 (UWP) 应用程序创建功能齐全的条形码扫描仪。

BarcodeScanner.VideoDeviceID 可用于区分相机条形码扫描仪和物理条形码扫描仪。 非 NULL VideoDeviceID 指示来自设备集合的条形码扫描仪对象是相机条形码扫描仪。 如果具有多个相机条形码扫描仪，可能需要生成一个单独的集合，该集合不包括物理条形码扫描仪。

使用 Windows 附带的解码器的相机条形码扫描仪被标识为：

Microsoft BarcodeScanner（此处为你的相机名称）

如果有多个相机，且这些相机已内置于计算机机箱内，名称中可能会使用 front 和 rear 加以区分。

DeviceWatcher 启动后（请参阅步骤 4：枚举条形码扫描仪），它会枚举每个已连接的设备。 在以下代码片段中，我们将每个可用的扫描仪添加到 BarcodeScanner 集合，并将该集合绑定到 ListBox。

当 ListBox 的 SelectedIndex 更改时（在上一个代码片段中默认选择第一项），我们会查询设备信息（SelectScannerAsync 任务在步骤 6：领取相机条形码扫描仪中实施）。

调用 BarcodeScanner.ClaimScannerAsync 以获得相机条形码扫描仪的独占使用权。

需要相机预览来帮助用户将相机瞄准条形码。 Windows 提供基本的相机预览，用于启动用于控制相机条形码扫描仪的对话框。

调用 ClaimedBarcodeScanner.ShowVideoPreview 即可打开对话框，调用 ClaimedBarcodeScanner.HideVideoPreview 即可将其关闭。

提示

请参阅托管预览以在你的应用程序中托管相机条形码扫描仪的预览。

可以通过调用 StartSoftwareTriggerAsync 来启动扫描过程。

根据“IsDisabledOnDataReceived”的值，扫描仪可能在扫描一个条形码后即停止，或持续扫描直到你调用“StopSoftwareTriggerAsync”。

设置所需的 IsDisabledOnDataReceived 值以控制解码条形码时扫描仪的行为。