Data Capture Plus Profile Feature Reference

EMDK For Xamarin 8.0

Overview

Data Capture Plus (formerly known as the "Data Capture Panel") enables areas of the device screen to be designated as scan triggers. By tapping on a designated screen area, DataWedge will respond as it would to a scanner button-press or other hardware trigger.

DCP is disabled by default. The DataWedge Profile configuration screen allows an app user to configure the appearance of DCP on the screen once a particular Profile is loaded. If the user checks the option to enable the DCP, the five parameters shown below appear on the preference screen and can be configured as desired.

Note: The DCP will not appear if the scanner is disabled in the current Profile.

Name

The name field is used by the EMDK to identify this particular feature parameter set when you want to manage just part of the profile programmatically using the EMDK ProfileManager API. This can be useful if you have multiple types of the same feature and want to update only one of them without having to update the whole profile. See EMDK Profiles Overview for more information.

Dock button on

Sets the initial docking location of the floating DCP button. Changes by the user at runtime are saved to the active Profile. Docking options:

  • Right side only
  • Left side only
  • Either side

Start in

Sets the mode that DCP will startup with. If configured to launch as a button, the DCP mode can be changed at runtime by dragging, but the launch state will not be changed in the Profile. Start-in options:

  • Button mode (floating button)
  • Full-screen mode
  • Button-only mode

Button highest position

Sets a ceiling for button position expressed as a percent of screen height. For example, on a screen measuring four inches vertically, a setting of 75 (%) would prevent the upper edge of the DCP button from being positioned less than one inch from the top of the screen.

Bottom lowest position

Sets a floor for button position expressed as a percent of screen height. For example, on a screen measuring four inches vertically, a setting of 25 (%) would prevent the lower edge of the DCP button from being positioned less than one inch from the bottom of the screen.

Drag Detect Time

The wait time (in ms) that DCP should wait after a screen tap before triggering a scanner action. This can help prevent accidental triggers when dragging the DCP button to a new location.

Note: A quick touch and release of the DCP can sometimes start the viewfinder when using camera as a scanner. To exit, press the back button.

Data Capture Plus shown in minimized mode.

Note: If configured to launch as a button, the DCP mode can be changed at runtime by dragging, but the launch state will not be changed in the Profile. However, runtime changes to the vertical position and the docking side of device screen will be saved to the active Profile.

Data Capture Plus shown in maximized mode.

Scanning with DCP

To scan a barcode with DCP:

1. With DCP enabled, tap and hold the area of the screen designated for DCP. The scan beam (or camera viewfinder) will be active while the tap is held.

2. Aim the scan beam or camera reticle at the barcode to be scanned. DCP will use the preferences configured in the Barcode Input Plug-in for the current Profile.

3. * Release finger to stop scanning or to close the camera viewfinder.

Note: A quick touch and release of the DCP control sometimes will start the viewfinder when using camera as a scanner. To exit, press the BACK button.