차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판 		이전 판
ko:configuration_api [2024/04/04 13:51]
ghshin [BS2FaceConfig] operationMode 값 장치별로 설명 		ko:configuration_api [2024/05/28 19:37] (현재)
kkshin
줄 70: 줄 70:
   * [[BS2_GetDesFireCardConfigEx]]:​ [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.   * [[BS2_GetDesFireCardConfigEx]]:​ [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다.
   * [[BS2_SetDesFireCardConfigEx]]:​ [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.   * [[BS2_SetDesFireCardConfigEx]]:​ [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다.
-  * [[BS2_GetAuthConfigExt]]:​ [+ 2.7.1] ''​FSF2''​ 인증 설정 정보를 가져옵니다. +  * [[BS2_GetAuthConfigExt]]:​ [+ 2.7.1] ''​Visual Face 기반 장치''​ 인증 설정 정보를 가져옵니다. 
-  * [[BS2_SetAuthConfigExt]]:​ [+ 2.7.1] ''​FSF2''​ 인증 설정 정보를 저장합니다. +  * [[BS2_SetAuthConfigExt]]:​ [+ 2.7.1] ''​Visual Face 기반 장치''​ 인증 설정 정보를 저장합니다. 
-  * [[BS2_GetFaceConfigExt]]:​ [+ 2.7.1] ​''​FSF2,​ FS2'' ​열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다. +  * [[BS2_GetFaceConfigExt]]:​ [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다. 
-  * [[BS2_SetFaceConfigExt]]:​ [+ 2.7.1] ​''​FSF2,​ FS2'' ​열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다. +  * [[BS2_SetFaceConfigExt]]:​ [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다. 
-  * [[BS2_GetThermalCameraConfig]]:​ [+ 2.7.1] ​''​FSF2,​ FS2'' ​열화상 카메라 설정을 가져옵니다. +  * [[BS2_GetThermalCameraConfig]]:​ [+ 2.7.1] 열화상 카메라 설정을 가져옵니다. 
-  * [[BS2_SetThermalCameraConfig]]:​ [+ 2.7.1] ​''​FSF2,​ FS2'' ​열화상 카메라 설정을 저장합니다.+  * [[BS2_SetThermalCameraConfig]]:​ [+ 2.7.1] 열화상 카메라 설정을 저장합니다.
   * [[BS2_GetBarcodeConfig]]:​ [+ 2.8] ''​XS2''​ Barcode 관련 설정을 가져옵니다.   * [[BS2_GetBarcodeConfig]]:​ [+ 2.8] ''​XS2''​ Barcode 관련 설정을 가져옵니다.
   * [[BS2_SetBarcodeConfig]]:​ [+ 2.8] ''​XS2''​ Barcode 관련 설정을 저장합니다.   * [[BS2_SetBarcodeConfig]]:​ [+ 2.8] ''​XS2''​ Barcode 관련 설정을 저장합니다.
줄 82: 줄 82:
   * [[BS2_GetRelayActionConfig]]:​ [+ 2.8.1] ''​IM-120''​ RelayAction 관련 설정을 가져옵니다.   * [[BS2_GetRelayActionConfig]]:​ [+ 2.8.1] ''​IM-120''​ RelayAction 관련 설정을 가져옵니다.
   * [[BS2_SetRelayActionConfig]]:​ [+ 2.8.1] ''​IM-120''​ RelayAction 관련 설정을 저장합니다.   * [[BS2_SetRelayActionConfig]]:​ [+ 2.8.1] ''​IM-120''​ RelayAction 관련 설정을 저장합니다.
-  * [[BS2_GetVoipConfigExt]]:​ [+ 2.8.3] ​''​BS3'' ​확장형 VoIP 설정을 가져옵니다. +  * [[BS2_GetVoipConfigExt]]:​ [+ 2.8.3] 확장형 VoIP 설정을 가져옵니다. 
-  * [[BS2_SetVoipConfigExt]]:​ [+ 2.8.3] ​''​BS3'' ​확장형 VoIP 설정을 저장합니다. +  * [[BS2_SetVoipConfigExt]]:​ [+ 2.8.3] 확장형 VoIP 설정을 저장합니다. 
-  * [[BS2_GetRtspConfig]]:​ [+ 2.8.3] ​''​BS3'' ​RTSP 설정을 가져옵니다. +  * [[BS2_GetRtspConfig]]:​ [+ 2.8.3] RTSP 설정을 가져옵니다. 
-  * [[BS2_SetRtspConfig]]:​ [+ 2.8.3] ​''​BS3'' ​RTSP 설정을 저장합니다.+  * [[BS2_SetRtspConfig]]:​ [+ 2.8.3] RTSP 설정을 저장합니다.
   * [[BS2_GetLicenseConfig]]:​ [+ 2.9.1] 장치 라이선스 활성화 정보를 가져옵니다.   * [[BS2_GetLicenseConfig]]:​ [+ 2.9.1] 장치 라이선스 활성화 정보를 가져옵니다.
   * [[BS2_GetOsdpStandardConfig]]:​ [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다.   * [[BS2_GetOsdpStandardConfig]]:​ [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다.
줄 493: 줄 493:
 장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\  장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\ 
 17. //​useScreenSaver//​ \\  17. //​useScreenSaver//​ \\ 
-''​FaceStation 2'',​ ''​FaceStation F2'' ​true로 설정 시, 화면보호기가 활성화됩니다. \\ \\+true로 설정 시, 화면보호기가 활성화됩니다. \\ \\
 18. //​showOsdpResult//​ \\  18. //​showOsdpResult//​ \\ 
 [+ 2.9.6] Intelligent slave나 타사 컨트롤러에 슈프리마 장치를 주변장치로 연결하여 사용하는 환경에서 \\ [+ 2.9.6] Intelligent slave나 타사 컨트롤러에 슈프리마 장치를 주변장치로 연결하여 사용하는 환경에서 \\
줄 1744: 줄 1744:
 |1  |옥외 ​ | |1  |옥외 ​ |
 |2  |자동 ​ | |2  |자동 ​ |
-|3  |[+ 2.8] 사용 안함 ​''​(FaceStation F2)'' ​ |+|3  |[+ 2.8] 사용 안함 ​ |
 </​WRAP>​ </​WRAP>​
 3. //​enrollThreshold//​ \\  3. //​enrollThreshold//​ \\ 
줄 1771: 줄 1771:
 </​WRAP>​ </​WRAP>​
 5. //​enrollTimeout//​ \\  5. //​enrollTimeout//​ \\ 
-''​FaceStation2,​ FaceLite''​ : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ +''​IR Face 기반''​ : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ 
 <WRAP group 60%> <WRAP group 60%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1778: 줄 1778:
 |BS2_FACE_ENROLL_TIMEOUT_DEFAULT ​ |BS2_FACE_ENROLL_TIMEOUT_MAX ​ | |BS2_FACE_ENROLL_TIMEOUT_DEFAULT ​ |BS2_FACE_ENROLL_TIMEOUT_MAX ​ |
 </​WRAP>​ </​WRAP>​
-''​FaceStation F2''​ : [+ V2.7.1] ​ 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ +''​Visual Face 기반''​ : [+ V2.7.1] ​ 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ 
 <WRAP group 70%> <WRAP group 70%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1787: 줄 1787:
 6. //​lfdLevel//​ \\ 6. //​lfdLevel//​ \\
 [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\
-''​FaceStation2,​ FaceLite''​ : 기본값은 0입니다. \\ +''​IR Face 기반''​ : 기본값은 0입니다. \\ 
-''​FaceStation F2''​ : [+ 2.7.1] 기본값이 1입니다. \\+''​Visual Face 기반''​ : [+ 2.7.1] 기본값이 1입니다. \\
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 1820: 줄 1820:
 </​WRAP> ​ </​WRAP> ​
  
-''​FaceStation F2 V1.0.1''​이상,​ ''​BioStatoin 3'',​ ''​BioEntry W3''​는 아래와 같은 의미로 사용됩니다.+''​FaceStation F2 V1.0.1''​이상,​ ''​Visual Face 기반''​는 아래와 같은 의미로 사용됩니다.
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^모드 ​ ^설명 ​ ^기본값 ​ ^ ^값  ^모드 ​ ^설명 ​ ^기본값 ​ ^
 |0  |Fusion 모드 |Visual matching + IR matching |기본 | |0  |Fusion 모드 |Visual matching + IR matching |기본 |
-|1  |Face 모드 |Visual matching | |+|1  |Fast 모드 |Visual matching | |
 </​WRAP> ​ </​WRAP> ​
 11. //​maxRotation//​ \\  11. //​maxRotation//​ \\ 
-[+ 2.7.1] ''​FaceStation F2''​ 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\ 
-FaceStation F2는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\+이 경우 장치는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\
 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\ 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\
 maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\ maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\
줄 1844: 줄 1844:
 </​WRAP> ​ </​WRAP> ​
 12. //​faceWidth//​ \\  12. //​faceWidth//​ \\ 
-[+ 2.7.1] ''​FaceStation F2''​ 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\ 
 최소값, 최대값의 기본값은 아래와 같습니다. \\ 최소값, 최대값의 기본값은 아래와 같습니다. \\
 <WRAP group 30%> <WRAP group 30%>
줄 1853: 줄 1853:
 </​WRAP> ​ </​WRAP> ​
 13. //​searchRange//​ \\ 13. //​searchRange//​ \\
-[+ 2.7.1] ''​FaceStation F2''​ 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\ +[+ 2.7.1] ''​Visual Face 기반''​ 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\ 
 x값과 폭의 기본값은 아래와 같습니다. \\ x값과 폭의 기본값은 아래와 같습니다. \\
 <WRAP group 30%> <WRAP group 30%>
줄 1862: 줄 1862:
 </​WRAP> ​ </​WRAP> ​
 14. //​detectDistance//​ \\ 14. //​detectDistance//​ \\
-[+ 2.8.3] ''​BioStation 3''​ 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\ +[+ 2.8.3] ''​Visual Face 기반''​ 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\
-[+ 2.9.6] ''​FaceStation F2''​ ''​BioEntry W3''​ 기능추가. \\+
 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\ 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\
 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며,​ 10의 배수로 입력하여야 합니다. \\ 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며,​ 10의 배수로 입력하여야 합니다. \\
줄 1873: 줄 1872:
 </​WRAP> ​ </​WRAP> ​
 15. //​wideSearch//​ \\ 15. //​wideSearch//​ \\
-[+ 2.8.3] ''​BioStation 3''​ 얼굴 감지 범위를 넓힙니다. \\+[+ 2.8.3] ''​BioStation 3, BioEntry W3''​ 얼굴 감지 범위를 넓힙니다. \\
 x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\ x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\
 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\ 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\
줄 2376: 줄 2375:
 </​WRAP>​ </​WRAP>​
 2. //​maskCheckMode//​ \\  2. //​maskCheckMode//​ \\ 
-''​FaceStation F2''​ 마스크 착용 감지 모드를 설정합니다. \\  +''​Visual Face 기반''​ 마스크 착용 감지 모드를 설정합니다. \\ 
-''​FaceStation 2''​ 이 설정은 무시됩니다. \\ +
 HARD로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면,​ 출입에 영향을 주게됩니다. \\ HARD로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면,​ 출입에 영향을 주게됩니다. \\
 SOFT로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면,​ 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\ SOFT로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면,​ 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\
줄 2401: 줄 2399:
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
 6. //​thermalThresholdLow//​ \\ 6. //​thermalThresholdLow//​ \\
-''​지원 버전''​ : ''​FaceStation F2 V1.0.2'',​ ''​FaceStation 2 V1.5.0''​ \\  
 고열 판단 기준의 범위값이며,​ 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\ 고열 판단 기준의 범위값이며,​ 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\
 또한 섭씨 기준으로만 입력할 수 있습니다. \\ 또한 섭씨 기준으로만 입력할 수 있습니다. \\
줄 2414: 줄 2411:
 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\ 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\
 8. //​maskDetectionLevel//​ \\ 8. //​maskDetectionLevel//​ \\
-''​FaceStation F2''​ 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\ +''​Visual Face 기반''​ 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\
-''​FaceStation 2''​ 이 설정은 무시됩니다. \\ +
 <WRAP group 50%> <WRAP group 50%>
 ^값  ^설명 ​ ^기본값 ​ ^ ^값  ^설명 ​ ^기본값 ​ ^
줄 2861: 줄 2857:
 5. //​reserved1//​ \\  5. //​reserved1//​ \\ 
 예약된 공간입니다. \\ \\ 예약된 공간입니다. \\ \\
- 
- 
-==== BS2BarcodeConfig ==== 
-<code cpp> 
-typedef struct { 
-    uint8_t useBarcode; 
-    uint8_t scanTimeout;​ 
-    uint8_t bypassData; 
-    uint8_t treatAsCSN; 
- 
- uint8_t useVisualBarcode;​ 
- uint8_t motionSensitivity;​ 
-    uint8_t visualCameraScanTimeout;​ 
-    uint8_t reserved[9];​ 
-} BS2BarcodeConfig;​ 
-</​code>​ 
-1. //​useBarcode//​ \\  
-''​XS2-QR 만 지원''​ 
-Barcode 사용여부 flag입니다. \\ \\  
-2. //​scanTimeout//​ \\  
-Barcode scan 시간을 설정합니다. 단위는 초입니다. \\ 
-기본값은 4초이며, 4~10초 범위 내로 입력 가능합니다. \\ \\ 
-<WRAP group 50%> 
-^값  ^매크로 ​ ^설명 ​ ^ 
-|4  |BS2_BARCODE_TIMEOUT_DEFAULT ​ |기본값 ​ | 
-|4  |BS2_BARCODE_TIMEOUT_MIN ​ |최소값 ​ | 
-|10  |BS2_BARCODE_TIMEOUT_MAX ​ |최대값 ​ | 
-</​WRAP>​ 
-3. //​bypassData//​ \\  
-[+2.8.2] 읽혀진 barcode 정보를 장치에서 처리하지 않고, 서버로 전송하기 위해 사용합니다. \\ 
-사용자 인증을 위해 사용자 정보 구조체에 barcode 값을 저장하게되는 경우, \\ 
-32 byte의 크기 제약([[smartcard_api#​BS2CSNCard|BS2CSNCard data 참조]])이 있으나, \\ 
-[[BS2_SetBarcodeScanListener]]를 호출하고,​ 이 옵션을 사용하면 최대 512 byte크기의 barcode를 서버로 전송할 수 있습니다. \\ \\ 
-4. //​treatAsCSN//​ \\ 
-[+2.8.2] Barcode를 일반 CSN 카드와 동일하게 처리할지의 여부를 나타냅니다. \\ 
-XS2-QR 1.1.3부터 적용되며,​ false의 경우, 이전과 동일하게 처리됩니다. \\ 
-이방식은 barcode로 처리될 수 있는 문자셋을 ASCII code 32에서 126까지 자유롭게 지정할 수 있습니다. ([[qr_code_api#​BS2_WriteQRCode|BS2_WriteQRCode의 설명 참조]]) \\ 
-true로 설정하면,​ barcode를 기존 CSN과 동일하게 숫자로만 취급하게 됩니다. \\ 
-따라서, 특수문자,​ 영문자가 들어있는 barcode 카드 데이터를 설정하고자 하면 오류를 반환할 수 있습니다. \\ 
-이 경우, card type만 다르게, CSN 카드와 barcode 데이터를 동일한 값으로 사용하고자하는 사용자의 목적에 부합할 수 있습니다. \\ \\ 
-5. //​useVisualBarcode//​ \\ 
-[+ 2.9.1] Visual barcode 사용여부 flag입니다. \\ 
-<WRAP group 50%> 
-^지원장치 ​ ^펌웨어 ​ ^ 
-|XS2-Finger ​ |V1.2.0 ​ | 
-|XS2-Card ​ |V1.2.0 ​ | 
-|BS3  |V1.1.0 ​ | 
-</​WRAP>​ 
-Visual barcode는 QR code sensor가 아닌, 일반 visual camera를 통해 QR code 읽기를 지원하며,​ \\ 
-이 기능을 사용하기 위해서는,​ 별도의 라이선스 활성화가 필요합니다. \\ 
-라이선스 활성화는 [[BS2_EnableDeviceLicense]]를 통해 지원합니다. \\ \\ 
-6. //​motionSensitivity//​ \\ 
-[+ 2.9.1] Visual barcode에 대한, 모션 센서의 감도를 설정합니다. \\ 
-<WRAP group 50%> 
-^값  ^매크로 ​ ^설명 ​ ^ 
-|0  |BS2_MOTION_SENSITIVITY_LOW ​ |낮음 ​ | 
-|1  |BS2_MOTION_SENSITIVITY_NORMAL ​ |중간 ​ | 
-|2  |BS2_MOTION_SENSITIVITY_HIGH ​ |높음 ​ | 
-</​WRAP>​ 
-7. //​visualCameraScanTimeout//​ \\ 
-[+ 2.9.1] Visual camera에대한 scan 시간을 설정합니다. 단위는 초입니다. \\ 
-기본값은 10초이며,​ 3~20초 범위 내로 입력 가능합니다. \\ 
-<WRAP group 50%> 
-^값  ^매크로 ​ ^설명 ​ ^ 
-|10  |BS2_VISUAL_BARCODE_TIMEOUT_DEFAULT ​ |기본값 ​ | 
-|3  |BS2_VISUAL_BARCODE_TIMEOUT_MIN ​ |최소값 ​ | 
-|20  |BS2_VISUAL_BARCODE_TIMEOUT_MAX ​ |최대값 ​ | 
-</​WRAP>​ 
-8. //​reserved//​ \\  
-예약된 공간입니다. \\