차이

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

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판 		이전 판
다음 판 양쪽 다음 판
ko:user_management_api [2020/08/20 16:54]
kkshin [BS2UserSettingEx] 		ko:user_management_api [2022/04/11 11:17]
127.0.0.1 바깥 편집
줄 8: 줄 8:
   * [[BS2_RemoveAllUser]]:​ 모든 사용자를 삭제합니다.   * [[BS2_RemoveAllUser]]:​ 모든 사용자를 삭제합니다.
   * [[BS2_GetUserInfos]]:​ 주어진 사용자 ID의 정보를 가져옵니다.   * [[BS2_GetUserInfos]]:​ 주어진 사용자 ID의 정보를 가져옵니다.
-  * [[BS2_GetUserInfosEx]]:​ 주어진 사용자 ID의 정보를 가져옵니다. ([+ 2.4.0] ​Job code, User phrase 포함)+  * [[BS2_GetUserInfosEx]]: ​[+ 2.4.0] ​주어진 사용자 ID의 정보를 가져옵니다. (Job code, User phrase 포함)
   * [[BS2_EnrolUser]]:​ 새로운 사용자를 등록합니다.   * [[BS2_EnrolUser]]:​ 새로운 사용자를 등록합니다.
-  * [[BS2_EnrolUserEx]]:​ 새로운 사용자를 등록합니다.([+ 2.4.0] ​Job code, User phrase 포함)+  * [[BS2_EnrolUserEx]]: ​[+ 2.4.0] ​새로운 사용자를 등록합니다.(Job code, User phrase 포함)
   * [[BS2_EnrollUser]]:​ [+ 2.6.3] 새로운 사용자를 등록합니다.   * [[BS2_EnrollUser]]:​ [+ 2.6.3] 새로운 사용자를 등록합니다.
   * [[BS2_EnrollUserEx]]:​ [+ 2.6.3] 새로운 사용자를 등록합니다.(Job code, User phrase 포함)   * [[BS2_EnrollUserEx]]:​ [+ 2.6.3] 새로운 사용자를 등록합니다.(Job code, User phrase 포함)
   * [[BS2_GetUserDatas]]:​ 사용자 정보의 일부를 선별적으로 가져옵니다.   * [[BS2_GetUserDatas]]:​ 사용자 정보의 일부를 선별적으로 가져옵니다.
-  * [[BS2_GetUserDatasEx]]:​ 사용자 정보의 일부를 선별적으로 가져옵니다.([+ 2.5.0] ​Job code, User phrase 포함)+  * [[BS2_GetUserDatasEx]]: ​[+ 2.5.0] ​사용자 정보의 일부를 선별적으로 가져옵니다.(Job code, User phrase 포함)
   * [[BS2_GetSupportedUserMask]]:​ 장치에서 지원하는 사용자 설정을 가져옵니다.   * [[BS2_GetSupportedUserMask]]:​ 장치에서 지원하는 사용자 설정을 가져옵니다.
   * [[BS2_EnrollUserSmall]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 새로운 사용자를 등록합니다.   * [[BS2_EnrollUserSmall]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 새로운 사용자를 등록합니다.
줄 22: 줄 22:
   * [[BS2_GetUserSmallDatas]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 사용자 정보의 일부를 선별적으로 가져옵니다.   * [[BS2_GetUserSmallDatas]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 사용자 정보의 일부를 선별적으로 가져옵니다.
   * [[BS2_GetUserSmallDatasEx]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 사용자 정보의 일부를 선별적으로 가져옵니다.   * [[BS2_GetUserSmallDatasEx]]:​ [+ 2.6.3] 효율적으로 메모리를 사용하여,​ 사용자 정보의 일부를 선별적으로 가져옵니다.
 +  * [[BS2_EnrollUserFaceEx]]:​ [+ 2.7.1] ''​FaceStation F2''​새로운 사용자를 등록합니다.
 +  * [[BS2_GetUserInfosFaceEx]]:​ [+ 2.7.1] ''​FaceStation F2''​주어진 사용자 ID의 정보를 가져옵니다.
 +  * [[BS2_GetUserDatasFaceEx]]:​ [+ 2.7.1] ''​FaceStation F2''​사용자 정보의 일부를 선별적으로 가져옵니다.
  
 ===== 구조체 ===== ===== 구조체 =====
줄 70: 줄 73:
 \\ \\
 ==== BS2UserSetting ==== ==== BS2UserSetting ====
 +<WRAP tip 70%> 
 +**도움말**\\ 
 +<wrap em>​FaceStation F2 이외</​wrap>​ \\ 
 +<wrap em>​FaceStation F2</​wrap>​는 [[user management api#​BS2UserSettingEx|BS2UserSettingEx]]를 사용해 주십시오. 
 +</​WRAP>​
 <code cpp> <code cpp>
 typedef struct { typedef struct {
줄 82: 줄 89:
 </​code>​ </​code>​
 1. //​startTime//​ \\  1. //​startTime//​ \\ 
-사용자 인증이 가능한 시작 시간으로 ​0일 경우 ​제한이 없습니다. \\ \\ +사용자 인증이 가능한 시작 시간을 의미합니다. \\ 
 +<wrap em>​978307200 (2001-01-01 00:00:00) 보다 큰 값</​wrap>​을 입력하여야 하며, <wrap em>0으로 ​설정 시 제한 없음</​wrap>​을 의미합니다. \\ \\ 
 2. //endTime// \\  2. //endTime// \\ 
-사용자 인증이 가능한 마지막 시간으로 0일 경우 ​제한이 없습니다. \\ \\ +사용자 인증이 가능한 마지막 시간을 의미합니다. \\ 
 +<wrap em>​1924991999 (2030-12-31 23:59:59) 보다 작은 값</​wrap>​으로 ​입력하여야 하며, <wrap em>0으로 설정 시 제한 없음</​wrap>​을 의미합니다. \\ \\ 
 3. //​fingerAuthMode//​ \\  3. //​fingerAuthMode//​ \\ 
 사용자 인증을 위한 지문 인증 설정 모드입니다. \\  사용자 인증을 위한 지문 인증 설정 모드입니다. \\ 
줄 230: 줄 239:
 근태모드에서 사용자의 작업코드입니다. \\ \\  근태모드에서 사용자의 작업코드입니다. \\ \\ 
 10. //phrase// \\  10. //phrase// \\ 
-인증시 장치 UI에서 표시되는 개인 메시지입니다. ​(FS2 FW 1.0.0 이상에서만 가능) \\+인증시 장치 UI에서 표시되는 개인 메시지입니다. ​\\ 
 +<WRAP group 30%> 
 +^지원 모델 ​ ^지원 버전 ​ ^ 
 +|FaceStation 2  |V1.0.0 이상 ​ | 
 +|FaceStation F2  |V1.0.0 이상 ​ | 
 +|X-Station 2  |V1.0.0 이상 ​ | 
 +</​WRAP>​
 11. //​accessGroupId//​ \\  11. //​accessGroupId//​ \\ 
 사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\  사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 
줄 303: 줄 318:
 근태모드에서 사용자의 작업코드입니다. \\ \\  근태모드에서 사용자의 작업코드입니다. \\ \\ 
 10. //phrase// \\  10. //phrase// \\ 
-인증시 장치 UI에서 표시되는 개인 메시지입니다. ​(FS2 FW 1.0.0 이상 ​버전에서만 가능)\\ \\+인증시 장치 UI에서 표시되는 개인 메시지입니다. ​\\ 
 +<WRAP group 30%> 
 +^지원 모델 ​ ^지원 버전 ​ ^ 
 +|FaceStation 2  |V1.0.0 이상 ​ | 
 +|FaceStation F2  |V1.0.0 이상 ​ | 
 +|X-Station 2  |V1.0.0 이상 ​ | 
 +</​WRAP>​
 11. //​accessGroupId//​ \\  11. //​accessGroupId//​ \\ 
 사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\  사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 
줄 309: 줄 330:
  
 ==== BS2UserSettingEx ==== ==== BS2UserSettingEx ====
 +<WRAP tip 70%>
 +**도움말**\\
 +<wrap em>​FaceStation F2 만</​wrap> ​ \\
 +FaceStation F2 <wrap em>​이외의 장치</​wrap>​는 [[user management api#​BS2UserSetting|BS2UserSetting]]를 사용해 주십시오.
 +</​WRAP>​
 <code cpp> <code cpp>
 typedef struct { typedef struct {
줄 321: 줄 347:
 1. //​faceAuthMode//​ \\  1. //​faceAuthMode//​ \\ 
 사용자 인증을 위한 얼굴 인증 설정 모드입니다. \\ 사용자 인증을 위한 얼굴 인증 설정 모드입니다. \\
-<WRAP group 50%>+<WRAP group 60%>
 ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^4단계 인증 ​ ^ ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^4단계 인증 ​ ^
 |11 |얼굴 ​ |      |  | |11 |얼굴 ​ |      |  |
줄 333: 줄 359:
 2. //​fingerprintAuthMode//​ \\  2. //​fingerprintAuthMode//​ \\ 
 사용자 인증을 위한 지문 인증 설정 모드입니다. \\  사용자 인증을 위한 지문 인증 설정 모드입니다. \\ 
-<WRAP group 50%>+<WRAP group 60%>
 ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^4단계 인증 ​ ^ ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^4단계 인증 ​ ^
 |16 |지문 ​ |      |  | |16 |지문 ​ |      |  |
줄 345: 줄 371:
 3. //​cardAuthMode//​ \\  3. //​cardAuthMode//​ \\ 
 사용자 인증을 위한 카드 인증 설정 모드입니다. \\  사용자 인증을 위한 카드 인증 설정 모드입니다. \\ 
-<WRAP group 50%>+<WRAP group 60%>
 ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^ ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^
 |21  |카드 ​ |      |   | |21  |카드 ​ |      |   |
줄 367: 줄 393:
 4. //​idAuthMode//​ \\  4. //​idAuthMode//​ \\ 
 사용자 인증을 위한 ID 인증 설정 모드입니다. \\  사용자 인증을 위한 ID 인증 설정 모드입니다. \\ 
-<WRAP group 50%>+<WRAP group 60%>
 ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^ ^값  ^1단계 인증 ​ ^2단계 인증 ​ ^3단계 인증 ​ ^
 |36  |ID  |얼굴 ​ |   | |36  |ID  |얼굴 ​ |   |
줄 388: 줄 414:
 5. //​reserved//​ \\  5. //​reserved//​ \\ 
 예약된 공간입니다. \\ \\  예약된 공간입니다. \\ \\ 
 +
 +
 +==== BS2UserFaceExBlob ====
 +<code cpp>
 +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;​
 +</​code>​
 +1. //user// \\ 
 +사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
 +2. //setting// \\ 
 +사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
 +3. //name// \\ 
 +사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
 +4. //photo// \\ 
 +사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
 +5. //pin// \\ 
 +PIN 값이며 반드시 //​BS_MakePinCode//​ 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
 +6. //​cardObjs//​ \\ 
 +사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
 +7. //​fingerObjs//​ \\ 
 +사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
 +8. //​faceObjs//​ \\ 
 +''​FaceStation2'',​ ''​FaceLite''​ 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
 +9. //job// \\ 
 +근태모드에서 사용자의 작업코드입니다. \\ \\ 
 +10. //phrase// \\ 
 +인증시 장치 UI에서 표시되는 개인 메시지입니다. \\
 +<WRAP group 30%>
 +^지원 모델 ​ ^지원 버전 ​ ^
 +|FaceStation 2  |V1.0.0 이상 ​ |
 +|FaceStation F2  |V1.0.0 이상 ​ |
 +|X-Station 2  |V1.0.0 이상 ​ |
 +</​WRAP>​
 +11. //​accessGroupId//​ \\ 
 +사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 
 +12. //​settingEx//​ \\ 
 +''​FaceStation F2''​ 개인인증모드를 설정할 수 있습니다. 지문과 얼굴을 함께 조합한 더 다양한 인증모드의 조합이 가능하게 되었습니다. \\ \\ 
 +13. //​faceExObjs//​ \\ 
 +''​FaceStation F2''​ 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\
 +