문서의 이전 판입니다!

SDK API

initialize

SDK를 초기화합니다. 

void initialize(Context context, DeviceListener listener)

파라미터

  • context : 어플리케이션 콘텍스트
  • listener : 장치로부터 콜백 데이터가 수신되는 콜백 리스너
DeviceListener 클래스 보기
이 함수가 호출되지 않으면 SDK가 정상적으로 동작하지 않습니다.
애플리케이션을 실행한 뒤 가능한 빨리 호출되어야 합니다.


run

SDK 서비스를 실행합니다. 

int run()

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

SDK는 단일 애플리케이션에서만 사용 가능하도록 개발되었습니다.
다른 애플리케이션에서 동시 사용할 수 없으니 주의하십시오.


getVersions

SDK / Firmware 버전을 가져옵니다. 

int getVersions(Versions versions)

파라미터

  • versions : 버전 정보 (SDK / Firmware / 지문 라이브러리 / 카드 라이브러리)
Versions 클래스 보기

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

getDeviceInformation

장치 정보를 가져옵니다. 

int getDeviceInformation(Device device)

파라미터

  • device : 장치 정보
Device 클래스 보기

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.


setCardType

RF 카드 타입을 설정합니다. 

int setCardType(int cardType)

파라미터

  • cardType : RF 카드 타입
값 설명
1 HIGH_FREQUENCY
2 HIGH_FREQUENCY_ICLASS
3 LOW_FREQUENCY
4 LOW_FREQUENCY_PROX

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

기본적으로 장치에서 자동으로 설정 됩니다. 카드 타입 변경이 필요한 경우에만 사용됩니다.


connectFtpServer

FTP 서버에 연결합니다. 

int connectFtpServer(FirmwareOption option)

파라미터

  • option: 펌웨어 파일 옵션
FirmwareOption 클래스 보기

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.
해당 API는 FTP 클라이언트 역할을 합니다.

해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. 
<uses-permission android:name="android.permission.INTERNET"/>


disconnectFtpServer

FTP 서버에 연결을 해제합니다. 

int disconnectFtpServer()

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.
해당 API는 FTP 클라이언트 역할을 합니다.

해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. 
<uses-permission android:name="android.permission.INTERNET"/>


getFtpFileList

FTP 서버의 펌웨어 파일 이름 목록을 얻어옵니다. 

int getFtpFileList(ArrayList<String> fileList)

파라미터

  • fileList: 파일 이름 목록

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.
해당 API는 FTP 클라이언트 역할을 합니다.

해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. 
<uses-permission android:name="android.permission.INTERNET"/>


getUsbFileList

USB의 펌웨어 파일 이름 목록을 얻어옵니다. 

int getUsbFileList(ArrayList<String> fileList)

파라미터

  • fileList: 파일 이름 목록

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.


upgradeFirmware

지정된 펌웨어 파일로 업그레이드 파일을 복사합니다. 

int upgradeFirmware(FirmwareOption option)

파라미터

  • option: 펌웨어 파일 옵션
FirmwareOption 클래스 보기

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.
해당 API는 FTP 클라이언트 역할을 합니다.

해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. 
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />


rebootDevice

장치를 다시 시작합니다. 

int rebootDevice()

응답 코드

성공적으로 수행될 경우 SUCCESS를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다.

펌웨어 업그레이드는 장치 재시작 시 진행됩니다.