차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:log_management_api [2018/03/07 22:00] kkshin [BS2Event] |
ko:log_management_api [2020/08/21 14:20] kkshin [BS2EventSmallBlob] |
||
---|---|---|---|
줄 8: | 줄 8: | ||
* [[BS2_ClearLog]]: 모든 로그를 삭제합니다. | * [[BS2_ClearLog]]: 모든 로그를 삭제합니다. | ||
* [[BS2_StartMonitoringLog]]: 실시간 로그 스트리밍을 시작합니다. | * [[BS2_StartMonitoringLog]]: 실시간 로그 스트리밍을 시작합니다. | ||
+ | * [[BS2_StartMonitoringLogEx]]: 측정 체온이 포함된, 실시간 로그 스트리밍을 시작합니다. [+ V2.7.1] | ||
* [[BS2_StopMonitoringLog]]: 실시간 로그 스트리밍을 중단합니다. | * [[BS2_StopMonitoringLog]]: 실시간 로그 스트리밍을 중단합니다. | ||
* [[BS2_GetLogBlob]]: EventMask에 맞게 일정량의 로그를 가져옵니다. | * [[BS2_GetLogBlob]]: EventMask에 맞게 일정량의 로그를 가져옵니다. | ||
* [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다. | * [[BS2_GetFilteredLogSinceEventId]]: 조건에 맞는 로그를 가져옵니다. | ||
+ | * [[BS2_GetImageLog]]: 이미지로그를 가져옵니다. | ||
+ | * [[BS2_GetLogSmallBlob]]: [+ 2.6.4] 효율적으로 메모리를 사용하면서, EventMask에 맞게 일정량의 로그를 가져옵니다. | ||
+ | |||
===== 콜백 함수 ===== | ===== 콜백 함수 ===== | ||
+ | ==== OnLogReceived ==== | ||
+ | 장치로부터 새로운 로그를 수신했을 때 호출되는 콜백 함수입니다. \\ \\ | ||
<code cpp> | <code cpp> | ||
typedef void (*OnLogReceived)(uint32_t deviceId, BS2Event* log); | typedef void (*OnLogReceived)(uint32_t deviceId, BS2Event* log); | ||
</code> | </code> | ||
\\ | \\ | ||
+ | 1. //deviceId// \\ | ||
+ | 새로운 로그를 보내준 장치 ID입니다. \\ \\ | ||
+ | 2. //log// \\ | ||
+ | 새로운 로그 정보 구조체입니다. \\ \\ | ||
- | 1. //OnLogReceived// \\ | + | ==== OnLogReceivedEx ==== |
- | 장치로부터 새로운 로그를 수신했을 때 호출되는 콜백 함수입니다. \\ \\ | + | [+ V2.7.1] 장치로부터 새로운 로그를 수신했을 때 호출되는 콜백 함수입니다. \\ |
+ | 열화상 카메라를 통해 측정된 체온이 세번째 인자로 수신되며, [[configuration api#BS2FaceConfigExt]]의 auditTemperature가 true로 설정되어져야 합니다. \\ \\ | ||
+ | <code cpp> | ||
+ | typedef void (*OnLogReceivedEx)(uint32_t deviceId, BS2Event* log, uint32_t temperature); | ||
+ | </code> | ||
+ | \\ | ||
+ | 1. //deviceId// \\ | ||
+ | 새로운 로그를 보내준 장치 ID입니다. \\ \\ | ||
+ | 2. //log// \\ | ||
+ | 새로운 로그 정보 구조체입니다. \\ \\ | ||
+ | 3. //temperature// \\ | ||
+ | 새로운 로그 발생 시, 측정된 체온 정보입니다. \\ \\ | ||
===== 구조체 ===== | ===== 구조체 ===== | ||
==== BS2Event ==== | ==== BS2Event ==== | ||
줄 119: | 줄 139: | ||
|::: |BS2_SUB_EVENT_VERIFY_ID_FACE |0x04 |주어진 사용자 식별자로 얼굴 인식 성공 | | |::: |BS2_SUB_EVENT_VERIFY_ID_FACE |0x04 |주어진 사용자 식별자로 얼굴 인식 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_ID_FACE_PIN |0x05 |주어진 사용자 식별자로 얼굴 인식과 PIN 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_ID_FACE_PIN |0x05 |주어진 사용자 식별자로 얼굴 인식과 PIN 인증 성공 | | ||
- | |::: |BS2_SUB_EVENT_VERIFY_CARD |0x06 |스마트 카드 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD |0x06 |카드 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_PIN |0x07 |스마트 카드와 PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_PIN |0x07 |카드와 PIN 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER |0x08 |스마트 카드와 지문 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER |0x08 |카드와 지문 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER_PIN |0x09 |스마트 카드, 지문, PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FINGER_PIN |0x09 |카드, 지문, PIN 인증 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE |0x0A |스마트 카드 인증과 얼굴 인식 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE |0x0A |카드 인증과 얼굴 인식 성공 | |
- | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE_PIN |0x0B |스마트 카드, 얼굴 인식, PIN 인증 성공 | | + | |::: |BS2_SUB_EVENT_VERIFY_CARD_FACE_PIN |0x0B |카드, 얼굴 인식, PIN 인증 성공 | |
|::: |BS2_SUB_EVENT_VERIFY_AOC |0x0C |AOC 카드 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC |0x0C |AOC 카드 인증 성공 | | ||
|::: |BS2_SUB_EVENT_VERIFY_AOC_PIN |0x0D |AOC 카드와 PIN 인증 성공 | | |::: |BS2_SUB_EVENT_VERIFY_AOC_PIN |0x0D |AOC 카드와 PIN 인증 성공 | | ||
줄 136: | 줄 156: | ||
|::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | |::: |BS2_SUB_EVENT_DUAL_AUTH_FAIL_ACCESS_GROUP |0x02 |유효하지 않은 사용자로 2인 인증 시도 | | ||
|Credential |BS2_SUB_EVENT_CREDENTIAL_ID |0x01 |등록되지 않은 사용자 식별자 | | |Credential |BS2_SUB_EVENT_CREDENTIAL_ID |0x01 |등록되지 않은 사용자 식별자 | | ||
- | |::: |BS2_SUB_EVENT_CREDENTIAL_CARD |0x02 |유효하지 않은 스마트 카드 | | + | |::: |BS2_SUB_EVENT_CREDENTIAL_CARD |0x02 |유효하지 않은 카드 | |
|::: |BS2_SUB_EVENT_CREDENTIAL_PIN |0x03 |유효하지 않은 PIN | | |::: |BS2_SUB_EVENT_CREDENTIAL_PIN |0x03 |유효하지 않은 PIN | | ||
|::: |BS2_SUB_EVENT_CREDENTIAL_FINGER |0x04 |유효하지 않은 지문 | | |::: |BS2_SUB_EVENT_CREDENTIAL_FINGER |0x04 |유효하지 않은 지문 | | ||
줄 176: | 줄 196: | ||
|::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | |::: |BS2_EVENT_USER_DELETE_ALL_SUCCESS |0x2600 |전체 사용자 삭제 성공 | | ||
|::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2700 |Access card로 인증 성공 | | |::: |BS2_EVENT_USER_ISSUE_AOC_SUCCESS |0x2700 |Access card로 인증 성공 | | ||
+ | |::: |BS2_EVENT_USER_DUPLICATE_CREDENTIAL |0x2800 |중복 인증(카드/지문/얼굴)정보 검출 | | ||
|Device |BS2_EVENT_DEVICE_SYSTEM_RESET |0x3000 |시스템 다시 시작 | | |Device |BS2_EVENT_DEVICE_SYSTEM_RESET |0x3000 |시스템 다시 시작 | | ||
|::: |BS2_EVENT_DEVICE_SYSTEM_STARTED |0x3100 |시스템이 시작됨 | | |::: |BS2_EVENT_DEVICE_SYSTEM_STARTED |0x3100 |시스템이 시작됨 | | ||
|::: |BS2_EVENT_DEVICE_TIME_SET |0x3200 |시스템 시간 변경 | | |::: |BS2_EVENT_DEVICE_TIME_SET |0x3200 |시스템 시간 변경 | | ||
+ | |::: |BS2_EVENT_DEVICE_TIMEZONE_SET |0x3201 |Time zone 변경 | | ||
+ | |::: |BS2_EVENT_DEVICE_DST_SET |0x3202 |DST 설정 변경 | | ||
|::: |BS2_EVENT_DEVICE_LINK_CONNECTED |0x3300 |LAN 케이블 연결됨 | | |::: |BS2_EVENT_DEVICE_LINK_CONNECTED |0x3300 |LAN 케이블 연결됨 | | ||
|::: |BS2_EVENT_DEVICE_LINK_DISCONNETED |0x3400 |LAN 케이블 빠짐 | | |::: |BS2_EVENT_DEVICE_LINK_DISCONNETED |0x3400 |LAN 케이블 빠짐 | | ||
줄 197: | 줄 220: | ||
|::: |BS2_EVENT_DEVICE_FIRMWARE_UPGRADED |0x4300 |펌웨어가 업데이트됨 | | |::: |BS2_EVENT_DEVICE_FIRMWARE_UPGRADED |0x4300 |펌웨어가 업데이트됨 | | ||
|::: |BS2_EVENT_DEVICE_RESOURCE_UPGRADED |0x4400 |리소스가 업데이트됨 | | |::: |BS2_EVENT_DEVICE_RESOURCE_UPGRADED |0x4400 |리소스가 업데이트됨 | | ||
- | |::: |BS2_EVENT_DEVICE_CONFIG_RESET |0x4500 |시스템 구성 정보가 초기화됨 | | + | |::: |BS2_EVENT_DEVICE_CONFIG_RESET |0x4500 |시스템 구성 정보가 초기화됨 (네트워크 정보 포함) | |
|::: |BS2_EVENT_DEVICE_DATABASE_RESET |0x4501 |데이터베이스가 초기화됨 | | |::: |BS2_EVENT_DEVICE_DATABASE_RESET |0x4501 |데이터베이스가 초기화됨 | | ||
|::: |BS2_EVENT_DEVICE_FACTORY_RESET |0x4502 |공장 초기화됨 | | |::: |BS2_EVENT_DEVICE_FACTORY_RESET |0x4502 |공장 초기화됨 | | ||
- | |::: |BS2_EVENT_DEVICE_CONFIG_RESET_EX |0x4503 |시스템 구성 정보가 초기화됨 | | + | |::: |BS2_EVENT_DEVICE_CONFIG_RESET_EX |0x4503 |시스템 구성 정보가 초기화됨 (네트워크 정보 제외) | |
|Supervised Input |BS2_EVENT_SUPERVISED_INPUT_SHORT |0x4600 |Supervised Input (단락 감지) | | |Supervised Input |BS2_EVENT_SUPERVISED_INPUT_SHORT |0x4600 |Supervised Input (단락 감지) | | ||
|::: |BS2_EVENT_SUPERVISED_INPUT_OPEN |0x4700 |Supervised Input (단선 감지) | | |::: |BS2_EVENT_SUPERVISED_INPUT_OPEN |0x4700 |Supervised Input (단선 감지) | | ||
줄 229: | 줄 252: | ||
|::: |BS2_EVENT_ZONE_FIRE_ALARM |0x6700 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 시작 | | |::: |BS2_EVENT_ZONE_FIRE_ALARM |0x6700 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 시작 | | ||
|::: |BS2_EVENT_ZONE_FIRE_ALARM_CLEAR |0x6800 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 해제 | | |::: |BS2_EVENT_ZONE_FIRE_ALARM_CLEAR |0x6800 |BS2_EVENT_ZONE_FIRE_ALARM_INPUT 이벤트 발생 경보 해제 | | ||
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_VIOLATION |0x6900 |구역내 강제 잠금 위반 감지 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_VIOLATION |0x6900 |스케줄 잠금 구역 위반 감지 | |
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_START |0x6A00 |구역내 강제 잠금 시작 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_START |0x6A00 |스케줄 잠금 구역 시작 | |
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_END |0x6B00 |구역내 강제 잠금 끝 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_END |0x6B00 |스케줄 잠금 구역 끝 | |
- | |::: |BS2_EVENT_ZONE_FORCED_UNLOCK_START |0x6C00 |구역내 강제 잠금 해제 시작 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_UNLOCK_START |0x6C00 |스케줄 개방 구역 시작 | |
- | |::: |BS2_EVENT_ZONE_FORCED_UNLOCK_END |0x6D00 |구역내 강제 잠금 해제 끝 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_UNLOCK_END |0x6D00 |스케줄 개방 구역 끝 | |
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_ALARM |0x6E00 |구역내 강제 잠금 경보 시작 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_ALARM |0x6E00 |스케줄 잠금 구역 경보 시작 | |
- | |::: |BS2_EVENT_ZONE_FORCED_LOCK_ALARM_CLEAR |0x6F00 |구역내 강제 잠금 경보 해제 | | + | |::: |BS2_EVENT_ZONE_SCHEDULED_LOCK_ALARM_CLEAR |0x6F00 |스케줄 잠금 구역 경보 해제 | |
줄 260: | 줄 283: | ||
|:::|BS2_TNA_KEY_15|0|15| | |:::|BS2_TNA_KEY_15|0|15| | ||
|:::|BS2_TNA_KEY_16|Esc|16| | |:::|BS2_TNA_KEY_16|Esc|16| | ||
+ | </WRAP> | ||
+ | \\ | ||
+ | **[+ 2.6.3] param의 추가기능** \\ | ||
+ | event code가 사용자와 관련된 경우에 한합니다. \\ | ||
+ | 장치에서 직접 사용자를 추가 또는 편집, 삭제하였다면 param은 1, BioStar를 통해 이루어졌다면 0입니다.\\ | ||
+ | 예를들어 BS2_EVENT_USER_ENROLL_SUCCESS와 함께 param이 1이었다면, 장치에서 직접 추가된 사용자를 나타냅니다.\\ | ||
+ | 이 기능은 아래의 펌웨어 버전 이후부터 지원합니다. | ||
+ | <WRAP group 60%> | ||
+ | ^장치 종류 ^지원 버전 ^ | ||
+ | |BioStation 2 |V1.7.0 | | ||
+ | |BioStation A2 |V1.6.0 | | ||
+ | |CoreStation 40 |V1.2.0 | | ||
+ | |BioEntry P2 |V1.2.0 | | ||
+ | |BioStation L2 |V1.4.0 | | ||
+ | |BioLite N2 |V1.1.0 | | ||
+ | |BioEntry W2 |V1.3.0 | | ||
+ | |FaceStation 2 |V1.2.0| | ||
</WRAP> | </WRAP> | ||
\\ \\ | \\ \\ | ||
줄 326: | 줄 366: | ||
로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
5. //cardID// \\ | 5. //cardID// \\ | ||
- | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | + | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ |
+ | 인증 실패의 경우에만 기록하며, 인증 성공의 경우에는 eventMask와 상관없이 user ID를 리턴합니다. \\ \\ | ||
6. //doorID// \\ | 6. //doorID// \\ | ||
로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
줄 400: | 줄 441: | ||
</WRAP> | </WRAP> | ||
4. //reserved// \\ | 4. //reserved// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | |||
+ | ==== BS2EventSmallBlob ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | uint16_t eventMask; | ||
+ | uint32_t id; | ||
+ | BS2EventExtInfo info; | ||
+ | union | ||
+ | { | ||
+ | BS2_USER_ID userID; // valid if eventMask has BS2_EVENT_MASK_USER_ID | ||
+ | uint8_t cardID[BS2_CARD_DATA_SIZE]; // valid if eventMask has BS2_EVENT_MASK_CARD_ID | ||
+ | BS2_DOOR_ID doorID; // valid if eventMask has BS2_EVENT_MASK_DOOR_ID | ||
+ | BS2_ZONE_ID zoneID; // valid if eventMask has BS2_EVENT_MASK_ZONE_ID | ||
+ | BS2EventExtIoDevice ioDevice; // valid if eventMask has BS2_EVENT_MASK_IODEVICE | ||
+ | }; | ||
+ | uint8_t tnaKey; | ||
+ | uint32_t jobCode; | ||
+ | uint16_t imageSize; | ||
+ | uint8_t* imageObj; // valid if eventMask has BS2_EVENT_MASK_IMAGE | ||
+ | uint8_t reserved; | ||
+ | } BS2EventSmallBlob; | ||
+ | </code> | ||
+ | \\ | ||
+ | |||
+ | 1. //eventMask// \\ | ||
+ | Event mask값입니다. mask값에 따라서 해당 ID(User, card, door, zone)값을 인식할 수 있습니다.\\ \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0x0000 |없음 | | ||
+ | |0x0001 |BS2EventExtInfo 구조체 | | ||
+ | |0x0002 |User ID | | ||
+ | |0x0004 |Card ID | | ||
+ | |0x0008 |Door ID | | ||
+ | |0x0010 |Zone ID | | ||
+ | |0x0020 |BS2EventExtIoDevice 구조체 | | ||
+ | |0x0040 |TNA Key | | ||
+ | |0x0080 |Job Code | | ||
+ | |0x0100 |Image | | ||
+ | |0x0200 |Temperature | | ||
+ | |0xFFFF |ALL | | ||
+ | </WRAP> | ||
+ | 2. //id// \\ | ||
+ | 로그 레코드의 식별자이며 로그가 발생될 때마다 1부터 자동으로 증가합니다. \\ \\ | ||
+ | 3. //info// \\ | ||
+ | BS2EventExtInfo 구조체 정보입니다. \\ \\ | ||
+ | 4. //userID// \\ | ||
+ | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 5. //cardID// \\ | ||
+ | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ | ||
+ | 인증 실패의 경우에만 기록하며, 인증 성공의 경우에는 eventMask와 상관없이 user ID를 리턴합니다. \\ \\ | ||
+ | 6. //doorID// \\ | ||
+ | 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 7. //zoneID// \\ | ||
+ | 로그와 관련된 zone 식별자로써 zone와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 8. //ioDevice// \\ | ||
+ | Door나 Input 장치의 식별자로 Door나 Input 장치와 관련 없는 로그일 경우 0으로 설정됩니다. (BS2EventExtIoDevice 구조체 참고)\\ \\ | ||
+ | 9. //tnaKey// \\ | ||
+ | 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다 \\ \\ | ||
+ | 10. //jobCode// \\ | ||
+ | 사용자 정보에 JobCode가 존재했을 경우에, JobCode 사용하여 인증 할 때 사용자의 JobCode 값을 말합니다. \\ \\ | ||
+ | 11. //imageSize// \\ | ||
+ | 이벤트 발생되었을 때 이미지 size를 말합니다. \\ \\ | ||
+ | 12. //imageObj// \\ | ||
+ | 이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다 \\ \\ | ||
+ | 13. //reserved// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | |||
+ | |||
+ | ==== BS2EventSmallBlobEx ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | uint16_t eventMask; | ||
+ | uint32_t id; | ||
+ | BS2EventExtInfo info; // valid if eventMask has BS2_EVENT_MASK_INFO | ||
+ | union | ||
+ | { | ||
+ | BS2_USER_ID userID; // valid if eventMask has BS2_EVENT_MASK_USER_ID | ||
+ | uint8_t cardID[BS2_CARD_DATA_SIZE]; // valid if eventMask has BS2_EVENT_MASK_CARD_ID | ||
+ | BS2_DOOR_ID doorID; // valid if eventMask has BS2_EVENT_MASK_DOOR_ID | ||
+ | BS2_ZONE_ID zoneID; // valid if eventMask has BS2_EVENT_MASK_ZONE_ID | ||
+ | BS2EventExtIoDevice ioDevice; // valid if eventMask has BS2_EVENT_MASK_IODEVICE | ||
+ | }; | ||
+ | uint8_t tnaKey; // valid if eventMask has BS2_EVENT_MASK_TNA_KEY | ||
+ | uint32_t jobCode; // valid if eventMask has BS2_EVENT_MASK_JOB_CODE | ||
+ | uint16_t imageSize; // valid if eventMask has BS2_EVENT_MASK_IMAGE | ||
+ | uint8_t* imageObj; // valid if eventMask has BS2_EVENT_MASK_IMAGE | ||
+ | uint8_t reserved; | ||
+ | uint32_t temperature; // valid if eventMask has BS2_EVENT_MASK_TEMPERATURE | ||
+ | } BS2EventSmallBlobEx; | ||
+ | </code> | ||
+ | \\ | ||
+ | |||
+ | 1. //eventMask// \\ | ||
+ | Event mask값입니다. mask값에 따라서 해당 ID(User, card, door, zone)값을 인식할 수 있습니다.\\ \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0x0000 |없음 | | ||
+ | |0x0001 |BS2EventExtInfo 구조체 | | ||
+ | |0x0002 |User ID | | ||
+ | |0x0004 |Card ID | | ||
+ | |0x0008 |Door ID | | ||
+ | |0x0010 |Zone ID | | ||
+ | |0x0020 |BS2EventExtIoDevice 구조체 | | ||
+ | |0x0040 |TNA Key | | ||
+ | |0x0080 |Job Code | | ||
+ | |0x0100 |Image | | ||
+ | |0x0200 |Temperature | | ||
+ | |0xFFFF |ALL | | ||
+ | </WRAP> | ||
+ | 2. //id// \\ | ||
+ | 로그 레코드의 식별자이며 로그가 발생될 때마다 1부터 자동으로 증가합니다. \\ \\ | ||
+ | 3. //info// \\ | ||
+ | BS2EventExtInfo 구조체 정보입니다. \\ \\ | ||
+ | 4. //userID// \\ | ||
+ | 로그와 관련된 사용자 식별자로써 사용자와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 5. //cardID// \\ | ||
+ | 로그와 관련된 card 식별자로써 card와 관련 없는 로그일 경우 0으로 설정됩니다. \\ | ||
+ | 인증 실패의 경우에만 기록하며, 인증 성공의 경우에는 eventMask와 상관없이 user ID를 리턴합니다. \\ \\ | ||
+ | 6. //doorID// \\ | ||
+ | 로그와 관련된 door 식별자로써 door와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 7. //zoneID// \\ | ||
+ | 로그와 관련된 zone 식별자로써 zone와 관련 없는 로그일 경우 0으로 설정됩니다. \\ \\ | ||
+ | 8. //ioDevice// \\ | ||
+ | Door나 Input 장치의 식별자로 Door나 Input 장치와 관련 없는 로그일 경우 0으로 설정됩니다. (BS2EventExtIoDevice 구조체 참고)\\ \\ | ||
+ | 9. //tnaKey// \\ | ||
+ | 이벤트 발생 장치의 추가 정보가 필요할 경우에만 사용되고, 주로 근태 코드나 출입문이나 입력 장치의 포트 번호가 저장됩니다 \\ \\ | ||
+ | 10. //jobCode// \\ | ||
+ | 사용자 정보에 JobCode가 존재했을 경우에, JobCode 사용하여 인증 할 때 사용자의 JobCode 값을 말합니다. \\ \\ | ||
+ | 11. //imageSize// \\ | ||
+ | 이벤트 발생되었을 때 이미지 size를 말합니다. \\ \\ | ||
+ | 12. //imageObj// \\ | ||
+ | 이벤트 발생되었을 때 이미지 정보가 포함될 경우에 사용됩니다 \\ \\ | ||
+ | 13. //temperature// \\ | ||
+ | 열화상 카메라가 설치되어 있으며, 로그를 남기도록 설정이 되어 있는경우 체온정보가 설정됩니다. [[configuration api#BS2FaceConfigExt|auditTemperature 참조]] \\ \\ | ||
+ | 14. //reserved// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ |