LargePersonGroupPersonOperations Класс
Операции LargePersonGroupPersonOperations.
Не следует создавать экземпляр этого класса напрямую, а создать экземпляр Client, который создаст его для вас и прикрепит его к атрибуту.
- Наследование
-
builtins.objectLargePersonGroupPersonOperations
Конструктор
LargePersonGroupPersonOperations(client, config, serializer, deserializer)
Параметры
Имя | Описание |
---|---|
client
Обязательно
|
Клиент для запросов на обслуживание. |
config
Обязательно
|
Настройка клиента службы. |
serializer
Обязательно
|
Сериализатор объектной модели. |
deserializer
Обязательно
|
Десериализатор объектной модели. |
Методы
add_face_from_stream |
Добавление лица к человеку в большую группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова LargePersonGroup PersonFace — Delete, LargePersonGroup Person — Delete или LargePersonGroup — Delete .
|
add_face_from_url |
Добавление лица к человеку в большую группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова LargePersonGroup PersonFace — Delete, LargePersonGroup Person — Delete или LargePersonGroup — Delete .
|
create |
Создание нового пользователя в указанной большой группе пользователей. |
delete |
Удаление существующего пользователя из большой группы пользователей. Функции persistedFaceId, userData, person name и face в записи person будут удалены. |
delete_face |
Удаление лица из большой группы пользователей с помощью указанных largePersonGroupId, personId и persistedFaceId.
|
get |
Извлеките имя и userData пользователя, а также сохраненные идентификаторы лиц, представляющие функцию зарегистрированного лица пользователя. |
get_face |
Получение сведений о сохраняемом лице (заданном параметром persistedFaceId, personId и его принадлежности largePersonGroupId). |
list |
Вывод списка всех пользователей в большой группе пользователей и получение сведений о пользователях (включая personId, name, userData и persistedFaceIds зарегистрированных лиц человека). |
update |
Обновление имени или userData пользователя. |
update_face |
Обновите поле userData для сохраненного лица. |
add_face_from_stream
Добавление лица к человеку в большую группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова LargePersonGroup PersonFace — Delete, LargePersonGroup Person — Delete или LargePersonGroup — Delete .
Примечание. PersistedFaceId отличается от faceId, созданного [Face]
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Более высокое качество изображения лица означает лучшую точность распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
add_face_from_stream(large_person_group_id, person_id, image, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, callback=None, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную группу больших пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
image
Обязательно
|
Поток изображений. |
user_data
|
Пользовательские данные о лице для любых целей. Максимальная длина составляет 1 КБ. значение по умолчанию: None
|
target_face
|
Прямоугольник лица, указывающий целевое лицо, добавляемое к человеку в формате "targetFace=left,top,width,height". Например, "targetFace=10,10,100,100". Если на изображении несколько лиц, требуется targetFace, чтобы указать, какое лицо следует добавить. Отсутствие targetFace означает, что во всем изображении обнаружено только одно лицо. значение по умолчанию: None
|
detection_model
|
str или
DetectionModel
Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении face - Detect или (Large)FaceList - Add FaceList или (Large)PersonGroup - Add Face. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03". значение по умолчанию: detection_01
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом. значение по умолчанию: False
|
callback
|
Callable[<xref:Bytes>, <xref:response=None>]
При указании будет вызываться с каждым блоком данных, который передается в поток. Обратный вызов должен принимать два аргумента: байт текущего фрагмента данных и объект ответа. Если данные передаются, ответ будет равен None. значение по умолчанию: None
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
PersistedFace или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
add_face_from_url
Добавление лица к человеку в большую группу пользователей для идентификации или проверки лица. Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова LargePersonGroup PersonFace — Delete, LargePersonGroup Person — Delete или LargePersonGroup — Delete .
Примечание. PersistedFaceId отличается от faceId, созданного [Face]
Detect](https://docs.microsoft.com/rest/api/faceapi/face/detectwithurl).
- Более высокое качество изображения лица означает лучшую точность распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
add_face_from_url(large_person_group_id, person_id, url, user_data=None, target_face=None, detection_model='detection_01', custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную группу больших пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
url
Обязательно
|
Общедоступный URL-адрес изображения |
user_data
|
Пользовательские данные о лице для любых целей. Максимальная длина составляет 1 КБ. значение по умолчанию: None
|
target_face
|
Прямоугольник лица, указывающий целевое лицо, добавляемое к человеку в формате "targetFace=left,top,width,height". Например, "targetFace=10,10,100,100". Если на изображении несколько лиц, требуется targetFace, чтобы указать, какое лицо следует добавить. Отсутствие targetFace означает, что во всем изображении обнаружено только одно лицо. значение по умолчанию: None
|
detection_model
|
str или
DetectionModel
Имя модели обнаружения. Модель обнаружения используется для обнаружения лиц на отправленном изображении. Имя модели обнаружения можно указать при выполнении face - Detect или (Large)FaceList - Add FaceList или (Large)PersonGroup - Add Face. Значение по умолчанию — "detection_01". Если требуется другая модель, укажите ее явным образом. Возможные значения: "detection_01", "detection_02", "detection_03". значение по умолчанию: detection_01
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом. значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
PersistedFace или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
create
Создание нового пользователя в указанной большой группе пользователей.
create(large_person_group_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную группу больших пользователей. |
name
|
Имя, определенное пользователем, максимальная длина — 128. значение по умолчанию: None
|
user_data
|
Данные, указанные пользователем. Длина не должна превышать 16 КБ. значение по умолчанию: None
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом. значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
Person или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
delete
Удаление существующего пользователя из большой группы пользователей. Функции persistedFaceId, userData, person name и face в записи person будут удалены.
delete(large_person_group_id, person_id, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
None или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
delete_face
Удаление лица из большой группы пользователей с помощью указанных largePersonGroupId, personId и persistedFaceId.
Добавление и удаление лиц для одного и того же человека будет обрабатываться последовательно. Добавление и удаление лиц для разных пользователей и их удаления обрабатываются параллельно.
delete_face(large_person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
persisted_face_id
Обязательно
|
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица. |
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
None или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
get
Извлеките имя и userData пользователя, а также сохраненные идентификаторы лиц, представляющие функцию зарегистрированного лица пользователя.
get(large_person_group_id, person_id, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
Person или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
get_face
Получение сведений о сохраняемом лице (заданном параметром persistedFaceId, personId и его принадлежности largePersonGroupId).
get_face(large_person_group_id, person_id, persisted_face_id, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
persisted_face_id
Обязательно
|
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица. |
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
PersistedFace или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
list
Вывод списка всех пользователей в большой группе пользователей и получение сведений о пользователях (включая personId, name, userData и persistedFaceIds зарегистрированных лиц человека).
list(large_person_group_id, start=None, top=None, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
start
|
Начальный идентификатор возвращаемого пользователя (используется для перечисления диапазона пользователей). значение по умолчанию: None
|
top
|
Число возвращаемых пользователей, начиная с идентификатора пользователя, указанного параметром start. значение по умолчанию: None
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
<xref:msrest.pipeline.ClientRawResponse>
|
list или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
update
Обновление имени или userData пользователя.
update(large_person_group_id, person_id, name=None, user_data=None, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
name
|
Определяемое пользователем имя, максимальная длина составляет 128. значение по умолчанию: None
|
user_data
|
Данные, указанные пользователем. Длина не должна превышать 16 КБ. значение по умолчанию: None
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
None или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
update_face
Обновите поле userData для сохраненного лица.
update_face(large_person_group_id, person_id, persisted_face_id, user_data=None, custom_headers=None, raw=False, **operation_config)
Параметры
Имя | Описание |
---|---|
large_person_group_id
Обязательно
|
Идентификатор, ссылающийся на определенную большую группу пользователей. |
person_id
Обязательно
|
Идентификатор, ссылающийся на определенного человека. |
persisted_face_id
Обязательно
|
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица. |
user_data
|
Предоставленные пользователем данные, прикрепленные к лицу. Ограничение на размер составляет 1 КБ. значение по умолчанию: None
|
custom_headers
|
заголовки, которые будут добавлены в запрос значение по умолчанию: None
|
raw
|
возвращает прямой ответ вместе с десериализованным ответом значение по умолчанию: False
|
operation_config
Обязательно
|
Переопределения конфигурации операций. |
Возвращаемое значение
Тип | Описание |
---|---|
None,
<xref:msrest.pipeline.ClientRawResponse>
|
None или ClientRawResponse, если raw=true |
Исключения
Тип | Описание |
---|---|
Атрибуты
models
models = <module 'azure.cognitiveservices.vision.face.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\cognitiveservices\\vision\\face\\models\\__init__.py'>
Azure SDK for Python
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по