PersonGroupOperations class

  • 참조
패키지:
@azure/cognitiveservices-face

PersonGroupOperations를 나타내는 클래스입니다.

생성자

PersonGroupOperations(FaceClientContext)

PersonGroupOperations를 만듭니다.

메서드

create(string, string, PersonGroupCreateOptionalParams)

지정된 personGroupId, 이름, 사용자가 제공한 userData 및 recognitionModel을 사용하여 새 사용자 그룹을 만듭니다.
사람 그룹은 얼굴 인식 기능을 포함하여 업로드된 사람 데이터의 컨테이너입니다.
만든 후 PersonGroup Person - Create 를 사용하여 그룹에 사용자를 추가한 다음 PersonGroup - Train 을 호출하여 이 그룹을 Face - Identify에 대해 준비합니다.
이미지가 저장되지 않습니다. PersonGroup Person - Delete 또는 PersonGroup - Delete가 호출될 때까지 사람의 추출된 얼굴 기능 및 userData만 서버에 저장 됩니다.
이 사용자 그룹과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 사용자 그룹에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 사람 그룹의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다.

개인 그룹 할당량:

  • 무료 계층 구독 할당량: 1,000명 그룹. 각각 최대 1,000명을 수용할 수 있습니다.
  • S0 계층 구독 할당량: 1,000,000명 그룹. 각각 최대 10,000명을 수용할 수 있습니다.
  • 대규모 얼굴 식별 문제를 처리하려면 LargePersonGroup을 사용하는 것이 좋습니다.
create(string, string, PersonGroupCreateOptionalParams, ServiceCallback<void>)
create(string, string, ServiceCallback<void>)
deleteMethod(string, RequestOptionsBase)

기존 사용자 그룹을 삭제합니다. 사람 그룹에 있는 모든 사람의 지속형 얼굴 기능도 삭제됩니다.
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
deleteMethod(string, ServiceCallback<void>)
get(string, PersonGroupGetOptionalParams)

사용자 그룹 이름, userData 및 recognitionModel을 검색합니다. 이 personGroup에서 사람 정보를 얻으려면 PersonGroup Person - List를 사용합니다.
get(string, PersonGroupGetOptionalParams, ServiceCallback<PersonGroup>)
get(string, ServiceCallback<PersonGroup>)
getTrainingStatus(string, RequestOptionsBase)

사용자 그룹의 학습 상태 검색합니다(완료 또는 진행 중).
getTrainingStatus(string, RequestOptionsBase, ServiceCallback<TrainingStatus>)
getTrainingStatus(string, ServiceCallback<TrainingStatus>)
list(PersonGroupListOptionalParams)

사용자 그룹의 personGroupId, name, userData 및 recognitionModel을 나열합니다.

  • 사람 그룹은 personGroupId의 사전순으로 저장됩니다.
  • "start" 매개 변수(문자열, 선택 사항)는 반환된 항목이 문자열 비교에 의해 더 큰 ID를 갖는 사용자 제공 personGroupId 값입니다. "start"는 첫 번째 항목의 반환을 나타내기 위해 비어 있음으로 설정됩니다.
  • "top" 매개 변수(int, 선택 사항)는 반환할 항목 수를 지정합니다. 한 번의 호출로 최대 1,000개의 항목을 반환할 수 있습니다. 더 많은 항목을 가져오려면 현재 호출의 마지막으로 반환된 항목의 ID로 "시작"을 지정할 수 있습니다.
    예를 들어 총 5인 그룹: "group1", ..., "group5".
    "start=&top="은 5개의 그룹을 모두 반환합니다.
    "start=&top=2"는 "group1", "group2"를 반환합니다.
    "start=group2&top=3"은 "group3", "group4", "group5"를 반환합니다.
list(PersonGroupListOptionalParams, ServiceCallback<PersonGroup[]>)
list(ServiceCallback<PersonGroup[]>)
train(string, RequestOptionsBase)

사람 그룹 학습 작업을 큐에 추가하면 학습 작업이 즉시 시작되지 않을 수 있습니다.
train(string, RequestOptionsBase, ServiceCallback<void>)
train(string, ServiceCallback<void>)
update(string, PersonGroupUpdateOptionalParams)

기존 사용자 그룹의 표시 이름 및 userData를 업데이트합니다. 요청 본문에 표시되지 않는 속성은 업데이트되지 않습니다.
update(string, PersonGroupUpdateOptionalParams, ServiceCallback<void>)
update(string, ServiceCallback<void>)

생성자 세부 정보

PersonGroupOperations(FaceClientContext)

PersonGroupOperations를 만듭니다.

new PersonGroupOperations(client: FaceClientContext)

매개 변수

client
FaceClientContext

서비스 클라이언트에 대한 참조입니다.

메서드 세부 정보

create(string, string, PersonGroupCreateOptionalParams)

지정된 personGroupId, 이름, 사용자가 제공한 userData 및 recognitionModel을 사용하여 새 사용자 그룹을 만듭니다.
사람 그룹은 얼굴 인식 기능을 포함하여 업로드된 사람 데이터의 컨테이너입니다.
만든 후 PersonGroup Person - Create 를 사용하여 그룹에 사용자를 추가한 다음 PersonGroup - Train 을 호출하여 이 그룹을 Face - Identify에 대해 준비합니다.
이미지가 저장되지 않습니다. PersonGroup Person - Delete 또는 PersonGroup - Delete가 호출될 때까지 사람의 추출된 얼굴 기능 및 userData만 서버에 저장 됩니다.
이 사용자 그룹과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 사용자 그룹에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 사람 그룹의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다.

개인 그룹 할당량:

  • 무료 계층 구독 할당량: 1,000명 그룹. 각각 최대 1,000명을 수용할 수 있습니다.
  • S0 계층 구독 할당량: 1,000,000명 그룹. 각각 최대 10,000명을 수용할 수 있습니다.
  • 대규모 얼굴 식별 문제를 처리하려면 LargePersonGroup을 사용하는 것이 좋습니다.
function create(personGroupId: string, name: string, options?: PersonGroupCreateOptionalParams): Promise<RestResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

name

string

사용자 정의 이름, 최대 길이는 128입니다.

options
PersonGroupCreateOptionalParams

선택적 매개 변수

반환

Promise<RestResponse>

Promise<msRest.RestResponse>

create(string, string, PersonGroupCreateOptionalParams, ServiceCallback<void>) 

function create(personGroupId: string, name: string, options: PersonGroupCreateOptionalParams, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

name

string

사용자 정의 이름, 최대 길이는 128입니다.

options
PersonGroupCreateOptionalParams

선택적 매개 변수

callback

ServiceCallback<void>

콜백

create(string, string, ServiceCallback<void>) 

function create(personGroupId: string, name: string, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

name

string

사용자 정의 이름, 최대 길이는 128입니다.

callback

ServiceCallback<void>

콜백

deleteMethod(string, RequestOptionsBase)

기존 사용자 그룹을 삭제합니다. 사람 그룹에 있는 모든 사람의 지속형 얼굴 기능도 삭제됩니다.

function deleteMethod(personGroupId: string, options?: RequestOptionsBase): Promise<RestResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

반환

Promise<RestResponse>

Promise<msRest.RestResponse>

deleteMethod(string, RequestOptionsBase, ServiceCallback<void>) 

function deleteMethod(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

callback

ServiceCallback<void>

콜백

deleteMethod(string, ServiceCallback<void>) 

function deleteMethod(personGroupId: string, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

callback

ServiceCallback<void>

콜백

get(string, PersonGroupGetOptionalParams)

사용자 그룹 이름, userData 및 recognitionModel을 검색합니다. 이 personGroup에서 사람 정보를 얻으려면 PersonGroup Person - List를 사용합니다.

function get(personGroupId: string, options?: PersonGroupGetOptionalParams): Promise<PersonGroupGetResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
PersonGroupGetOptionalParams

선택적 매개 변수

반환

Promise<PersonGroupGetResponse>

Promise<Models.PersonGroupGetResponse>

get(string, PersonGroupGetOptionalParams, ServiceCallback<PersonGroup>) 

function get(personGroupId: string, options: PersonGroupGetOptionalParams, callback: ServiceCallback<PersonGroup>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
PersonGroupGetOptionalParams

선택적 매개 변수

callback

ServiceCallback<PersonGroup>

콜백

get(string, ServiceCallback<PersonGroup>) 

function get(personGroupId: string, callback: ServiceCallback<PersonGroup>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

callback

ServiceCallback<PersonGroup>

콜백

getTrainingStatus(string, RequestOptionsBase)

사용자 그룹의 학습 상태 검색합니다(완료 또는 진행 중).

function getTrainingStatus(personGroupId: string, options?: RequestOptionsBase): Promise<PersonGroupGetTrainingStatusResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

반환

Promise<PersonGroupGetTrainingStatusResponse>

Promise<Models.PersonGroupGetTrainingStatusResponse>

getTrainingStatus(string, RequestOptionsBase, ServiceCallback<TrainingStatus>) 

function getTrainingStatus(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<TrainingStatus>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

callback

ServiceCallback<TrainingStatus>

콜백

getTrainingStatus(string, ServiceCallback<TrainingStatus>) 

function getTrainingStatus(personGroupId: string, callback: ServiceCallback<TrainingStatus>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

callback

ServiceCallback<TrainingStatus>

콜백

list(PersonGroupListOptionalParams)

사용자 그룹의 personGroupId, name, userData 및 recognitionModel을 나열합니다.

  • 사람 그룹은 personGroupId의 사전순으로 저장됩니다.
  • "start" 매개 변수(문자열, 선택 사항)는 반환된 항목이 문자열 비교에 의해 더 큰 ID를 갖는 사용자 제공 personGroupId 값입니다. "start"는 첫 번째 항목의 반환을 나타내기 위해 비어 있음으로 설정됩니다.
  • "top" 매개 변수(int, 선택 사항)는 반환할 항목 수를 지정합니다. 한 번의 호출로 최대 1,000개의 항목을 반환할 수 있습니다. 더 많은 항목을 가져오려면 현재 호출의 마지막으로 반환된 항목의 ID로 "시작"을 지정할 수 있습니다.
    예를 들어 총 5인 그룹: "group1", ..., "group5".
    "start=&top="은 5개의 그룹을 모두 반환합니다.
    "start=&top=2"는 "group1", "group2"를 반환합니다.
    "start=group2&top=3"은 "group3", "group4", "group5"를 반환합니다.
function list(options?: PersonGroupListOptionalParams): Promise<PersonGroupListResponse>

매개 변수

options
PersonGroupListOptionalParams

선택적 매개 변수

반환

Promise<PersonGroupListResponse>

Promise<Models.PersonGroupListResponse>

list(PersonGroupListOptionalParams, ServiceCallback<PersonGroup[]>) 

function list(options: PersonGroupListOptionalParams, callback: ServiceCallback<PersonGroup[]>)

매개 변수

options
PersonGroupListOptionalParams

선택적 매개 변수

callback

ServiceCallback<PersonGroup[]>

콜백

list(ServiceCallback<PersonGroup[]>) 

function list(callback: ServiceCallback<PersonGroup[]>)

매개 변수

callback

ServiceCallback<PersonGroup[]>

콜백

train(string, RequestOptionsBase)

사람 그룹 학습 작업을 큐에 추가하면 학습 작업이 즉시 시작되지 않을 수 있습니다.

function train(personGroupId: string, options?: RequestOptionsBase): Promise<RestResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

반환

Promise<RestResponse>

Promise<msRest.RestResponse>

train(string, RequestOptionsBase, ServiceCallback<void>) 

function train(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
RequestOptionsBase

선택적 매개 변수

callback

ServiceCallback<void>

콜백

train(string, ServiceCallback<void>) 

function train(personGroupId: string, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

callback

ServiceCallback<void>

콜백

update(string, PersonGroupUpdateOptionalParams)

기존 사용자 그룹의 표시 이름 및 userData를 업데이트합니다. 요청 본문에 표시되지 않는 속성은 업데이트되지 않습니다.

function update(personGroupId: string, options?: PersonGroupUpdateOptionalParams): Promise<RestResponse>

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
PersonGroupUpdateOptionalParams

선택적 매개 변수

반환

Promise<RestResponse>

Promise<msRest.RestResponse>

update(string, PersonGroupUpdateOptionalParams, ServiceCallback<void>) 

function update(personGroupId: string, options: PersonGroupUpdateOptionalParams, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

options
PersonGroupUpdateOptionalParams

선택적 매개 변수

callback

ServiceCallback<void>

콜백

update(string, ServiceCallback<void>) 

function update(personGroupId: string, callback: ServiceCallback<void>)

매개 변수

personGroupId

string

특정 사용자 그룹을 참조하는 ID입니다.

callback

ServiceCallback<void>

콜백