ScanAndPairManager

EMDK For Android 4.2

The ScanAndPair provides simple methods to scan a Bluetooth barcode (name or address) of a remote Bluetooth device and pair/unpair with the remote Bluetooth device.

Public Methods

isPreviousCommandPending

public boolean isPreviousCommandPending()

This method provides information if any of the previous request is pending. If this method returns true, the client application must wait for the current complete before calling the issuing the next request.

Returns:

boolean - Boolean value

scanAndPair

public ScanAndPairResults scanAndPair(java.lang.String pin)

This is an asynchronous method. The status of the scanAndPair() method will be returned if the callback is registered. If the always scan is enabled in the configuration, this method scans a barcode to get the Bluetooth address or name of a remote device, and pairs with that remote device. If a Bluetooth address is scanned, the remote device is paired without performing a discovery. If a Bluetooth name is scanned, then a discovery is done to find the address of the device and then the pairing is done. The provided authentication PIN is used for pairing. The maximum allowed length for the authentication PIN is 15 characters.

Parameters:

pin - Pin required to pair with the Bluetooth device.

Returns:

com.symbol.emdk.scanandpair.ScanAndPairResults - Returns success if the scan and pair request is successfully initiated.

scanAndUnpair

public ScanAndPairResults scanAndUnpair()

This is an asynchronous method. The status of the scanAndUnpair() method will be returned if the callback is registered. If the always scan is enabled in the configuration, this method scans a barcode to get the Bluetooth address or name of a remote device, and pairs with that remote device.
If a Bluetooth address was scanned for pairing during scanAndPair calls, then the same address can be scanned for unpairing during the ScanAndUnPair call.

Returns:

com.symbol.emdk.scanandpair.ScanAndPairResults - Returns success if the scan and unpair request is successfully initiated.

getStatus

public StatusData getStatus()

This method provides an option to get the current or recent status of scanAndPair or scanAndUnpair calls

Returns:

com.symbol.emdk.scanandpair.StatusData - StatusData object.

addStatusListener

public void addStatusListener(ScanAndPairManager.StatusListener listener)

The client can register to get status notification via callbacks.

Parameters:

listener

Returns:

void

Throws:

com.symbol.emdk.scanandpair.ScanAndPairException

removeStatusListener

public void removeStatusListener(ScanAndPairManager.StatusListener listener)

The client can un-register to get status notification via callbacks.

Parameters:

listener

Returns:

void

Throws:

com.symbol.emdk.scanandpair.ScanAndPairException

Public Fields

config

The ScanAndPairManager.config provides a way to configure the settings to use it in scanAndPair() or scanAnUnpair() methods. These settings must be done before calling the scanAndPair() or scanAnUnpair() methods and do not modify the this while the method is processing its job.

Type:

com.symbol.emdk.scanandpair.ScanAndPairConfig