Getting Started

The barcode scanner is bundled as a NuGet package and you can install it through the NuGet package manager. You can do this in the package manager console, or from the UI in Visual Studio. In the following the steps for adding the package from the Visual Studio UI are described:

• Right-click on References and select "Manage NuGet Packages...".
• You will need to add the directory that contains the barcode picker package as a package source. Click on settings (in some versions of Visual Studio, the settings are accessible by clicking the cogwheel icon) and add the folder that contains the Scandit.BarcodePicker.$version.nupkg as a new package source.
• Close the settings dialog
• Select the newly added package source and select Scandit.BarcodePicker from the list of available packages.
• Click on Install.

The Windows 10 universal package supports all architectures (x86, ARM, x64). Please note that it is currently not possible build/run your project when the AnyCPU is selected. You will need to select the x64/x86/ARM depending on your current target platform.

You will need to make a few adjustments to the App Manifest.

• Update the App manifest to include microphone and webcam capabilities. Without it you will get a null-pointer exception when trying to initialize scanner.
• Update the app manifest XML to contain the following extension. This class is required for accessing the raw camera frames from the VideoInputRT dll.
  Add Extension Class to the App Manifest

  Copy

  <Extensions>
      <Extension Category="windows.activatableClass.inProcessServer">
      <InProcessServer>
          <Path>VideoInputRT.dll</Path>
          <ActivatableClass ActivatableClassId="VideoInputRT.FrameAccess" ThreadingModel="both" />
      </InProcessServer>
      </Extension>
  </Extensions>

It is possible to instantiate the barcode picker directly in your application code. However, the simplest solution is to instantiate the barcode picker inside the xaml file as shown below:

<Page ... xmlns:scandit="using:Scandit.BarcodePicker">
    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
        <scandit:BarcodePicker x:Name="thePicker" />
    </Grid>
</Page>

Before starting the scanning process, you must set the Scandit license key to the application key you obtained on the Scandit.com website. If you do not set the application key, you will not be able to scan any barcodes and an error message will be displayed on top of the camera stream. For versions prior to 4.12, the application would terminate upon instantiating the picker.

ScanditLicense.AppKey = "-- ENTER YOUR SCANDIT LICENSE KEY HERE --";

The scanning process is configured through scan settings. Scan settings control the enabled symbologies (barcode types) and allow to fine-tune the recognition behavior. By default, scanning of all barcode symbologies is disabled and you must explicitly enable the symbologies you require in your application.

var scanSettings = new ScanSettings();
// enable a bunch of symbologies for scanning. Note that it's best to 
// only enable barcode symbologies that you are actually going to use 
// in your application as every symbology adds a processing overhead.
var symbologiesToEnable = new BarcodeSymbology[]
{
    BarcodeSymbology.Ean13,
    BarcodeSymbology.Upca,
    BarcodeSymbology.Ean8,
    BarcodeSymbology.Upce,
};
foreach (var sym in symbologiesToEnable)
    scanSettings.EnableSymbology(sym);
// apply the settings to the picker
await picker.ApplySettingsAsync(scanSettings);

To get informed when a new barcode has been recognized, add a DidScan delegate to the barcode picker. Additionally, it's good practice to also register a Failed delegate to get notified and react to failures of the picker.

// gets called whenever the picker encounters an error, e.g. the camera 
// could not be initialized.
picker.Failed += PickerFailed;
// gets called whenever a new barcode has been recognized. This is where 
// you put your custom logic for handling barcode scan results.
picker.DidScan += OnCodeScanned;

private void OnCodeScanned(ScanSession session)
{
    foreach (var code in session.NewlyRecognizedCodes)
        Debug.WriteLine("{0}: {1}", code.SymbologyString, code.Data);
}

Before any codes can be scanned, the BarcodePicker muste be started. This can be done by calling OpenCameraAndStartScanningAsync(DeviceInformation).

var camera = await CameraSelection.FindBackFacingCameraOrDefault();
await picker.OpenCameraAndStartScanningAsync(camera);

When your are done, make sure to close the camera and stop the scanning with StopScanningAndCloseCameraAsync.

await picker.StopScanningAndCloseCameraAsync();