차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 | |||
ko:configuration_api [2024/05/28 19:34] kkshin [BS2FaceConfigExt] |
ko:configuration_api [2024/05/28 19:37] kkshin |
||
---|---|---|---|
줄 2857: | 줄 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// \\ | ||
- | 예약된 공간입니다. \\ | ||