차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
ko:server_api [2023/02/09 16:10] mashin |
ko:server_api [2023/08/17 13:45] |
||
---|---|---|---|
줄 1: | 줄 1: | ||
- | ====== Server API ====== | ||
- | 서버 매칭를 사용하거나, BioStar 애플리케이션에서 단말기를 직접 제어할 수 있습니다. \\ | ||
- | <callout type="warning" icon="true"><WRAP em>주의사항</WRAP> \\ | ||
- | 독립된 별도의 법인에서 제공하는 UFMatcher.dll의 관리문제로, 더 이상 실행가능한 예제를 제공하지 않습니다. \\ | ||
- | 기존의 예제는 코드 레벨에서의 참조만 부탁드립니다. \\ \\ | ||
- | 서버 매칭용 library를 포함한, 기타 기술지원은 슈프리마ID의 영업팀을 통해 제공받으실 수 있습니다. \\ | ||
- | <wrap hi>슈프리마ID : sales_id@supremainc.com</wrap> \\ | ||
- | </callout> | ||
- | |||
- | * [[BS2_SetServerMatchingHandler]]: 서버 매칭 핸들러를 등록합니다. | ||
- | * [[BS2_VerifyUser]]: 카드나 User ID의 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_IdentifyUser]]: 지문 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_VerifyUserEx]]: [+ 2.4.0] 카드나 User ID의 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_IdentifyUserEx]]: [+ 2.4.0] 지문 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_VerifyUserSmall]]: [+ 2.6.3] 카드나 User ID의 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_IdentifyUserSmall]]: [+ 2.6.3] 지문 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_VerifyUserSmallEx]]: [+ 2.6.3] 카드나 User ID의 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_IdentifyUserSmallEx]]: [+ 2.6.3] 지문 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_VerifyUserFaceEx]]: [+ 2.7.2] 카드나 User ID의 인증 결과와 맵핑된 유저 정보를 단말기로 전송합니다. | ||
- | * [[BS2_SetUserPhraseHandler]]: [+ 2.7.0] 서버요청 개인 메시지 핸들러를 등록합니다. | ||
- | * [[BS2_ResponseUserPhrase]]: [+ 2.7.0] 개인 메시지를 단말기로 전송합니다. | ||
- | * [[BS2_SetBarcodeScanListener]]: [+2.8.2] Barcode 입력을 감지하는 listener 함수를 등록합니다. | ||
- | |||
- | ===== 콜백함수 ====== | ||
- | <code cpp> | ||
- | typedef void (*OnVerifyUser)(uint32_t deviceId, uint16_t seq, uint8_t isCard, uint8_t cardType, const uint8_t* data, uint32_t dataLen); | ||
- | typedef void (*OnIdentifyUser)(uint32_t deviceId, uint16_t seq, uint8_t format, const uint8_t* templateData, uint32_t templateSize); | ||
- | </code> | ||
- | 1. //OnVerifyUser// \\ | ||
- | 장치에서 Card나, User ID가 일치하는지를 BioStar 애플리케이션에서 판별해야 할 때 호출되는 콜백 함수입니다. \\ \\ | ||
- | 2. //OnIdentifyUser// \\ | ||
- | 장치에서 지문이 일치하는지를 BioStar 애플리케이션에서 판별해야 할 때 호출되는 콜백 함수입니다. \\ \\ | ||
- | |||
- | ==== OnUserPhrase ==== | ||
- | 개인 메시지를 서버에 요청하는 콜백 함수입니다. | ||
- | <code cpp> | ||
- | typedef void (*OnUserPhrase)(uint32_t deviceId, uint16_t seq, const char* userID); | ||
- | </code> | ||
- | \\ | ||
- | |||
- | 1. //deviceId// \\ | ||
- | 장치 식별자입니다. \\ \\ | ||
- | 2. //seq// \\ | ||
- | 패킷 일련번호입니다. \\ \\ | ||
- | 3. //userID// \\ | ||
- | 사용자 ID 입니다. \\ \\ | ||
- | |||
- | ==== OnBarcodeScanned ==== | ||
- | 장치에서 barcode가 scan 되었을 때 호출되는 콜백 함수입니다. \\ \\ | ||
- | <code cpp> | ||
- | typedef void (*OnBarcodeScanned)(uint32_t deviceId, const char* barcode); | ||
- | </code> | ||
- | \\ | ||
- | 1. //deviceId// \\ | ||
- | 읽혀진 barcode를 보내준 장치 ID입니다. \\ \\ | ||
- | 2. //barcode// \\ | ||
- | 장치로부터 읽혀진 barcode 문자열입니다. \\ \\ | ||
- | |||
- | |||
- | ==== OnOsdpStandardDeviceStatusChanged ==== | ||
- | OSDP 장치의 상태가 변화되었을 때 호출되는 콜백 함수입니다. \\ \\ | ||
- | <code cpp> | ||
- | typedef void (*OnOsdpStandardDeviceStatusChanged)(uint32_t deviceId, const BS2OsdpStandardDeviceNotify* notifyData); | ||
- | </code> | ||
- | \\ | ||
- | 1. //deviceId// \\ | ||
- | OSDP 장치 식별자입니다. \\ \\ | ||
- | 2. //notifyData// \\ | ||
- | OSDP 장치 정보입니다. \\ \\ |