Package com.zebra.scannercontrol

Class SDKHandler

java.lang.Object

com.zebra.scannercontrol.SDKHandler

All Implemented Interfaces:

IDcsSdkApi

public class SDKHandler
extends Object
implements IDcsSdkApi

Class which acts as a gateway to the SDK

Field Summary

Fields

Modifier and Type	Field	Description
static final int	BLUETOOTH_MAC_ADDRESS_CHARACTER_COUNT
static final String	MAC_ADDRESS_FORMATTING_REGULAR_EXPRESSION
static final String	REPLACEMENT_DELIMITER
static final int	sleepDuration

Constructor Summary

Constructors

Constructor	Description
SDKHandler(Context context)
SDKHandler(Context context, boolean enableSTCEnabledState)

Method Summary

Modifier and Type	Method	Description
DCSSDKDefs.DCSSDK_RESULT	dcssdkClearBTAddress()	Method to clear the Bluetooth address stored in SDK.
DCSSDKDefs.DCSSDK_RESULT	dcssdkClose()	Method to close the communication with SDK
DCSSDKDefs.DCSSDK_RESULT	dcssdkEnableAutomaticSessionReestablishment(boolean enable, int fromScannerID)	Method requests to enable/disable "Automatic communication session reestablishment" option for a particular scanner.
DCSSDKDefs.DCSSDK_RESULT	dcssdkEnableAvailableScannersDetection(boolean enable)	Method requests to enable/disable "Available scanners detection" option.
DCSSDKDefs.DCSSDK_RESULT	dcssdkEnableBluetoothScannersDiscovery(boolean enable)	Method requests to enable/disable "Bluetooth scanners discovery" option.
DCSSDKDefs.DCSSDK_RESULT	dcssdkEstablishCommunicationSession(int scannerID)	Method requests to establish communication session with a particular available scanner.
String	dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode, String inXML)	Method provides synchronous execution of a particular method via an opcode.
DCSSDKDefs.DCSSDK_RESULT	dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode, String inXML, StringBuilder outXML)	Method provides synchronous execution of a particular method via an opcode.
DCSSDKDefs.DCSSDK_RESULT	dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode, String inXML, StringBuilder outXML, int scannerID)	Method provides synchronous execution of a particular method via an opcode.
DCSSDKDefs.DCSSDK_RESULT	dcssdkExecuteSSICommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode, String inXML, StringBuilder outXML, int scannerID)	Method provides synchronous execution SSI command of a particular method via an opcode.
List<DCSScannerInfo>	dcssdkGetActiveScannersList()	Method to fetch the list of active(connected via bluetooth) scanners
DCSSDKDefs.DCSSDK_RESULT	dcssdkGetActiveScannersList(List<DCSScannerInfo> activeScannersList)	Method to fetch the list of active(connected via bluetooth) scanners
List<DCSScannerInfo>	dcssdkGetAvailableScannersList()	Method to fetch the list of available(paired via bluetooth) scanners
DCSSDKDefs.DCSSDK_RESULT	dcssdkGetAvailableScannersList(List<DCSScannerInfo> availableScannersList)	Method to fetch the list of available(paired via bluetooth) scanners
IDCConfig	dcssdkGetIDCConfig()	Method to get the IDCConfig information stored in SDK.
BarCodeView	dcssdkGetPairingBarcode(DCSSDKDefs.DCSSDK_BT_PROTOCOL bluetoothProtocol, DCSSDKDefs.DCSSDK_BT_SCANNER_CONFIG defaultOption)	Method provides pairing barcode for Bluetooth scanners
BarCodeView	dcssdkGetPairingBarcode(DCSSDKDefs.DCSSDK_BT_PROTOCOL bluetoothProtocol, DCSSDKDefs.DCSSDK_BT_SCANNER_CONFIG defaultOption, String bluetoothMAC)	Method provides pairing barcode for Bluetooth scanners
BarCodeView	dcssdkGetUSBSNAPIWithImagingBarcode()	Method provides connection barcode for USB scanners
String	dcssdkGetVersion()	Method to return the version of the SDK.
DCSSDKDefs.DCSSDK_RESULT	dcssdkSetBTAddress(String bluetoothMAC)	Method to set the Bluetooth address of the device.
DCSSDKDefs.DCSSDK_RESULT	dcssdkSetDelegate(IDcsSdkApiDelegate delegate)	Registers a particular object which conforms to IDcsSdkApiDelegate interface as a receiver of SDK notifications.
DCSSDKDefs.DCSSDK_RESULT	dcssdkSetIDCConfig(IDCConfig idcConfig)	Method to set the IDC configuration information for SDK.
DCSSDKDefs.DCSSDK_RESULT	dcssdkSetOperationalMode(DCSSDKDefs.DCSSDK_MODE operationalMode)	Method to set the operational mode(If multiple modes are suppoted)
DCSSDKDefs.DCSSDK_RESULT	dcssdkSetSTCEnabledState(boolean enable)	Method set Scanner Control App STC(Scan to connect) enabled state.
DCSSDKDefs.DCSSDK_RESULT	dcssdkStartScanForAvailableDevices()	Method to scan all the currently available Bluetooth Devices.
DCSSDKDefs.DCSSDK_RESULT	dcssdkStartScanForTopologyChanges()	Scan for topology changes
DCSSDKDefs.DCSSDK_RESULT	dcssdkStopScanningDevices()	Method to stop current Bluetooth Devices scanning.
DCSSDKDefs.DCSSDK_RESULT	dcssdkSubsribeForEvents(int sdkEventsMask)	Method to enable providing of notifications of requested types.
DCSSDKDefs.DCSSDK_RESULT	dcssdkTerminateCommunicationSession(int scannerID)	Method requests to terminate communication session with a particular active scanner.
DCSSDKDefs.DCSSDK_RESULT	dcssdkUnsubsribeForEvents(int sdkEventsMask)	Method to disable providing of notification of requested types.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

BLUETOOTH_MAC_ADDRESS_CHARACTER_COUNT

public static final int BLUETOOTH_MAC_ADDRESS_CHARACTER_COUNT

See Also:

• Constant Field Values

MAC_ADDRESS_FORMATTING_REGULAR_EXPRESSION

public static final String MAC_ADDRESS_FORMATTING_REGULAR_EXPRESSION

See Also:

• Constant Field Values

REPLACEMENT_DELIMITER

public static final String REPLACEMENT_DELIMITER

See Also:

• Constant Field Values

sleepDuration

public static final int sleepDuration

See Also:

• Constant Field Values

Constructor Details

SDKHandler

public SDKHandler(Context context)

SDKHandler

public SDKHandler(Context context,
 boolean enableSTCEnabledState)

Method Details

dcssdkSetDelegate

public DCSSDKDefs.DCSSDK_RESULT dcssdkSetDelegate(IDcsSdkApiDelegate delegate)

Description copied from interface: IDcsSdkApi

Registers a particular object which conforms to IDcsSdkApiDelegate interface as a receiver of SDK notifications. Registration of a particular object which conforms to IDcsSdkApiDelegate interface is required to receive notifications from the SDK.

Specified by:

dcssdkSetDelegate in interface IDcsSdkApi

Parameters:

delegate - Delegate which will be implemented by the app

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkClose

public DCSSDKDefs.DCSSDK_RESULT dcssdkClose()

Description copied from interface: IDcsSdkApi

Method to close the communication with SDK

Specified by:

dcssdkClose in interface IDcsSdkApi

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetVersion

public String dcssdkGetVersion()

Description copied from interface: IDcsSdkApi

Method to return the version of the SDK.

Specified by:

dcssdkGetVersion in interface IDcsSdkApi

Returns:

SDK Version

dcssdkGetPairingBarcode

public BarCodeView dcssdkGetPairingBarcode(DCSSDKDefs.DCSSDK_BT_PROTOCOL bluetoothProtocol,
 DCSSDKDefs.DCSSDK_BT_SCANNER_CONFIG defaultOption,
 String bluetoothMAC)

Description copied from interface: IDcsSdkApi

Method provides pairing barcode for Bluetooth scanners

Specified by:

dcssdkGetPairingBarcode in interface IDcsSdkApi

Parameters:

bluetoothProtocol - Protocol to be switched

defaultOption - Configuration to be used

bluetoothMAC - Bluetooth MAC address to be used

Returns:

BarCodeView

dcssdkGetPairingBarcode

public BarCodeView dcssdkGetPairingBarcode(DCSSDKDefs.DCSSDK_BT_PROTOCOL bluetoothProtocol,
 DCSSDKDefs.DCSSDK_BT_SCANNER_CONFIG defaultOption)

Description copied from interface: IDcsSdkApi

Method provides pairing barcode for Bluetooth scanners

Specified by:

dcssdkGetPairingBarcode in interface IDcsSdkApi

Parameters:

bluetoothProtocol - Protocol to be switched

defaultOption - Configuration to be used

Returns:

BarCodeView

dcssdkSetBTAddress

public DCSSDKDefs.DCSSDK_RESULT dcssdkSetBTAddress(String bluetoothMAC)

Description copied from interface: IDcsSdkApi

Method to set the Bluetooth address of the device. This address will be used when SDK cannot determine Bluetooth MAC address automatically.

Specified by:

dcssdkSetBTAddress in interface IDcsSdkApi

Parameters:

bluetoothMAC - Bluetooth MAC address to be used

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkClearBTAddress

public DCSSDKDefs.DCSSDK_RESULT dcssdkClearBTAddress()

Description copied from interface: IDcsSdkApi

Method to clear the Bluetooth address stored in SDK.

Specified by:

dcssdkClearBTAddress in interface IDcsSdkApi

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetUSBSNAPIWithImagingBarcode

public BarCodeView dcssdkGetUSBSNAPIWithImagingBarcode()

Description copied from interface: IDcsSdkApi

Method provides connection barcode for USB scanners

Specified by:

dcssdkGetUSBSNAPIWithImagingBarcode in interface IDcsSdkApi

Returns:

BarCodeView

dcssdkStartScanForTopologyChanges

public DCSSDKDefs.DCSSDK_RESULT dcssdkStartScanForTopologyChanges()

Description copied from interface: IDcsSdkApi

Scan for topology changes

Specified by:

dcssdkStartScanForTopologyChanges in interface IDcsSdkApi

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkSetOperationalMode

public DCSSDKDefs.DCSSDK_RESULT dcssdkSetOperationalMode(DCSSDKDefs.DCSSDK_MODE operationalMode)

Description copied from interface: IDcsSdkApi

Method to set the operational mode(If multiple modes are suppoted)

Specified by:

dcssdkSetOperationalMode in interface IDcsSdkApi

Parameters:

operationalMode - Operational mode to be set(one of DCSSDKDefs.DCSSDK_MODE)

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkSubsribeForEvents

public DCSSDKDefs.DCSSDK_RESULT dcssdkSubsribeForEvents(int sdkEventsMask)

Description copied from interface: IDcsSdkApi

Method to enable providing of notifications of requested types.

Specified by:

dcssdkSubsribeForEvents in interface IDcsSdkApi

Parameters:

sdkEventsMask - Mask which decides the subscription status

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkUnsubsribeForEvents

public DCSSDKDefs.DCSSDK_RESULT dcssdkUnsubsribeForEvents(int sdkEventsMask)

Description copied from interface: IDcsSdkApi

Method to disable providing of notification of requested types.

Specified by:

dcssdkUnsubsribeForEvents in interface IDcsSdkApi

Parameters:

sdkEventsMask - Unsubscription option flags.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetAvailableScannersList

public DCSSDKDefs.DCSSDK_RESULT dcssdkGetAvailableScannersList(List<DCSScannerInfo> availableScannersList)

Description copied from interface: IDcsSdkApi

Method to fetch the list of available(paired via bluetooth) scanners

Specified by:

dcssdkGetAvailableScannersList in interface IDcsSdkApi

Parameters:

availableScannersList - List of scanners which should be updated

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetAvailableScannersList

public List<DCSScannerInfo> dcssdkGetAvailableScannersList()

Description copied from interface: IDcsSdkApi

Method to fetch the list of available(paired via bluetooth) scanners

Specified by:

dcssdkGetAvailableScannersList in interface IDcsSdkApi

Returns:

List of available scanners)

dcssdkStartScanForAvailableDevices

public DCSSDKDefs.DCSSDK_RESULT dcssdkStartScanForAvailableDevices()

Description copied from interface: IDcsSdkApi

Method to scan all the currently available Bluetooth Devices.

Specified by:

dcssdkStartScanForAvailableDevices in interface IDcsSdkApi

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkStopScanningDevices

public DCSSDKDefs.DCSSDK_RESULT dcssdkStopScanningDevices()

Description copied from interface: IDcsSdkApi

Method to stop current Bluetooth Devices scanning.

Specified by:

dcssdkStopScanningDevices in interface IDcsSdkApi

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetActiveScannersList

public DCSSDKDefs.DCSSDK_RESULT dcssdkGetActiveScannersList(List<DCSScannerInfo> activeScannersList)

Description copied from interface: IDcsSdkApi

Method to fetch the list of active(connected via bluetooth) scanners

Specified by:

dcssdkGetActiveScannersList in interface IDcsSdkApi

Parameters:

activeScannersList - List of scanners which should be updated

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetActiveScannersList

public List<DCSScannerInfo> dcssdkGetActiveScannersList()

Description copied from interface: IDcsSdkApi

Method to fetch the list of active(connected via bluetooth) scanners

Specified by:

dcssdkGetActiveScannersList in interface IDcsSdkApi

Returns:

List of active scanners)

dcssdkEstablishCommunicationSession

public DCSSDKDefs.DCSSDK_RESULT dcssdkEstablishCommunicationSession(int scannerID)

Description copied from interface: IDcsSdkApi

Method requests to establish communication session with a particular available scanner.

Specified by:

dcssdkEstablishCommunicationSession in interface IDcsSdkApi

Parameters:

scannerID - Unique identifier of a particular scanner assigned by SDK

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkTerminateCommunicationSession

public DCSSDKDefs.DCSSDK_RESULT dcssdkTerminateCommunicationSession(int scannerID)

Description copied from interface: IDcsSdkApi

Method requests to terminate communication session with a particular active scanner.

Specified by:

dcssdkTerminateCommunicationSession in interface IDcsSdkApi

Parameters:

scannerID - Unique identifier of a particular scanner assigned by SDK.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkEnableAvailableScannersDetection

public DCSSDKDefs.DCSSDK_RESULT dcssdkEnableAvailableScannersDetection(boolean enable)

Description copied from interface: IDcsSdkApi

Method requests to enable/disable "Available scanners detection" option.

Specified by:

dcssdkEnableAvailableScannersDetection in interface IDcsSdkApi

Parameters:

enable - (true/false) based on whether the option should be enabled or disabled

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkEnableBluetoothScannersDiscovery

public DCSSDKDefs.DCSSDK_RESULT dcssdkEnableBluetoothScannersDiscovery(boolean enable)

Description copied from interface: IDcsSdkApi

Method requests to enable/disable "Bluetooth scanners discovery" option.

Specified by:

dcssdkEnableBluetoothScannersDiscovery in interface IDcsSdkApi

Parameters:

enable - (true/false) based on whether the option should be enabled or disabled

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkSetSTCEnabledState

public DCSSDKDefs.DCSSDK_RESULT dcssdkSetSTCEnabledState(boolean enable)

Description copied from interface: IDcsSdkApi

Method set Scanner Control App STC(Scan to connect) enabled state.

Specified by:

dcssdkSetSTCEnabledState in interface IDcsSdkApi

Parameters:

enable - (true/false) based on whether the option should be enabled or disabled

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkEnableAutomaticSessionReestablishment

public DCSSDKDefs.DCSSDK_RESULT dcssdkEnableAutomaticSessionReestablishment(boolean enable,
 int fromScannerID)

Description copied from interface: IDcsSdkApi

Method requests to enable/disable "Automatic communication session reestablishment" option for a particular scanner.

Specified by:

dcssdkEnableAutomaticSessionReestablishment in interface IDcsSdkApi

Parameters:

enable - true/false for enabling/disabling

fromScannerID - identifier of a particular scanner assigned by SDK.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkExecuteCommandOpCodeInXMLForScanner

public DCSSDKDefs.DCSSDK_RESULT dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode,
 String inXML,
 StringBuilder outXML,
 int scannerID)

Description copied from interface: IDcsSdkApi

Method provides synchronous execution of a particular method via an opcode.

Specified by:

dcssdkExecuteCommandOpCodeInXMLForScanner in interface IDcsSdkApi

Parameters:

opCode - Opcode for the command

inXML - Relevant argument list for the opcode, structured into an XML string.

outXML - Results of method execution, structured into an XML string.

scannerID - Unique identifier of a particular scanner assigned by SDK.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkExecuteCommandOpCodeInXMLForScanner

public DCSSDKDefs.DCSSDK_RESULT dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode,
 String inXML,
 StringBuilder outXML)

Description copied from interface: IDcsSdkApi

Method provides synchronous execution of a particular method via an opcode.

Specified by:

dcssdkExecuteCommandOpCodeInXMLForScanner in interface IDcsSdkApi

Parameters:

opCode - Opcode for the command

inXML - Relevant argument list for the opcode, structured into an XML string.

outXML - Results of method execution, structured into an XML string.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkExecuteCommandOpCodeInXMLForScanner

public String dcssdkExecuteCommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode,
 String inXML)

Description copied from interface: IDcsSdkApi

Method provides synchronous execution of a particular method via an opcode.

Specified by:

dcssdkExecuteCommandOpCodeInXMLForScanner in interface IDcsSdkApi

Parameters:

opCode - Opcode for the command

inXML - Relevant argument list for the opcode, structured into an XML string.

Returns:

outXma for execute command with given opcode and inXml.

dcssdkExecuteSSICommandOpCodeInXMLForScanner

public DCSSDKDefs.DCSSDK_RESULT dcssdkExecuteSSICommandOpCodeInXMLForScanner(DCSSDKDefs.DCSSDK_COMMAND_OPCODE opCode,
 String inXML,
 StringBuilder outXML,
 int scannerID)

Description copied from interface: IDcsSdkApi

Method provides synchronous execution SSI command of a particular method via an opcode.

Specified by:

dcssdkExecuteSSICommandOpCodeInXMLForScanner in interface IDcsSdkApi

Parameters:

opCode - Opcode for the command

inXML - Relevant argument list for the opcode, structured into an XML string.

outXML - Results of method execution, structured into an XML string.

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkSetIDCConfig

public DCSSDKDefs.DCSSDK_RESULT dcssdkSetIDCConfig(IDCConfig idcConfig)

Description copied from interface: IDcsSdkApi

Method to set the IDC configuration information for SDK. This configuration information is used to send either Binary Data event or seperate Image and Barcode events for IDC data.

Specified by:

dcssdkSetIDCConfig in interface IDcsSdkApi

Parameters:

idcConfig - IDCConfig Object which has IDC configuration information

Returns:

Success/Failure of the operation(One of DCSSDKDefs.DCSSDK_RESULT)

dcssdkGetIDCConfig

public IDCConfig dcssdkGetIDCConfig()

Description copied from interface: IDcsSdkApi

Method to get the IDCConfig information stored in SDK.

Specified by:

dcssdkGetIDCConfig in interface IDcsSdkApi

Returns:

IDCConfig object(IDCConfig)