본문으로 건너뛰기

User Management API

사용자 등록 및 삭제할 수 있는 함수를 제공하는 API입니다.

📄️BS2_GetUserList

등록되어있는 사용자 식별자를 배열로 가져옵니다. 사용자 식별자의 크기는 BS2USERIDSIZE입니다.

📄️BS2_RemoveUser

주어진 사용자 식별자를 통해 사용자를 삭제합니다.

📄️BS2_RemoveAllUser

모든 사용자를 삭제합니다.

📄️BS2_GetUserInfos

사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetUserInfosEx

사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_EnrolUser

새로운 사용자를 등록합니다.

📄️BS2_EnrolUserEx

새로운 사용자를 등록합니다.

📄️BS2_EnrollUser

+ v2.6.3 새로운 사용자를 등록합니다.

📄️BS2_EnrollUserEx

+ v2.6.3 새로운 사용자를 등록합니다.

📄️BS2_GetUserDatas

+ v2.5.0 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetUserDatasEx

+ v2.5.0 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetSupportedUserMask

+ v2.5.0 주어진 장치에서 지원하는 사용자 설정 정보를 가져옵니다.

📄️BS2_EnrollUserSmall

+ v2.6.3 새로운 사용자를 등록합니다.

📄️BS2_EnrollUserSmallEx

+ v2.6.3 새로운 사용자를 등록합니다.

📄️BS2_GetUserSmallInfos

+ v2.6.3 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetUserSmallInfosEx

+ v2.6.3 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetUserSmallDatas

+ v2.6.3 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_GetUserSmallDatasEx

+ v2.6.3 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_EnrollUserFaceEx

+ v2.7.1 새로운 사용자를 등록합니다.

📄️BS2_GetUserInfosFaceEx

+ v2.7.1 주어진 사용자 ID의 정보를 가져옵니다.

📄️BS2_GetUserDatasFaceEx

+ v2.7.1 사용자 식별자에 해당하는 사용자 정보를 가져옵니다.

📄️BS2_PartialUpdateUser

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

📄️BS2_PartialUpdateUserEx

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

📄️BS2_PartialUpdateUserSmall

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

📄️BS2_PartialUpdateUserSmallEx

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

📄️BS2_PartialUpdateUserFaceEx

+ v2.8.3 이미 등록된 사용자의 부분 정보를 갱신합니다. 갱신하고자 하는 사용자는 이미 등록된 존재하는 사용자이어야 합니다.

📄️BS2_GetUserStatistic

+ v2.8.3 장치가 보유한 사용자 관련 통계 정보를 가져옵니다.

📄️BS2_GetUserOverride

+ v2.9.12 사용자 ID를 지정하여, 연장된 출입문 개방 시간을 사용하는 사용자 정보를 가져옵니다.

📄️BS2_GetAllUserOverride

+ v2.9.12 연장된 출입문 개방 시간을 사용하는 모든 사용자 정보를 가져옵니다.

📄️BS2_SetUserOverride

+ v2.9.12 연장된 출입문 개방 시간을 사용하는 사용자 정보를 설정합니다.

📄️BS2_RemoveUserOverride

+ v2.9.12 사용자ID를 지정하여, 연장된 출입문 개방 시간을 사용하는 사용자를 삭제합니다.

📄️BS2_RemoveAllUserOverride

+ v2.9.12 연장된 출입문 개방 시간을 사용하는 모든 사용자를 삭제합니다.

구조체

BS2User

typedef struct {
   char userID[BS2_USER_ID_SIZE];
   uint8_t formatVersion;
   uint8_t flag;
   uint16_t version;
   uint8_t numCards;
   uint8_t numFingers;
   uint8_t numFaces;
   uint8_t infoMask;
   uint32_t authGroupID;
   uint32_t faceChecksum;
} BS2User;

userID

사용자 식별자로 문자열 숫자이며, 1 ~ 4294967295의 범위를 가집니다.
formatVersion

사용되지 않음.
flag

사용자의 상태를 나타내는 flag값으로 OR 연산이 가능합니다. 마스크값은 아래와 같습니다.

값 설명
0x00 None
0x01 사용자가 생성됨
0x02 사용자가 갱신됨
0x04 사용자가 삭제됨
0x80 사용자가 비활성화됨
version

사용되지 않음.
numCards

사용자에게 맵핑된 카드 개수입니다.
numFingers

사용자에게 맵핑된 지문 개수입니다.
numFaces

사용자에게 맵핑된 얼굴 개수입니다.

infoMask

+ v2.8.3 사용자가 어떤 정보를 가지고 있는지 나타내며, 이 infoMask를 변경하여, 변경할 정보와 함께 장치로 내려주면 해당 사용자 정보의 부분 변경이 가능합니다.

이때, Partial update 함수군들 (BS2_PartialUpdateUser, BS2_PartialUpdateUserEx, BS2_PartialUpdateUserSmall, BS2_PartialUpdateUserSmallEx, BS2_PartialUpdateUserFaceEx)의 user mask 인자와의 조합이 필요합니다. (하단 표 참조)

값	설명
0x01	BS2_USER_INFO_MASK_PHRASE
0x02	BS2_USER_INFO_MASK_JOB_CODE
0x04	BS2_USER_INFO_MASK_NAME
0x08	BS2_USER_INFO_MASK_PHOTO
0x10	BS2_USER_INFO_MASK_PIN
0x20	BS2_USER_INFO_MASK_CARD
0x40	BS2_USER_INFO_MASK_FINGER
0x80	BS2_USER_INFO_MASK_FACE

사용자 정보의 취득

사용자 정보 취득 시, infoMask는 현재 사용자에 어떤 정보들이 할당되어 있는지를 나타냅니다.

사용자 정보	BS2_USER_MASK	infoMask
부분 삭제 시	unmasking	unmasking
부분 변경 시	masking	masking
장치설정 유지	unmasking	masking

사용자 정보의 부분 삭제

infoMask와, partial update 함수들 인자 user mask 모두에서, 삭제하고자 하는 정보를 unmasking 하여야 합니다.

사용자 정보의 부분 변경

infoMask와, partial update 함수들 인자 user mask 모두에서, 변경하고자 하는 정보를 masking 하여야 합니다.

사용자 정보의 장치설정 유지

infoMask는 masking 하고, partial update 함수들 인자 user mask는 unmasking 합니다.

Credential(카드/지문/얼굴) 정보의 변경

BS2User의 numCards, numFingers, numFaces가 0인지, 그리고 fingerObjs, cardObjs, faceObjs, faceExObjs에 credential 정보가 할당되어 있는지 여부를 우선 검토하고, 부가적으로 infoMask를 검토합니다.

카드/지문/얼굴 정보를 0보다 큰 값으로 지정하고, infoMask에 mask를 설정하면 장치의 credential 정보를 변경 할 수 있습니다.

예를들어, 장치에 대상이 되는 사용자의 지문이 2개가 있는 상태에서, infoMask에 BS2_USER_INFO_MASK_FINGER를 masking하고, numFingers = 1, fingerObjs에 지문을 할당하여 내려준다면, 장치는 새로 내린 1개 지문 만을 갖습니다.

만일 지문의 추가가 목적이라면, 기존 2개의 지문에 새롭게 추가할 지문 1개가 더해진, 총 3개의 지문이 내려져야만 합니다.

Credential(카드/지문/얼굴) 정보의 유지

카드/지문/얼굴 각각의 credential 정보를 0으로 하고, infoMask를 masking 하면, 장치는 기존에 가지고 있는 credential 정보들을 유지합니다.

Credential(카드/지문/얼굴) 정보의 삭제

카드/지문/얼굴 각각의 credential 정보를 0으로 하고, infoMask를 unmasking 하면, 장치는 각각 credential에 해당되는 정보를 삭제합니다.

authGroupID

얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID.
faceChecksum

사용되지 않음.

BS2UserSetting

알아두기

Visual Face 기반 장치들의 개인 인증 모드 설정은 BS2UserSettingEx를 사용해 주십시오.

typedef struct {
   uint32_t startTime;
   uint32_t endTime;
   uint8_t fingerAuthMode;
   uint8_t cardAuthMode;
   uint8_t idAuthMode;
   uint8_t securityLevel;
} BS2UserSetting;

startTime

사용자 인증이 가능한 시작 시간을 의미합니다.

978307200 (2001-01-01 00:00:00)보다 큰 값을 입력하여야 하며, 0으로 설정 시 제한 없음을 의미합니다.
endTime

사용자 인증이 가능한 마지막 시간을 의미합니다.

1924991999 (2030-12-31 23:59:59)보다 작은 값으로 입력하여야 하며, 0으로 설정 시 제한 없음을 의미합니다.

날짜 확장이 포함된 펌웨어 버전 혹은 이상의 경우, 2037년까지 저장할 수 있습니다.

장치별 펌웨어 릴리즈 노트를 참고하여 날짜 확장 기능 포함 여부를 확인하시기 바랍니다.

예를들어, BioStation 3의 경우, 1.3.0 버전 이상부터 2037년 12월 31일까지 설정할 수 있습니다.
fingerAuthMode

사용자 인증을 위한 지문 인증 설정 모드입니다.

값 설명
0 지문 인증만 사용
1 지문과 PIN 인증 사용
254 사용할 수 없음
255 정의되지 않음(시스템에 정의된 모드로 동작)

cardAuthMode

사용자 인증을 위한 카드 인증 설정 모드입니다.

값	설명
2	카드 인증만 사용
3	카드와 지문 인증 사용
4	카드와 PIN 인증 사용
5	카드 인증 후 지문이나 PIN 인증 사용
6	카드, 지문, PIN 인증 사용
254	사용할 수 없음
255	정의되지 않음(시스템에 정의된 모드로 동작)

idAuthMode

사용자 인증을 위한 ID 인증 설정 모드입니다.

값	설명
7	사용자 ID 입력 후 지문 인증 사용
8	사용자 ID 입력 후 PIN 인증 사용
9	사용자 ID 입력 후 지문이나 PIN 인증 사용
10	사용자 ID 입력 후 지문과 PIN 인증 사용
254	사용할 수 없음
255	정의되지 않음(시스템에 정의된 모드로 동작)

securityLevel

지문 인증이나 얼굴 인식을 위해 필요한 보안 수준입니다.

값 설명
0 시스템에 정의된 기본 값
1 최고 낮은 보안 수준
2 낮은 보안 수준
3 기본 보안 수준
4 높은 보안 수준
5 최고 높은 보안 수준

BS2UserPhoto

typedef struct {
   uint32_t size;
   uint8_t data[BS2_USER_PHOTO_SIZE];
} BS2UserPhoto;

size

사용자 프로파일 이미지 데이터의 크기입니다.
data

프로파일 이미지의 데이터이며, 최대 16kb까지 저장할 수 있습니다.

BS2UserBlob

typedef struct {
   BS2User user;
   BS2UserSetting setting;
   uint8_t name[BS2_USER_NAME_SIZE];
   BS2UserPhoto photo;
   uint8_t pin[BS2_PIN_HASH_SIZE];
   BS2CSNCard* cardObjs;
   BS2Fingerprint* fingerObjs;
   BS2Face* faceObjs;    
   uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserBlob;

user

사용자의 기본 정보를 정의한 구조체입니다.
setting

사용자 식별을 위한 설정값을 정의한 구조체입니다.
name

사용자 이름이며 문자열 인코딩은 UTF-8입니다.
photo

사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다.
pin

PIN 값이며 반드시 BS_MakePinCode 함수를 통해 암호화된 문자열을 입력해야 합니다.
cardObjs

사용자 인증을 위한 카드 리스트로 반드시 user.numCards만큼 존재해야 합니다. 데이터 형식은 Smartcard API를 참고하세요.
fingerObjs

사용자 인증을 위한 지문 템플릿 리스트로 반드시 user.numFingers만큼 존재해야 합니다. 데이터 형식은 Fingerprint API를 참고하세요.
faceObjs

사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.
accessGroupId

사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다.

BS2Job

typedef struct {
   uint8_t numJobs;                     
   uint8_t reserved[3];                 

   struct {
      BS2_JOB_CODE code;                 
      BS2_JOB_LABEL label;               
   } jobs[BS2_MAX_JOB_SIZE];
} BS2Job;

numJobs

사용자에 매핑된 Job 개수입니다.
reserved

예약된 공간입니다.
jobs

T&A에 사용자 Job 리스트입니다.

BS2UserBlobEx

typedef struct {
   BS2User user;
   BS2UserSetting setting;
   uint8_t name[BS2_USER_NAME_SIZE];
   BS2UserPhoto photo;
   uint8_t pin[BS2_PIN_HASH_SIZE];
   BS2CSNCard* cardObjs;
   BS2Fingerprint* fingerObjs;
   BS2Face* faceObjs;
   BS2Job job;
   BS2_USER_PHRASE phrase;
   uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserBlobEx;

user

사용자의 기본 정보를 정의한 구조체입니다.
setting

사용자 식별을 위한 설정값을 정의한 구조체입니다.
name

사용자 이름이며 문자열 인코딩은 UTF-8입니다.
photo

사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다.
pin

PIN 값이며 반드시 BS_MakePinCode 함수를 통해 암호화된 문자열을 입력해야 합니다.
cardObjs

사용자 인증을 위한 카드 리스트로 반드시 user.numCards만큼 존재해야 합니다. 데이터 형식은 Smartcard API를 참고하세요.
fingerObjs

사용자 인증을 위한 지문 템플릿 리스트로 반드시 user.numFingers만큼 존재해야 합니다. 데이터 형식은 Fingerprint API를 참고하세요.
faceObjs

사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.
job

근태 모드에서 사용자의 작업코드입니다.
phrase

인증시 장치 UI에서 표시되는 개인 메시지입니다.

지원 모델 지원 버전
FaceStation 2 V1.0.0 이상
FaceStation F2 V1.0.0 이상
X-Station 2 V1.0.0 이상
accessGroupId

사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다.

BS2UserSmallBlob

typedef struct {
   BS2User user;
   BS2UserSetting setting;
   uint8_t name[BS2_USER_NAME_SIZE];
   BS2UserPhoto* photo;
   uint8_t pin[BS2_PIN_HASH_SIZE];
   BS2CSNCard* cardObjs;
   BS2Fingerprint* fingerObjs;
   BS2Face* faceObjs;    
   uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserSmallBlob;

user

사용자의 기본 정보를 정의한 구조체입니다.
setting

사용자 식별을 위한 설정값을 정의한 구조체입니다.
name

사용자 이름이며 문자열 인코딩은 UTF-8입니다.
photo

사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다.
pin

PIN 값이며 반드시 BS_MakePinCode 함수를 통해 암호화된 문자열을 입력해야 합니다.
cardObjs

사용자 인증을 위한 카드 리스트로 반드시 user.numCards만큼 존재해야 합니다. 데이터 형식은 Smartcard API를 참고하세요.
fingerObjs

사용자 인증을 위한 지문 템플릿 리스트로 반드시 user.numFingers만큼 존재해야 합니다. 데이터 형식은 Fingerprint API를 참고하세요.
faceObjs

사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.
accessGroupId

사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다.

BS2UserSmallBlobEx

typedef struct {
   BS2User user;
   BS2UserSetting setting;
   uint8_t name[BS2_USER_NAME_SIZE];
   BS2UserPhoto* photo;
   uint8_t pin[BS2_PIN_HASH_SIZE];
   BS2CSNCard* cardObjs;
   BS2Fingerprint* fingerObjs;
   BS2Face* faceObjs;
   BS2Job job;
   BS2_USER_PHRASE phrase;
   uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserSmallBlobEx;

user

사용자의 기본 정보를 정의한 구조체입니다.
setting

사용자 식별을 위한 설정값을 정의한 구조체입니다.
name

사용자 이름이며 문자열 인코딩은 UTF-8입니다.
photo

사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다.
pin

PIN 값이며 반드시 BS_MakePinCode 함수를 통해 암호화된 문자열을 입력해야 합니다.
cardObjs

사용자 인증을 위한 카드 리스트로 반드시 user.numCards만큼 존재해야 합니다. 데이터 형식은 Smartcard API를 참고하세요.
fingerObjs

사용자 인증을 위한 지문 템플릿 리스트로 반드시 user.numFingers만큼 존재해야 합니다. 데이터 형식은 Fingerprint API를 참고하세요.
faceObjs

사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.
job

근태 모드에서 사용자의 작업코드입니다.
phrase

인증시 장치 UI에서 표시되는 개인 메시지입니다.

지원 모델 지원 버전
FaceStation 2 V1.0.0 이상
FaceStation F2 V1.0.0 이상
X-Station 2 V1.0.0 이상
BioStation 3 V1.0.0 이상
accessGroupId

사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다.

BS2UserSettingEx

알아두기

Visual Face 기반 장치 외 장치에 대한 개인 인증 모드 설정은 BS2UserSetting를 사용해 주십시오.

typedef struct {
   uint8_t faceAuthMode;
   uint8_t fingerprintAuthMode;
   uint8_t cardAuthMode;
   uint8_t idAuthMode;
   uint8_t reserved[28];
} BS2UserSettingEx;

faceAuthMode

사용자 인증을 위한 얼굴 인증 설정 모드입니다.

값	1단계 인증	2단계 인증	3단계 인증	4단계 인증
11	얼굴
12	얼굴	지문
13	얼굴	PIN
14	얼굴	지문 또는 PIN
15	얼굴	지문	PIN
254	사용할 수 없음
255	정의되지 않음(시스템 정의 모드)

fingerprintAuthMode

사용자 인증을 위한 지문 인증 설정 모드입니다.

값	1단계 인증	2단계 인증	3단계 인증	4단계 인증
16	지문
17	지문	얼굴
18	지문	PIN
19	지문	얼굴 또는 PIN
20	지문	얼굴	PIN
254	사용할 수 없음
255	정의되지 않음(시스템 정의 모드)

cardAuthMode

사용자 인증을 위한 카드 인증 설정 모드입니다.

값	1단계 인증	2단계 인증	3단계 인증
21	카드
22	카드	얼굴
23	카드	지문
24	카드	PIN
25	카드	얼굴 또는 지문
26	카드	얼굴 또는 PIN
27	카드	지문 또는 PIN
28	카드	얼굴 또는 지문 또는 PIN
29	카드	얼굴	지문
30	카드	얼굴	PIN
31	카드	지문	얼굴
32	카드	지문	PIN
33	카드	얼굴 또는 지문	PIN
34	카드	얼굴	지문 또는 PIN
35	카드	지문	얼굴 또는 PIN
254	사용할 수 없음
255	정의되지 않음(시스템 정의 모드)

idAuthMode

사용자 인증을 위한 ID 인증 설정 모드입니다.

값	1단계 인증	2단계 인증	3단계 인증
36	ID	얼굴
37	ID	지문
38	ID	PIN
39	ID	얼굴 또는 지문
40	ID	얼굴 또는 PIN
41	ID	지문 또는 PIN
42	ID	얼굴 또는 지문 또는 PIN
43	ID	얼굴	지문
44	ID	얼굴	PIN
45	ID	지문	얼굴
46	ID	지문	PIN
47	ID	얼굴 또는 지문	PIN
48	ID	얼굴	지문 또는 PIN
49	ID	지문	얼굴 또는 PIN
254	사용할 수 없음
255	정의되지 않음(시스템 정의 모드)

reserved

예약된 공간입니다.

BS2UserFaceExBlob

typedef struct
{
   BS2User user;
   BS2UserSetting setting;
   BS2_USER_NAME user_name;
   BS2UserPhoto* user_photo_obj;
   BS2_USER_PIN pin;
   BS2CSNCard* cardObjs;
   BS2Fingerprint* fingerObjs;
   BS2Face* faceObjs;                  // FS2, FL
   BS2Job job;
   BS2_USER_PHRASE phrase;
   BS2_ACCESS_GROUP_ID accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];

   BS2UserSettingEx settingEx;         // F2
   BS2FaceEx* faceExObjs;              // F2
} BS2UserFaceExBlob;

user

사용자의 기본 정보를 정의한 구조체입니다.
setting

사용자 식별을 위한 설정값을 정의한 구조체입니다.
name

사용자 이름이며 문자열 인코딩은 UTF-8입니다.
photo

사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다.
pin

PIN 값이며 반드시 BS_MakePinCode 함수를 통해 암호화된 문자열을 입력해야 합니다.
cardObjs

사용자 인증을 위한 카드 리스트로 반드시 user.numCards만큼 존재해야 합니다. 데이터 형식은 Smartcard API를 참고하세요.
fingerObjs

사용자 인증을 위한 지문 템플릿 리스트로 반드시 user.numFingers만큼 존재해야 합니다. 데이터 형식은 Fingerprint API를 참고하세요.
faceObjs

IR Face 지원 장치 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.
job

근태 모드에서 사용자의 작업코드입니다.
phrase

인증시 장치 UI에서 표시되는 개인 메시지입니다.

지원 모델 지원 버전
FaceStation 2 V1.0.0 이상
FaceStation F2 V1.0.0 이상
X-Station 2 V1.0.0 이상
accessGroupId

사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다.
settingEx

Visual Face 지원 장치 개인 인증 모드를 설정할 수 있습니다. 지문과 얼굴을 함께 조합한 더 다양한 인증모드의 조합이 가능하게 되었습니다.
faceExObjs

Visual Face 지원 장치 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 user.numFaces만큼 존재해야 합니다. 데이터 형식은 Face API를 참고하세요.

BS2UserStatistic

typedef struct {
   uint32_t numUsers;
   uint32_t numCards;
   uint32_t numFingerprints;
   uint32_t numFaces;
   uint32_t numNames;
   uint32_t numImages;
   uint32_t numPhrases;
} BS2UserStatistic;

numUsers

등록된 사용자 수입니다.
numCards

등록된 카드의 개수입니다.
numFingerprints

등록된 지문의 개수입니다.
numFaces

등록된 얼굴의 개수입니다.
numNames

등록된 사용자명의 개수입니다.
numImages

등록된 이미지 개수입니다.
numPhrases

등록된 개인메시지 개수입니다.

BS2UserOverride

typedef struct{
   BS2_USER_ID userID;             ///< 32 bytes
   BS2_BOOL useExtendedAutoLockTimeout;    ///<  1 byte
   uint8_t reserved[11];           ///<div 11 bytes
} BS2UserOverride;

userID

사용자의 ID입니다.
useExtendedAutoLockTimeout

사용자가 연장된 출입문 개방 시간 기능(user override)을 사용할지 여부를 나타냅니다.
reserved

예약된 공간입니다.