beautypg.com

Getmaskedtracks, Gettrack1, Gettrack2 – MagTek Audio Reader for Android Devices User Manual

Page 10

background image

4

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 HID specification requires that reports be fixed in size but the
number of bytes encoded on a card may vary. Therefore, the Input Report always contains the
maximum amount of bytes that can be encoded on the card and the number of valid bytes in each
track is indicated by the Masked Track Data Length field.

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 the ISO Track Masking
property and the AAMVA Track Masking property for more information. (Refer Appendix E in
Reference Manual 99875475 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.

-

public String getMaskedTracks()

Parameters

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

Return Value

Return stored track1 data string.

getTrack2

Get stored track2 data. This field contains the encrypted track data for track 2.