FaceListOperations class
FaceListOperations를 나타내는 클래스입니다.
생성자
| Face |
FaceListOperations를 만듭니다. |
메서드
| add |
최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
|
| add |
|
| add |
|
| add |
최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
|
| add |
|
| add |
|
| create(string, string, Face |
사용자 지정 faceListId, 이름, 선택적 userData 및 recognitionModel을 사용하여 빈 얼굴 목록을 만듭니다. 한 구독에서 최대 64개의 얼굴 목록이 허용됩니다.
|
| create(string, string, Face |
|
| create(string, string, Service |
|
| delete |
지정된 faceListId 및 persistedFaceId를 사용하여 얼굴 목록에서 얼굴을 삭제합니다.
|
| delete |
|
| delete |
|
| delete |
지정된 얼굴 목록을 삭제합니다. |
| delete |
|
| delete |
|
| get(string, Face |
얼굴 목록에서 얼굴 목록의 faceListId, name, userData, recognitionModel 및 얼굴을 검색합니다. |
| get(string, Face |
|
| get(string, Service |
|
| list(Face |
얼굴 목록의 faceListId, name, userData 및 recognitionModel을 나열합니다. |
| list(Face |
|
| list(Service |
|
| update(string, Face |
얼굴 목록의 정보를 업데이트합니다. |
| update(string, Face |
|
| update(string, Service |
생성자 세부 정보
FaceListOperations(FaceClientContext)
FaceListOperations를 만듭니다.
new FaceListOperations(client: FaceClientContext)매개 변수
- client
- FaceClientContext
서비스 클라이언트에 대한 참조입니다.
메서드 세부 정보
addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams)
최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 서버에 저장됩니다.
참고 persistedFaceId는 Face - Detect에서 생성된 faceId와 다릅니다.
- 얼굴 이미지 품질이 높을수록 감지 및 인식 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- "targetFace" 사각형에는 하나의 얼굴이 포함되어야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face - Detect에서 반환되지 않으면 얼굴을 감지하고 성공적으로 추가해야 합니다.
- 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
- 동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
function addFaceFromStream(faceListId: string, image: HttpRequestBody, options?: FaceListAddFaceFromStreamOptionalParams): Promise<FaceListAddFaceFromStreamResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
반환
Promise<FaceListAddFaceFromStreamResponse>
Promise<Models.FaceListAddFaceFromStreamResponse>
addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromStream(faceListId: string, image: HttpRequestBody, options: FaceListAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
선택적 매개 변수
- callback
콜백
addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)
function addFaceFromStream(faceListId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- image
- HttpRequestBody
이미지 스트림입니다.
- callback
콜백
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams)
최대 1,000개까지 지정된 얼굴 목록에 얼굴을 추가합니다.
여러 얼굴을 포함하는 이미지를 처리하기 위해 입력 얼굴을 targetFace 사각형이 있는 이미지로 지정할 수 있습니다. 추가된 얼굴을 나타내는 persistedFaceId를 반환합니다. 이미지가 저장되지 않습니다. 추출된 얼굴 기능만 FaceList - Face 삭제 또는 FaceList - Delete가 호출될 때까지 서버에 저장됩니다.
참고 persistedFaceId는 Face - Detect에서 생성된 faceId와 다릅니다.
- 얼굴 이미지 품질이 높을수록 감지 및 인식 정밀도가 향상됩니다. 고품질 얼굴을 고려하세요. 정면, 투명 및 얼굴 크기는 200x200픽셀(눈 사이의 100픽셀) 이상입니다.
- JPEG, PNG, GIF(첫 번째 프레임) 및 BMP 형식이 지원됩니다. 허용되는 이미지 파일 크기는 1KB에서 6MB까지입니다.
- "targetFace" 사각형에는 하나의 얼굴이 포함되어야 합니다. 0개 또는 여러 얼굴은 오류로 간주됩니다. 제공된 "targetFace" 사각형이 Face - Detect에서 반환되지 않으면 얼굴을 감지하고 성공적으로 추가해야 합니다.
- 감지 가능한 얼굴 크기(36x36 - 4096x4096 픽셀), 큰 머리 포즈 또는 큰 폐색으로 인해 오류가 발생합니다.
- 동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.
- 감지 가능한 최소 얼굴 크기는 1920x1080픽셀 이하의 이미지에서 36x36픽셀입니다. 크기가 1920x1080 픽셀보다 큰 이미지에는 비례적으로 더 큰 최소 얼굴 크기가 필요합니다.
- 다양한 'detectionModel' 값을 제공할 수 있습니다. 다양한 검색 모델을 사용하고 비교하려면 검색 모델을 지정하는 방법을 참조하세요.
function addFaceFromUrl(faceListId: string, url: string, options?: FaceListAddFaceFromUrlOptionalParams): Promise<FaceListAddFaceFromUrlResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
선택적 매개 변수
반환
Promise<FaceListAddFaceFromUrlResponse>
Promise<Models.FaceListAddFaceFromUrlResponse>
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromUrl(faceListId: string, url: string, options: FaceListAddFaceFromUrlOptionalParams, callback: ServiceCallback<PersistedFace>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
선택적 매개 변수
- callback
콜백
addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)
function addFaceFromUrl(faceListId: string, url: string, callback: ServiceCallback<PersistedFace>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- url
-
string
이미지의 공개적으로 연결할 수 있는 URL
- callback
콜백
create(string, string, FaceListCreateOptionalParams)
사용자 지정 faceListId, 이름, 선택적 userData 및 recognitionModel을 사용하여 빈 얼굴 목록을 만듭니다. 한 구독에서 최대 64개의 얼굴 목록이 허용됩니다.
얼굴 목록은 최대 1,000명의 얼굴 목록이며 Face - Find Similar에서 사용됩니다.
만든 후에는 FaceList - Face 추가 를 사용하여 얼굴을 가져와야 합니다.
이미지가 저장되지 않습니다. 추출된 얼굴 기능만 FaceList - Delete 가 호출될 때까지 서버에 저장됩니다.
유사 항목 찾기는 유명인과 유사한 얼굴 찾기, 유사한 얼굴 필터링 또는 가벼운 얼굴 식별과 같은 시나리오에 사용됩니다. 그러나 실제 사용이 사람을 식별하는 것이라면 PersonGroupLargePersonGroup /
및 Face - Identify를 사용하세요.
얼굴 번호가 큰 경우 LargeFaceList 를 고려하세요. 최대 1,000,000명의 얼굴을 지원할 수 있습니다.
이 얼굴 목록과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 얼굴 목록에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 얼굴 목록의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다.
얼굴 인식 모델 지정을 참조하세요.
function create(faceListId: string, name: string, options?: FaceListCreateOptionalParams): Promise<RestResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- options
- FaceListCreateOptionalParams
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
create(string, string, FaceListCreateOptionalParams, ServiceCallback<void>)
function create(faceListId: string, name: string, options: FaceListCreateOptionalParams, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- options
- FaceListCreateOptionalParams
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
create(string, string, ServiceCallback<void>)
function create(faceListId: string, name: string, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- callback
-
ServiceCallback<void>
콜백
deleteFace(string, string, RequestOptionsBase)
지정된 faceListId 및 persistedFaceId를 사용하여 얼굴 목록에서 얼굴을 삭제합니다.
동일한 얼굴 목록에서 얼굴을 추가/삭제하는 작업은 순차적으로 처리되고 다른 얼굴 목록에서는 병렬로 처리됩니다.
function deleteFace(faceListId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteFace(string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteFace(faceListId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
deleteFace(string, string, ServiceCallback<void>)
function deleteFace(faceListId: string, persistedFaceId: string, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- persistedFaceId
-
string
기존 얼굴의 특정 persistedFaceId를 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, RequestOptionsBase)
지정된 얼굴 목록을 삭제합니다.
function deleteMethod(faceListId: string, options?: RequestOptionsBase): Promise<RestResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(faceListId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, ServiceCallback<void>)
function deleteMethod(faceListId: string, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
get(string, FaceListGetOptionalParams)
얼굴 목록에서 얼굴 목록의 faceListId, name, userData, recognitionModel 및 얼굴을 검색합니다.
function get(faceListId: string, options?: FaceListGetOptionalParams): Promise<FaceListGetResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- FaceListGetOptionalParams
선택적 매개 변수
반환
Promise<FaceListGetResponse>
Promise<Models.FaceListGetResponse>
get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)
function get(faceListId: string, options: FaceListGetOptionalParams, callback: ServiceCallback<FaceList>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- FaceListGetOptionalParams
선택적 매개 변수
- callback
콜백
get(string, ServiceCallback<FaceList>)
function get(faceListId: string, callback: ServiceCallback<FaceList>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- callback
콜백
list(FaceListListOptionalParams)
얼굴 목록의 faceListId, name, userData 및 recognitionModel을 나열합니다.
faceList 내에서 얼굴 정보를 얻으려면 FaceList 사용 - 가져오기
function list(options?: FaceListListOptionalParams): Promise<FaceListListResponse>매개 변수
- options
- FaceListListOptionalParams
선택적 매개 변수
반환
Promise<FaceListListResponse>
Promise<Models.FaceListListResponse>
list(FaceListListOptionalParams, ServiceCallback<FaceList[]>)
function list(options: FaceListListOptionalParams, callback: ServiceCallback<FaceList[]>)매개 변수
- options
- FaceListListOptionalParams
선택적 매개 변수
- callback
콜백
list(ServiceCallback<FaceList[]>)
update(string, FaceListUpdateOptionalParams)
얼굴 목록의 정보를 업데이트합니다.
function update(faceListId: string, options?: FaceListUpdateOptionalParams): Promise<RestResponse>매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- FaceListUpdateOptionalParams
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, FaceListUpdateOptionalParams, ServiceCallback<void>)
function update(faceListId: string, options: FaceListUpdateOptionalParams, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- options
- FaceListUpdateOptionalParams
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
update(string, ServiceCallback<void>)
function update(faceListId: string, callback: ServiceCallback<void>)매개 변수
- faceListId
-
string
특정 얼굴 목록을 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백