SBSScanCaseSession Class Reference

Inherits NSObject.

Instance Methods

(void) - clear
 

Properties

NSArray< SBSCode * > * newlyRecognizedCodes
 
NSArray< SBSCode * > * newlyLocalizedCodes
 
NSArray< SBSCode * > * allRecognizedCodes
 

Detailed Description

Holds all barcodes that were decoded in the current session.

Configuring Session Behavior

The scan session is responsible for determining the list of "relevant" barcodes by filtering out duplicates. Depending on your app, different duplicate removal is required. For some applications, only one barcode is required. The scanning process is stopped as soon as one code is decoded. For other applications, multiple codes are scanned after another. For example, a scanner at the cash desk may need to scan multiple products. To avoid duplicates, the same barcode should not be scanned in short succession. The same barcode (data, symbology) should not count as a duplicate if encountered again after a few seconds.

By default, if a barcode has the same symbology and data as code that was decoded less than 1000ms ago, it is filtered out as a duplicate.

Session Lifetime

The session is cleared when SBSScanCase state changes from SBSScanCaseStateOff to SBSScanCaseStateActive, or when the user manually clears the session using clear (SBSScanCaseSession).

Method Documentation

- (void) clear

Remove all codes from the scan session.

Use this method to manually remove all codes from the scan session. Typicaly you will not have to this method directly but instead configure the duplicate removal and code caching duration with through SBSScanSettings

Property Documentation

- (NSArray<SBSCode *>*) newlyRecognizedCodes
readnonatomiccopy

A new copy of the list of barcodes that have been successfully decoded in the last frame.

- (NSArray<SBSCode *>*) newlyLocalizedCodes
readnonatomiccopy

A new copy of the list of barcodes that have been localized but not recognized in the last frame.

- (NSArray<SBSCode *>*) allRecognizedCodes
readnonatomiccopy

Returns the list of barcodes (data, symbology) that have been decoded (recognized) in this session.

Depending on the code caching and duplicate filtering behavior, different sets of codes are returned by this method.

See also
SBSScanSettings::codeDuplicateFilter
SBSScanSettings::codeCachingDuration
Returns
a new copy of the list of barcodes that have been successfully decoded in this session

The documentation for this class was generated from the following file: