Barcode Find View

Defined in package com.scandit.datacapture.barcode.find.ui

BarcodeFindViewUiListener

interface BarcodeFindViewUiListener

Added in version 6.18.0

onFinishButtonTapped(foundItems)

void onFinishButtonTapped(@NonNull Set<@NonNull BarcodeFindItem> foundItems)

Added in version 6.18.0

Callback method that can be used to define an action that should be performed when the finish button is tapped from the view. The foundItems parameter contains all the items found since the start of the searching process. Called from the main thread.

BarcodeFindView

class BarcodeFindView : RelativeLayout

Added in version 6.18.0

BarcodeFind comes with a ready-to-use search UI that uses augmented reality overlays to highlight items that match predefined criteria. The BarcodeFindView integrates with any app in just a few lines of code.

newInstance(parentView, dataCaptureContext, barcodeFind, settings)

static @NonNull BarcodeFindView newInstance(@NonNull View parentView,
        @NonNull DataCaptureContext dataCaptureContext,
        @NonNull BarcodeFind barcodeFind,
        @NonNull BarcodeFindViewSettings settings)

Added in version 6.18.0

Constructs a new BarcodeFind view and adds it to the provided parentView. The provided settings will be used to set the default behaviour and look of the view.

newInstance(parentView, dataCaptureContext, barcodeFind, settings, cameraSettings)

static @NonNull BarcodeFindView newInstance(@NonNull View parentView,
        @NonNull DataCaptureContext dataCaptureContext,
        @NonNull BarcodeFind barcodeFind,
        @NonNull BarcodeFindViewSettings settings,
        @NonNull CameraSettings cameraSettings)

Added in version 6.18.0

Constructs a new BarcodeFind view and adds it to the provided parentView.

The provided settings will be used to set the default behaviour and look of the view.

The provided camera settings will be used instead of the recommended camera settings for BarcodeFind.

newInstance(parentView, dataCaptureContext, barcodeFind)

static @NonNull BarcodeFindView newInstance(@NonNull View parentView,
        @NonNull DataCaptureContext dataCaptureContext,
        @NonNull BarcodeFind barcodeFind)

Added in version 6.18.0

Constructs a new BarcodeFind view and adds it to the provided parentView. The view will use default settings.

newInstance(dataCaptureView, dataCaptureContext, barcodeFind, settings, cameraSettings)

static @NonNull BarcodeFindView newInstance(@NonNull DataCaptureView dataCaptureView,
        @NonNull DataCaptureContext dataCaptureContext,
        @NonNull BarcodeFind barcodeFind,
        @NonNull BarcodeFindViewSettings settings,
        @NonNull CameraSettings cameraSettings)

Added in version 6.19.0

Constructs a new BarcodeFind view.

Warning

This constructor method should only be used in special cases, and its use is not recommended.

The newly created BarcodeFind view will need to be manually added to the view hierarchy.

onResume()

void onResume()

Added in version 6.18.0

Function to call on Fragment/Activity onResume callback. You have to call this for the correct functioning of the BarcodeFindView.

onPause()

void onPause()

Added in version 6.18.0

Function to call on Fragment/Activity onPause callback. You have to call this for the correct functioning of the BarcodeFindView.

stopSearching()

void stopSearching()

Added in version 6.18.0

Method to call for stopping the mode. For instance, it can be called when the view controller containing BarcodeFindView is about to disappear (i.e., UIViewController’s viewWillDisappear).

startSearching()

void startSearching()

Added in version 6.18.0

Starts the searching process. You can call this method if you want to trigger the searching process without any user interaction.

pauseSearching()

void pauseSearching()

Added in version 6.18.0

Pauses the searching process. You can call this method if you want to trigger pausing the searching process without any user interaction.

setListener(listener)

void setListener(@Nullable BarcodeFindViewUiListener listener)

Added in version 6.18.0

Sets the listener which is called whenever the finish button is tapped from the view.

shouldShowUserGuidanceView

boolean getShouldShowUserGuidanceView()
void setShouldShowUserGuidanceView(boolean value)

Added in version 6.18.0

Indicates whether guidance should be shown to the user.

Default is true.

shouldShowHints

boolean getShouldShowHints()
void setShouldShowHints(boolean value)

Added in version 6.18.0

Indicates whether hints should be shown to the user.

Default is true.

shouldShowCarousel

boolean getShouldShowCarousel()
void setShouldShowCarousel(boolean value)

Added in version 6.18.0

Indicates whether the item carousel should be shown to the user.

Default is true.

shouldShowPauseButton

boolean getShouldShowPauseButton()
void setShouldShowPauseButton(boolean value)

Added in version 6.18.0

Indicates whether the pause button should be shown to the user.

Default is true.

shouldShowFinishButton

boolean getShouldShowFinishButton()
void setShouldShowFinishButton(boolean value)

Added in version 6.18.0

Indicates whether the finish button should be shown to the user.

Default is true.

shouldShowProgressBar

boolean getShouldShowProgressBar()
void setShouldShowProgressBar(boolean value)

Added in version 6.18.0

Indicates whether the progress bar should be shown to the user.

Default is false.

shouldShowTorchControl

boolean getShouldShowTorchControl()
void setShouldShowTorchControl(boolean value)

Added in version 6.19.0

Indicates whether the torch control button should be shown to the user.

Default is false.

torchControlPosition

Anchor getTorchControlPosition()
void setTorchControlPosition(Anchor value)

Added in version 6.19.0

Updates the position of the torch control button.

Only Anchor.TOP_LEFT, Anchor.TOP_CENTER, Anchor.TOP_RIGHT and Anchor.BOTTOM_LEFT are supported.

Any other value will default to Anchor.TOP_LEFT.

shouldShowZoomControl

boolean getShouldShowZoomControl()
void setShouldShowZoomControl(boolean value)

Added in version 6.28.0

Indicates whether the zoom control should be shown to the user, allowing them to switch between the normal and ultra-wide lenses.

Default is false.

Note

The zoom control requires a device with an ultra-wide camera. On devices without an ultra-wide camera, setting this property to true has no effect.

textForCollapseCardsButton

@Nullable String getTextForCollapseCardsButton()
void setTextForCollapseCardsButton(@Nullable String value)

Added in version 6.18.0

Overrides the default text displayed in the button for collapsing the item carousel.

Default is null.

textForAllItemsFoundSuccessfullyHint

@Nullable String getTextForAllItemsFoundSuccessfullyHint()
void setTextForAllItemsFoundSuccessfullyHint(
        @Nullable String value)

Added in version 6.18.0

Overrides the default text displayed in the green confirmation view shown when all items have been found.

Default is null.

textForPointAtBarcodesToSearchHint

@Nullable String getTextForPointAtBarcodesToSearchHint()
void setTextForPointAtBarcodesToSearchHint(
        @Nullable String value)

Added in version 6.18.0

Overrides the default text for the “Point at barcodes to search” hint.

Default is null.

textForMoveCloserToBarcodesHint

@Nullable String getTextForMoveCloserToBarcodesHint()
void setTextForMoveCloserToBarcodesHint(@Nullable String value)

Added in version 6.18.0

Overrides the default text for the “Move closer” hint.

Default is null.

textForTapShutterToPauseScreenHint

@Nullable String getTextForTapShutterToPauseScreenHint()
void setTextForTapShutterToPauseScreenHint(
        @Nullable String value)

Added in version 6.18.0

Overrides the default text for “Tap shutter to pause” hint.

Default is null.

textForTapShutterToResumeSearchHint

@Nullable String getTextForTapShutterToResumeSearchHint()
void setTextForTapShutterToResumeSearchHint(
        @Nullable String value)

Added in version 6.18.0

Overrides the default text for “Tap shutter to resume” hint.

Default is null.

textForItemListUpdatedHint

@Nullable String getTextForItemListUpdatedHint()
void setTextForItemListUpdatedHint(@Nullable String value)

Added in version 6.24.0

Overrides the default text displayed in the confirmation view shown when the item list has been updated.

Default is null.

textForItemListUpdatedWhenPausedHint

@Nullable String getTextForItemListUpdatedWhenPausedHint()
void setTextForItemListUpdatedWhenPausedHint(
        @Nullable String value)

Added in version 6.24.0

Overrides the default text displayed in the confirmation view shown when the item list has been updated and search is paused.

Default is null.

camera

@Nullable Camera getCamera()

Added in version 6.18.0

Returns the :type core.Camera associated with the current find scenario.

hardwareTriggerSupported

boolean getHardwareTriggerSupported()

Added in version 6.23.0

Returns whether the device supports listening for hardware button events. This is true for devices with api >= 28.