PersonGroupPerson class
Класс, представляющий PersonGroupPerson.
Конструкторы
Person |
Создайте PersonGroupPerson. |
Методы
add |
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
На сервере будет храниться только извлеченная функция распознавания лиц, пока не будет вызван метод PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
|
add |
|
add |
|
add |
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
На сервере будет храниться только извлеченная функция распознавания лиц, пока не будет вызван метод PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
|
add |
|
add |
|
create(string, Person |
Создание нового пользователя в указанной группе пользователей. |
create(string, Person |
|
create(string, Service |
|
delete |
Удаление лица из группы пользователей по указанным personGroupId, personId и persistedFaceId.
|
delete |
|
delete |
|
delete |
Удаление существующего пользователя из группы пользователей. Функция persistedFaceId, userData, имя пользователя и лицо в записи пользователя будут удалены. |
delete |
|
delete |
|
get(string, string, Request |
Получение сведений о пользователе, включая зарегистрированные сохраненные лица, имя и userData. |
get(string, string, Request |
|
get(string, string, Service |
|
get |
Получение сведений о сохраняемом лице (задается параметром persistedFaceId, personId и принадлежащим ей personGroupId). |
get |
|
get |
|
list(string, Person |
Вывод списка всех пользователей в группе пользователей и получение сведений о пользователях (включая personId, имя, userData и persistedFaceIds зарегистрированных лиц пользователя). |
list(string, Person |
|
list(string, Service |
|
update(string, string, Person |
Обновление имени или userData пользователя. |
update(string, string, Person |
|
update(string, string, Service |
|
update |
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
Только извлеченная функция распознавания лиц будет храниться на сервере до вызова PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
|
update |
|
update |
Сведения о конструкторе
PersonGroupPerson(FaceClientContext)
Создайте PersonGroupPerson.
new PersonGroupPerson(client: FaceClientContext)
Параметры
- client
- FaceClientContext
Ссылка на клиент службы.
Сведения о методе
addFaceFromStream(string, string, HttpRequestBody, PersonGroupPersonAddFaceFromStreamOptionalParams)
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
На сервере будет храниться только извлеченная функция распознавания лиц, пока не будет вызван метод PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
Примечание persistedFaceId отличается от faceId, созданного Face — Detect.
- Более высокое качество изображения лица означает лучшую точность распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Каждая запись может содержать до 248 лиц.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одно лицо. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии, что обнаружение и добавление лица будет успешно выполнено.
- Из-за определяемого размера лица (36x36–4096 x 4096 пикселей), большого положения головы или больших окклюзий приведут к сбоям.
- Добавление и удаление лиц для одного и того же человека и их удаления будут обрабатываться последовательно. Добавление и удаление лиц для разных пользователей и их удаления обрабатываются параллельно.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, options?: PersonGroupPersonAddFaceFromStreamOptionalParams): Promise<PersonGroupPersonAddFaceFromStreamResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- image
- HttpRequestBody
Поток изображений.
Необязательные параметры
Возвращаемое значение
Promise<Models.PersonGroupPersonAddFaceFromStreamResponse>
addFaceFromStream(string, string, HttpRequestBody, PersonGroupPersonAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, options: PersonGroupPersonAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- image
- HttpRequestBody
Поток изображений.
Необязательные параметры
- callback
Обратный вызов
addFaceFromStream(string, string, HttpRequestBody, ServiceCallback<PersistedFace>)
function addFaceFromStream(personGroupId: string, personId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- image
- HttpRequestBody
Поток изображений.
- callback
Обратный вызов
addFaceFromUrl(string, string, string, PersonGroupPersonAddFaceFromUrlOptionalParams)
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
На сервере будет храниться только извлеченная функция распознавания лиц, пока не будет вызван метод PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
Примечание persistedFaceId отличается от faceId, созданного Face — Detect.
- Более высокое качество изображения лица означает лучшую точность распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Каждая запись может содержать до 248 лиц.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одно лицо. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии, что обнаружение и добавление лица будет успешно выполнено.
- Из-за определяемого размера лица (36x36–4096 x 4096 пикселей), большого положения головы или больших окклюзий приведут к сбоям.
- Добавление и удаление лиц для одного и того же человека и их удаления будут обрабатываться последовательно. Добавление и удаление лиц для разных пользователей и их удаления обрабатываются параллельно.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
function addFaceFromUrl(personGroupId: string, personId: string, url: string, options?: PersonGroupPersonAddFaceFromUrlOptionalParams): Promise<PersonGroupPersonAddFaceFromUrlResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- url
-
string
Общедоступный URL-адрес изображения
Необязательные параметры
Возвращаемое значение
Promise<Models.PersonGroupPersonAddFaceFromUrlResponse>
addFaceFromUrl(string, string, string, PersonGroupPersonAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
function addFaceFromUrl(personGroupId: string, personId: string, url: string, options: PersonGroupPersonAddFaceFromUrlOptionalParams, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- url
-
string
Общедоступный URL-адрес изображения
Необязательные параметры
- callback
Обратный вызов
addFaceFromUrl(string, string, string, ServiceCallback<PersistedFace>)
function addFaceFromUrl(personGroupId: string, personId: string, url: string, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- url
-
string
Общедоступный URL-адрес изображения
- callback
Обратный вызов
create(string, PersonGroupPersonCreateOptionalParams)
Создание нового пользователя в указанной группе пользователей.
function create(personGroupId: string, options?: PersonGroupPersonCreateOptionalParams): Promise<PersonGroupPersonCreateResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
Необязательные параметры
Возвращаемое значение
Promise<PersonGroupPersonCreateResponse>
Promise<Models.PersonGroupPersonCreateResponse>
create(string, PersonGroupPersonCreateOptionalParams, ServiceCallback<Person>)
function create(personGroupId: string, options: PersonGroupPersonCreateOptionalParams, callback: ServiceCallback<Person>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
Необязательные параметры
- callback
Обратный вызов
create(string, ServiceCallback<Person>)
function create(personGroupId: string, callback: ServiceCallback<Person>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- callback
Обратный вызов
deleteFace(string, string, string, RequestOptionsBase)
Удаление лица из группы пользователей по указанным personGroupId, personId и persistedFaceId.
Добавление и удаление лиц для одного и того же человека и их удаления будут обрабатываться последовательно.
Добавление и удаление лиц для разных пользователей и их удаления обрабатываются параллельно.
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteFace(string, string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- options
- RequestOptionsBase
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
deleteFace(string, string, string, ServiceCallback<void>)
function deleteFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- callback
-
ServiceCallback<void>
Обратный вызов
deleteMethod(string, string, RequestOptionsBase)
Удаление существующего пользователя из группы пользователей. Функция persistedFaceId, userData, имя пользователя и лицо в записи пользователя будут удалены.
function deleteMethod(personGroupId: string, personId: string, options?: RequestOptionsBase): Promise<RestResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(personGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- options
- RequestOptionsBase
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
deleteMethod(string, string, ServiceCallback<void>)
function deleteMethod(personGroupId: string, personId: string, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- callback
-
ServiceCallback<void>
Обратный вызов
get(string, string, RequestOptionsBase)
Получение сведений о пользователе, включая зарегистрированные сохраненные лица, имя и userData.
function get(personGroupId: string, personId: string, options?: RequestOptionsBase): Promise<PersonGroupPersonGetResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<PersonGroupPersonGetResponse>
Promise<Models.PersonGroupPersonGetResponse>
get(string, string, RequestOptionsBase, ServiceCallback<Person>)
function get(personGroupId: string, personId: string, options: RequestOptionsBase, callback: ServiceCallback<Person>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- options
- RequestOptionsBase
Необязательные параметры
- callback
Обратный вызов
get(string, string, ServiceCallback<Person>)
function get(personGroupId: string, personId: string, callback: ServiceCallback<Person>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- callback
Обратный вызов
getFace(string, string, string, RequestOptionsBase)
Получение сведений о сохраняемом лице (задается параметром persistedFaceId, personId и принадлежащим ей personGroupId).
function getFace(personGroupId: string, personId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<PersonGroupPersonGetFaceResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<PersonGroupPersonGetFaceResponse>
Promise<Models.PersonGroupPersonGetFaceResponse>
getFace(string, string, string, RequestOptionsBase, ServiceCallback<PersistedFace>)
function getFace(personGroupId: string, personId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- options
- RequestOptionsBase
Необязательные параметры
- callback
Обратный вызов
getFace(string, string, string, ServiceCallback<PersistedFace>)
function getFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<PersistedFace>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- callback
Обратный вызов
list(string, PersonGroupPersonListOptionalParams)
Вывод списка всех пользователей в группе пользователей и получение сведений о пользователях (включая personId, имя, userData и persistedFaceIds зарегистрированных лиц пользователя).
function list(personGroupId: string, options?: PersonGroupPersonListOptionalParams): Promise<PersonGroupPersonListResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
Необязательные параметры
Возвращаемое значение
Promise<PersonGroupPersonListResponse>
Promise<Models.PersonGroupPersonListResponse>
list(string, PersonGroupPersonListOptionalParams, ServiceCallback<Person[]>)
function list(personGroupId: string, options: PersonGroupPersonListOptionalParams, callback: ServiceCallback<Person[]>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
Необязательные параметры
- callback
Обратный вызов
list(string, ServiceCallback<Person[]>)
function list(personGroupId: string, callback: ServiceCallback<Person[]>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- callback
Обратный вызов
update(string, string, PersonGroupPersonUpdateOptionalParams)
Обновление имени или userData пользователя.
function update(personGroupId: string, personId: string, options?: PersonGroupPersonUpdateOptionalParams): Promise<RestResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, string, PersonGroupPersonUpdateOptionalParams, ServiceCallback<void>)
function update(personGroupId: string, personId: string, options: PersonGroupPersonUpdateOptionalParams, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
update(string, string, ServiceCallback<void>)
function update(personGroupId: string, personId: string, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на конкретного человека.
- callback
-
ServiceCallback<void>
Обратный вызов
updateFace(string, string, string, PersonGroupPersonUpdateFaceOptionalParams)
Добавление лица к человеку в группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входное лицо можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен.
Только извлеченная функция распознавания лиц будет храниться на сервере до вызова PersonGroup PersonFace — Delete, PersonGroup Person — Delete или PersonGroup — Delete .
Примечание. Значение persistedFaceId отличается от faceId, созданного Face — Detect.
- Более высокое качество изображения лица означает лучшую точность распознавания. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Каждая запись может содержать до 248 лиц.
- Поддерживаются JPEG, PNG, GIF (первый кадр) и формат BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одну грань. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии для успешного обнаружения и добавления лица.
- Если определить размер лица (36x36–4096 x 4096 пикселей), большой размер головы или большие окклюзии вызовут сбои.
- Добавление или удаление лиц для одного и того же пользователя будет обрабатываться последовательно. Добавление и удаление лиц для разных пользователей и их удаления обрабатываются параллельно.
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, options?: PersonGroupPersonUpdateFaceOptionalParams): Promise<RestResponse>
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на определенного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
updateFace(string, string, string, PersonGroupPersonUpdateFaceOptionalParams, ServiceCallback<void>)
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, options: PersonGroupPersonUpdateFaceOptionalParams, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на определенного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
updateFace(string, string, string, ServiceCallback<void>)
function updateFace(personGroupId: string, personId: string, persistedFaceId: string, callback: ServiceCallback<void>)
Параметры
- personGroupId
-
string
Идентификатор, ссылающийся на определенную группу пользователей.
- personId
-
string
Идентификатор, ссылающийся на определенного человека.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- callback
-
ServiceCallback<void>
Обратный вызов