====== Server API ======

서버 매칭를 사용하거나, BioStar 애플리케이션에서 단말기를 직접 제어할 수 있습니다. \\
<callout type="warning" icon="true">**주의 사항** \\
독립된 별도의 법인에서 제공하는 UFMatcher.dll의 관리문제로, 더 이상 실행가능한 예제를 제공하지 않습니다. \\
기존의 예제는 코드 레벨에서의 참조만 부탁드립니다. \\ \\
서버 매칭용 지문 library를 포함한, 기타 기술지원은 Xperix를 통해 제공받으실 수 있습니다. \\
<wrap hi>Xperix : https://www.xperix.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 함수를 등록합니다.
  * [[BS2_SetOsdpStandardDeviceStatusListener]]: [+ 2.9.1] OSDP 장치의 상태변화를 감지하는 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 장치 정보입니다.  \\ \\