MTSCRA Class Methods - 1 - 10
After creating an instance of the MTSCRA class in your custom software project, use the methods described in this section to communicate with SCRA device.
setConnectionType
This method sets the connection type of the device.
public void setConnectionType(MTConnectionType connectionType)Parameters:
Parameter
Description
connectionType
MTConnectionType value: MTConnectionType.Unknown, MTConnectionType.Audio, MTConnectionType.BLE, MTConnectionType.BLEEMV, MTConnectionType.Bluetooth, MTConnectionType.USB, MTConnectionType.Serial, MTConnectionType.Net, MTConnectionType.Net_TLS12, MTConnectionType.Net_TLS12_Trust_All, MTConnectionType.BLEEMVT, MTConnectionType.AIDL
The following table shows the connection types supported by the various SCRA devices:
Connection Type
SCRA Device
Note
Audio
aDynamo uDynamo
Bluetooth LE
DynaMAX
Android 4.4.2 and above
Bluetooth LE EMV
eDynamo
Android 4.4.2 and above
Bluetooth LE EMVT
tDynamo
Android 4.4.2 and above
Bluetooth
BulleT
Card swipe only
USB
BulletT DynaMag DynaMAX eDynamo tDynamo DynaWave iDynamo 6
iDynamo 5 (Gen III)
Host must support USB On- The-Go.
Serial
DynaGlass
Android 7.1.2
Serial
DynaWave
Android 4.4.2 and above
AIDL
DynaGlass
Android 7.1.2
Return Value: None
setConnectionRetry
This function when set to True instructs the SDK to automatically retry to connect to the Bluetooth LE reader upon pairing. If set to False, the Bluetooth LE reader will be disconnected after pairing. This function is set to False by default in the SDK, but MagTek highly recommends to set this flag to True in your application in order to make sure that you'll have a successful secure connection between Android OS and Bluetooth LE reader after the paring.
Parameters:
Parameter
Description
connectionRetry
Connection retry value:
True = SDK will retry the conection after pairing.
False = SDK will not retry the connection after pairing.
Return Value: None
setAddress
This method sets the address of the device.
Parameters:
Parameter
Description
deviceAddress
String value of the address.
Return Value: None
setDeviceConfiguration
This method sets the configuration parameters for the device.
Parameters:
Parameter
Description
configuration
String value of the configuration parameters to be used for the device.
Audio Reader Device Configuration
Parameter
Default Value
Configurable Values
PAN_MOD10_CHECKDIGIT
TRUE
FALSE, TRUE
INPUT_AUDIO_SOURE
VRECOG
MIC, VRECOG
INPUT_SAMPLE_RATE_IN_HZ
44100
32000, 44100, 48000
Return Value: None
openDevice
This method opens connection to the device.
Parameters: None
Return Value: None
closeDevice
This method closes the connection to the device.
Parameters: None
Return Value: None
isDeviceConnected
This method returns whether the device is connected or not.
Parameters: None
Return Value:
Return true if the device is connected. Otherwise, return false.
isDeviceEMV
This method returns whether the device supports EMV or not.
Parameters: None
Return Value:
Return true if EMV is supported by the device. Otherwise, return false.
getMaskedTracks
Get stored masked tracks data. If decodable track data exists for a given track, it is located in the Masked Track Data field that corresponds to the track number. The length of each Masked Track Data field is fixed at 112 bytes, but the length of valid data in each field is determined by the Masked Track Data
Length field that corresponds to the track number. Masked Track Data located in positions greater than indicated in the Masked Track Data Length field are undefined and should be ignored.
The Masked Track Data is decoded and converted to ASCII and then it is masked. The Masked Track Data includes all data starting with the start sentinel and ending with the end sentinel. Much of the data is masked; a specified mask character is sent instead of the actual character read from the track. Which characters are masked depends on the format of the card. Only ISO/ABA (Financial Cards with Format Code B) and AAMVA cards are selectively masked; all other card types are either entirely masked or sent totally in the clear. There is a separate masking property for ISO/ABA cards and AAMVA cards. See D99875475 for the ISO Track Masking property and the AAMVA Track Masking property for more information. See D99875475 for a description on how ISO/ABA and AAMVA cards are identified.
Each of these properties allows the application to specify masking details for the Primary Account Number and Driver’s License / ID Number (DL/ID#), the masking character to be used, and whether a correction should be applied to make the Mod 10 9 (Luhn algorithm) digit at the end of the number be correct.
Parameters: None
Return Value:
Return stored masked tracks data string.
getTrack1
Get stored track1 data. This field contains the encrypted track data for track 1.
public String getTrack1()
Parameters: None
Return Value:
Return stored track1 data string.
Last updated