차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:sdk_api [2018/03/23 13:27] kkshin [BS2CredentialKeyInfo] |
ko:sdk_api [2018/12/24 16:42] jbkim [getVersion] |
||
---|---|---|---|
줄 1: | 줄 1: | ||
+ | ======SDK API====== | ||
+ | =====initialize===== | ||
+ | SDK를 초기화합니다. | ||
+ | <code java> | ||
+ | void initialize(Context context, DeviceListener listener) | ||
+ | </code> | ||
+ | === 파라미터 === | ||
+ | * ''context'' : 어플리케이션 콘텍스트 | ||
+ | * ''listener'' : 장치로부터 콜백 데이터가 수신되는 콜백 리스너 | ||
+ | <callout type="info"> | ||
+ | [[references#DeviceListener|DeviceListener 클래스 보기]] | ||
+ | </callout> | ||
+ | <callout type="info" icon="true"> | ||
+ | 이 함수가 호출되지 않으면 SDK가 정상적으로 동작하지 않습니다.\\ 애플리케이션을 실행한 뒤 가능한 빨리 호출되어야 합니다. | ||
+ | </callout> | ||
+ | \\ | ||
+ | =====run===== | ||
+ | SDK 서비스를 실행합니다. | ||
+ | <code java> | ||
+ | int run() | ||
+ | </code> | ||
+ | ===응답 코드 === | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | SDK는 단일 애플리케이션에서만 사용 가능하도록 개발되었습니다.\\ 다른 애플리케이션에서 동시 사용할 수 없으니 주의하십시오. | ||
+ | </callout> | ||
+ | \\ | ||
+ | |||
+ | =====getVersions===== | ||
+ | SDK / Firmware 버전을 가져옵니다. | ||
+ | <code java> | ||
+ | int getVersions(Versions versions) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''versions'' : SDK / Firmware 버전 | ||
+ | <callout type="info"> | ||
+ | [[references#Versions|Versions 클래스 보기]] | ||
+ | </callout> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | |||
+ | \\ | ||
+ | =====setCardType===== | ||
+ | RF 카드 타입을 설정합니다. | ||
+ | <code java> | ||
+ | int setCardType(int cardType) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''cardType'' : RF 카드 타입 | ||
+ | <WRAP group 50%> | ||
+ | ^ 값 ^설명 ^ | ||
+ | | 1 |HIGH_FREQUENCY | | ||
+ | | 2 |HIGH_FREQUENCY_ICLASS | | ||
+ | | 3 |LOW_FREQUENCY | | ||
+ | | 4 |LOW_FREQUENCY_PROX | | ||
+ | </WRAP> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | |||
+ | \\ | ||
+ | =====connectFtpServer===== | ||
+ | FTP 서버에 연결합니다. | ||
+ | <code java> | ||
+ | int connectFtpServer(FirmwareOption option) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''option'': 펌웨어 파일 옵션 | ||
+ | <callout type="info"> | ||
+ | [[references#FirmwareOption|FirmwareOption 클래스 보기]] | ||
+ | </callout> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | 펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.\\ 해당 API는 FTP 클라이언트 역할을 합니다.\\ \\ | ||
+ | 해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. | ||
+ | <code xml> | ||
+ | <uses-permission android:name="android.permission.INTERNET"/> | ||
+ | </code> | ||
+ | </callout> | ||
+ | |||
+ | \\ | ||
+ | =====disconnectFtpServer===== | ||
+ | FTP 서버에 연결을 해제합니다. | ||
+ | <code java> | ||
+ | int disconnectFtpServer() | ||
+ | </code> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | 펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.\\ 해당 API는 FTP 클라이언트 역할을 합니다.\\ \\ | ||
+ | 해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. | ||
+ | <code xml> | ||
+ | <uses-permission android:name="android.permission.INTERNET"/> | ||
+ | </code> | ||
+ | </callout> | ||
+ | |||
+ | \\ | ||
+ | =====getFtpFileList===== | ||
+ | FTP 서버의 펌웨어 파일 이름 목록을 얻어옵니다. | ||
+ | <code java> | ||
+ | int getFtpFileList(ArrayList<String> fileList) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''fileList'': 파일 이름 목록 | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | 펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.\\ 해당 API는 FTP 클라이언트 역할을 합니다.\\ \\ | ||
+ | 해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. | ||
+ | <code xml> | ||
+ | <uses-permission android:name="android.permission.INTERNET"/> | ||
+ | </code> | ||
+ | </callout> | ||
+ | |||
+ | \\ | ||
+ | =====getUsbFileList===== | ||
+ | USB의 펌웨어 파일 이름 목록을 얻어옵니다. | ||
+ | <code java> | ||
+ | int getUsbFileList(ArrayList<String> fileList) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''fileList'': 파일 이름 목록 | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | |||
+ | \\ | ||
+ | =====upgradeFirmware===== | ||
+ | 지정된 펌웨어 파일로 업그레이드 파일을 복사합니다. | ||
+ | <code java> | ||
+ | int upgradeFirmware(FirmwareOption option) | ||
+ | </code> | ||
+ | ===파라미터=== | ||
+ | * ''option'': 펌웨어 파일 옵션 | ||
+ | <callout type="info"> | ||
+ | [[references#FirmwareOption|FirmwareOption 클래스 보기]] | ||
+ | </callout> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | 펌웨어 업그레이드 기능을 사용하기 위해서는 FTP 서버 구축이 필요합니다.\\ 해당 API는 FTP 클라이언트 역할을 합니다.\\ \\ | ||
+ | 해당 API를 사용하려면 안드로이드 어플리케이션은 다음의 권한이 필수로 요구 됩니다. | ||
+ | <code xml> | ||
+ | <uses-permission android:name="android.permission.INTERNET"/> | ||
+ | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> | ||
+ | </code> | ||
+ | </callout> | ||
+ | |||
+ | \\ | ||
+ | =====rebootDevice===== | ||
+ | 장치를 다시 시작합니다. | ||
+ | <code java> | ||
+ | int rebootDevice() | ||
+ | </code> | ||
+ | ===응답 코드=== | ||
+ | 성공적으로 수행될 경우 ''SUCCESS''를 반환하며 에러가 발생 시 상응하는 에러 코드를 반환합니다. | ||
+ | <callout type="info" icon="true"> | ||
+ | 펌웨어 업그레이드는 장치 재시작 시 진행됩니다. | ||
+ | </callout> |