com.symbol.emdk.barcode

Class BarcodeManager

java.lang.Object

com.symbol.emdk.EMDKBase

com.symbol.emdk.barcode.BarcodeManager

public class BarcodeManager
extends EMDKBase

This is the primary object to access the barcode scanning feature.

 
 	Example Usage:

 	public class MainActivity extends Activity implements EMDKListener, StatusListener, DataListener, ScannerConnectionListener {

		//@Override
		protected void onCreate(Bundle savedInstanceState) {

    			//...
    			EMDKResults results = EMDKManager.getEMDKManager(getApplicationContext(), this);

		}

		//@Override
		public void onOpened(EMDKManager emdkManager) {
				this.emdkManager = emdkManager;

  			//...
  			barcodeManager = (BarcodeManager)this.emdkManager.getInstance(FEATURE_TYPE.BARCODE);

  			//...
  			Scanner scanner = barcodeManager.getDevice(DeviceIdentifier.DEFAULT);
  			scanner.addDataListener(callbackObj);
  			scanner.addStatusListener(callbackObj);
  			scanner.enable();

  			//...
  			scanner.read();

  			//...
  			scanner.cancelRead();

  			//...
  			scanner.disable();

  			//..
  			EMDKManager.release(FEATURE_TYPE.BARCODE);

		}
	}
	
 

When using BarcodeManager consider the followings:

1. To handle barcode scanning during device suspend-resume cycle (ex: pressing Power key) or background-foreground switching (ex: pressing Home key), it is required to release BarcodeManager instance by calling EMDKManager.release(FEATURE_TYPE.BARCODE) during suspend/switching to background and gain new BarcodeManager instance by calling EMDKManager.getInstance(FEATURE_TYPE.BARCODE) during resume/switching to foreground. Zebra recommends using onPause() and onResume() callbacks for this purpose.
2. Barcode API While using Bluetooth and Pluggable scanners such as RS507, RS6000, RS4000, when the scanner DISCONNECTED event is received, the created scanner object must be released and cannot be used for future scanning tasks. When the subsequent CONNECTED event is received, a new scanner object must be created and used for scanning. Zebra recommends maintaining a time gap between every DISCONNECT and CONNECT for the Pluggable scanner devices.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BarcodeManager.ConnectionState Connection states of a scanner device.
static class	BarcodeManager.DeviceIdentifier Defines specific scanner devices of each type.
static interface	BarcodeManager.ScannerConnectionListener An interface for notifying client applications when the external scanner is connected or disconnected to the mobile device.

Method Summary

Modifier and Type	Method and Description
void	addConnectionListener(BarcodeManager.ScannerConnectionListener connectionListener) Add ScannerConnectionListener to receive scanner connection changes via callback.
Scanner	getDevice(BarcodeManager.DeviceIdentifier deviceIdentifier) This method returns the scanner object based on device identifier specified except DeviceIdentifier.UNDEFINED.
Scanner	getDevice(ScannerInfo scannerInfo) This method returns the scanner object if the scanner info specified is valid and scanner info object can obtain from the BarcoderManager.getSupportedDevices().
java.util.List<ScannerInfo>	getSupportedDevicesInfo() Returns list of supported scanner devices information.
void	removeConnectionListener(BarcodeManager.ScannerConnectionListener connectionListener) Remove ScannerConnectionListener to receive scanner connection changes via callback.

Methods inherited from class com.symbol.emdk.EMDKBase

getType

Methods inherited from class java.lang.Object

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

Method Detail

getSupportedDevicesInfo

public java.util.List<ScannerInfo> getSupportedDevicesInfo()

Returns list of supported scanner devices information.

Returns:

Returns list of supported scanner devices information.

Throws:

ScannerException

getDevice

public Scanner getDevice(ScannerInfo scannerInfo)

This method returns the scanner object if the scanner info specified is valid and scanner info object can obtain from the BarcoderManager.getSupportedDevices(). The scanner object created will be singleton object for a specific scanner.

Parameters:

friendlyName - The scanner friendly name.

Returns:

Returns the scanner object if scanner friendly name is valid. Otherwise null is returned.

getDevice

public Scanner getDevice(BarcodeManager.DeviceIdentifier deviceIdentifier)

This method returns the scanner object based on device identifier specified except DeviceIdentifier.UNDEFINED. The scanner object created will be singleton object for a specific scanner.

Parameters:

deviceIdentifier - The device identifier specifies which scanner the application wants.

Returns:

Scanner object if the device identifier specified is valid on the device. Otherwise null is returned.

addConnectionListener

public void addConnectionListener(BarcodeManager.ScannerConnectionListener connectionListener)

Add ScannerConnectionListener to receive scanner connection changes via callback.

Parameters:

connectionListener -

removeConnectionListener

public void removeConnectionListener(BarcodeManager.ScannerConnectionListener connectionListener)

Remove ScannerConnectionListener to receive scanner connection changes via callback.

Parameters:

connectionListener -