LargePersonGroupPerson class
LargePersonGroupPerson을 나타내는 클래스입니다.
생성자
| Large |
LargePersonGroupPerson을 만듭니다. |
메서드
생성자 세부 정보
LargePersonGroupPerson(FaceClientContext)
LargePersonGroupPerson을 만듭니다.
new LargePersonGroupPerson(client: FaceClientContext)매개 변수
- client
- FaceClientContext
서비스 클라이언트에 대한 참조입니다.
메서드 세부 정보
addFaceFromStream(string, string, HttpRequestBody, LargePersonGroupPersonAddFaceFromStreamOptionalParams)
얼굴 식별 또는 확인을 위해 큰 사람 그룹에 얼굴을 추가합니다. 여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete 또는 LargePersonGroup -Delete 가 호출될 때까지 서버에 저장됩니다.
참고 persistedFaceId는 Face - Detect에서 생성된 faceId와 다릅니다.
- 얼굴 이미지 품질이 높을수록 인식 정밀도를 높일 수 있습니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- 각 사람 항목은 최대 248개의 얼굴을 보유할 수 있습니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- "targetFace" 사각형에는 하나의 얼굴이 포함되어야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face - Detect에서 반환되지 않으면 얼굴을 감지하고 성공적으로 추가해야 합니다.
- 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
- 동일한 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다. 다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
function addFaceFromStream(largePersonGroupId: string, personId: string, image: HttpRequestBody, options?: LargePersonGroupPersonAddFaceFromStreamOptionalParams): Promise<LargePersonGroupPersonAddFaceFromStreamResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
반환
Promise<Models.LargePersonGroupPersonAddFaceFromStreamResponse>
addFaceFromStream(string, string, HttpRequestBody, LargePersonGroupPersonAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromStream(largePersonGroupId: string, personId: string, image: HttpRequestBody, options: LargePersonGroupPersonAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
- callback
콜백
addFaceFromStream(string, string, HttpRequestBody, ServiceCallback<PersistedFace>)
function addFaceFromStream(largePersonGroupId: string, personId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
- callback
콜백
addFaceFromUrl(string, string, string, LargePersonGroupPersonAddFaceFromUrlOptionalParams)
얼굴 식별 또는 확인을 위해 큰 사람 그룹에 얼굴을 추가합니다. 여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete 또는 LargePersonGroup -Delete 가 호출될 때까지 서버에 저장됩니다.
참고 persistedFaceId는 Face - Detect에서 생성된 faceId와 다릅니다.
- 얼굴 이미지 품질이 높을수록 인식 정밀도를 높일 수 있습니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- 각 사람 항목은 최대 248개의 얼굴을 보유할 수 있습니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- "targetFace" 사각형에는 하나의 얼굴이 포함되어야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face - Detect에서 반환되지 않으면 얼굴을 감지하고 성공적으로 추가해야 합니다.
- 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
- 동일한 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다. 다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
function addFaceFromUrl(largePersonGroupId: string, personId: string, url: string, options?: LargePersonGroupPersonAddFaceFromUrlOptionalParams): Promise<LargePersonGroupPersonAddFaceFromUrlResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
선택적 매개 변수
반환
Promise<Models.LargePersonGroupPersonAddFaceFromUrlResponse>
addFaceFromUrl(string, string, string, LargePersonGroupPersonAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromUrl(largePersonGroupId: string, personId: string, url: string, options: LargePersonGroupPersonAddFaceFromUrlOptionalParams, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
선택적 매개 변수
- callback
콜백
addFaceFromUrl(string, string, string, ServiceCallback<PersistedFace>)
function addFaceFromUrl(largePersonGroupId: string, personId: string, url: string, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
- callback
콜백
create(string, LargePersonGroupPersonCreateOptionalParams)
지정된 대규모 사람 그룹에 새 사람을 추가합니다.
function create(largePersonGroupId: string, options?: LargePersonGroupPersonCreateOptionalParams): Promise<LargePersonGroupPersonCreateResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
선택적 매개 변수
반환
Promise<LargePersonGroupPersonCreateResponse>
Promise<Models.LargePersonGroupPersonCreateResponse>
create(string, LargePersonGroupPersonCreateOptionalParams, ServiceCallback<Person>)
function create(largePersonGroupId: string, options: LargePersonGroupPersonCreateOptionalParams, callback: ServiceCallback<Person>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
선택적 매개 변수
- callback
콜백
create(string, ServiceCallback<Person>)
function create(largePersonGroupId: string, callback: ServiceCallback<Person>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- callback
콜백
deleteFace(string, string, string, RequestOptionsBase)
지정된 largePersonGroupId, personId 및 persistedFaceId를 사용하여 큰 사람 그룹의 사람에서 얼굴을 삭제합니다.
동일한 사람에게 얼굴을 추가/삭제하면 순차적으로 처리됩니다.
다른 사람에게 얼굴을 추가/삭제하는 작업은 병렬로 처리됩니다.
function deleteFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteFace(string, string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
deleteFace(string, string, string, ServiceCallback<void>)
function deleteFace(largePersonGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, string, RequestOptionsBase)
대규모 사람 그룹에서 기존 사람을 삭제합니다. 개인 항목의 persistedFaceId, userData, person name 및 face 기능이 모두 삭제됩니다.
function deleteMethod(largePersonGroupId: string, personId: string, options?: RequestOptionsBase): Promise<RestResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(largePersonGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, string, ServiceCallback<void>)
function deleteMethod(largePersonGroupId: string, personId: string, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
get(string, string, RequestOptionsBase)
사용자의 이름과 userData 및 등록된 사용자 얼굴 기능을 나타내는 지속형 faceId를 검색합니다.
function get(largePersonGroupId: string, personId: string, options?: RequestOptionsBase): Promise<LargePersonGroupPersonGetResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<LargePersonGroupPersonGetResponse>
Promise<Models.LargePersonGroupPersonGetResponse>
get(string, string, RequestOptionsBase, ServiceCallback<Person>)
function get(largePersonGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<Person>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
콜백
get(string, string, ServiceCallback<Person>)
function get(largePersonGroupId: string, personId: string, callback: ServiceCallback<Person>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- callback
콜백
getFace(string, string, string, RequestOptionsBase)
지속형 얼굴(persistedFaceId, personId 및 해당 속한 largePersonGroupId로 지정됨)에 대한 정보를 검색합니다.
function getFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<LargePersonGroupPersonGetFaceResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<Models.LargePersonGroupPersonGetFaceResponse>
getFace(string, string, string, RequestOptionsBase, ServiceCallback<PersistedFace>)
function getFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
콜백
getFace(string, string, string, ServiceCallback<PersistedFace>)
function getFace(largePersonGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<PersistedFace>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- callback
콜백
list(string, LargePersonGroupPersonListOptionalParams)
큰 사람 그룹의 모든 사람을 나열하고 사람 정보(등록된 얼굴의 personId, name, userData 및 persistedFaceIds 포함)를 검색합니다.
function list(largePersonGroupId: string, options?: LargePersonGroupPersonListOptionalParams): Promise<LargePersonGroupPersonListResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
선택적 매개 변수
반환
Promise<LargePersonGroupPersonListResponse>
Promise<Models.LargePersonGroupPersonListResponse>
list(string, LargePersonGroupPersonListOptionalParams, ServiceCallback<Person[]>)
function list(largePersonGroupId: string, options: LargePersonGroupPersonListOptionalParams, callback: ServiceCallback<Person[]>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
선택적 매개 변수
- callback
콜백
list(string, ServiceCallback<Person[]>)
function list(largePersonGroupId: string, callback: ServiceCallback<Person[]>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- callback
콜백
update(string, string, LargePersonGroupPersonUpdateOptionalParams)
사람의 name 또는 userData를 업데이트합니다.
function update(largePersonGroupId: string, personId: string, options?: LargePersonGroupPersonUpdateOptionalParams): Promise<RestResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, string, LargePersonGroupPersonUpdateOptionalParams, ServiceCallback<void>)
function update(largePersonGroupId: string, personId: string, options: LargePersonGroupPersonUpdateOptionalParams, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
update(string, string, ServiceCallback<void>)
function update(largePersonGroupId: string, personId: string, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
updateFace(string, string, string, LargePersonGroupPersonUpdateFaceOptionalParams)
지속형 얼굴의 userData 필드를 업데이트합니다.
function updateFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options?: LargePersonGroupPersonUpdateFaceOptionalParams): Promise<RestResponse>매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
updateFace(string, string, string, LargePersonGroupPersonUpdateFaceOptionalParams, ServiceCallback<void>)
function updateFace(largePersonGroupId: string, personId: string, persistedFaceId: string, options: LargePersonGroupPersonUpdateFaceOptionalParams, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
updateFace(string, string, string, ServiceCallback<void>)
function updateFace(largePersonGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)매개 변수
- largePersonGroupId
-
string
특정 큰 사용자 그룹을 참조하는 ID입니다.
- personId
-
string
특정 사용자를 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백