com.cloudpos.msr

Class MSRUtils

java.lang.Object

com.cloudpos.msr.MSRUtils

public class MSRUtils
extends java.lang.Object

The MSRUtils class for integrating the methods of the Magnetic Stripe Reader (MSR) device. Provides convenient methods to interact with the MSR device.

Constructor Summary

Constructors

Constructor and Description
MSRUtils()

Method Summary

Modifier and Type	Method and Description
MSROperationResult	waitForSwipe(int timeout, android.content.Context context) Waits for a card swipe on the MSR device.

Methods inherited from class java.lang.Object

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

Constructor Detail

MSRUtils

public MSRUtils()

Method Detail

waitForSwipe

public MSROperationResult waitForSwipe(int timeout,
                                       android.content.Context context)
                                throws DeviceException

Waits for a card swipe on the MSR device.

This method opens the MSR device, waits for a card to be swiped within the specified timeout, and then closes the device.

In case of a timeout, the method returns null and closes the MSR reader. If a MSROperationResult is returned, it is the responsibility of the calling application to close the MSR reader.

The timeout parameter specifies the maximum time to wait for a swipe:

• If timeout == FOREVER, the method waits indefinitely.
• If timeout == IMMEDIATE, the method attempts an immediate read.

Parameters:

timeout - The maximum time to wait for a card swipe, in milliseconds.

context - The Android context.

Returns:

The result of the swipe operation, or null in case of a timeout.

Throws:

DeviceException - for standard device-related issues as documented in DeviceException.