FaceListOperations class
Класс, представляющий FaceListOperations.
Конструкторы
| Face |
Создайте FaceListOperations. |
Методы
| add |
Добавление лица в указанный список лиц, до 1000 лиц.
|
| add |
|
| add |
|
| add |
Добавление лица в указанный список лиц, до 1000 лиц.
|
| 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, имя, userData, recognitionModel и лица в списке лиц. |
| get(string, Face |
|
| get(string, Service |
|
| list(Face |
List 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)
Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание persistedFaceId отличается от faceId, созданного Face — Detect.
- Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одно лицо. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии, что обнаружение и добавление лица будет успешно выполнено.
- Из-за определяемого размера лица (36x36–4096 x 4096 пикселей), большого положения головы или больших окклюзий приведут к сбоям.
- Добавление и удаление лиц в одном и том же списке лиц и из него обрабатываются последовательно, а в и из разных списков лиц выполняется параллельно.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
function addFaceFromStream(faceListId: string, image: HttpRequestBody, options?: FaceListAddFaceFromStreamOptionalParams): Promise<FaceListAddFaceFromStreamResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- 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
Идентификатор, ссылающийся на конкретный список лиц.
- image
- HttpRequestBody
Поток изображений.
Необязательные параметры
- callback
Обратный вызов
addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)
function addFaceFromStream(faceListId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- image
- HttpRequestBody
Поток изображений.
- callback
Обратный вызов
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams)
Добавление лица в указанный список лиц, до 1000 лиц.
Чтобы иметь дело с изображением, содержащим несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченная функция распознавания лиц будет храниться на сервере до вызова FaceList — Удалить лицо или FaceList — Удалить .
Примечание persistedFaceId отличается от faceId, созданного Face — Detect.
- Более высокое качество изображения лица означает лучшую точность обнаружения и распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одно лицо. Ноль или несколько лиц будут рассматриваться как ошибка. Если предоставленный прямоугольник targetFace не возвращается из face — Detect, нет никакой гарантии, что обнаружение и добавление лица будет успешно выполнено.
- Из-за определяемого размера лица (36x36–4096 x 4096 пикселей), большого положения головы или больших окклюзий приведут к сбоям.
- Добавление и удаление лиц в одном и том же списке лиц и из него обрабатываются последовательно, а в и из разных списков лиц выполняется параллельно.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
function addFaceFromUrl(faceListId: string, url: string, options?: FaceListAddFaceFromUrlOptionalParams): Promise<FaceListAddFaceFromUrlResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- 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
Идентификатор, ссылающийся на конкретный список лиц.
- url
-
string
Общедоступный URL-адрес изображения
Необязательные параметры
- callback
Обратный вызов
addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)
function addFaceFromUrl(faceListId: string, url: string, callback: ServiceCallback<PersistedFace>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- url
-
string
Общедоступный URL-адрес изображения
- callback
Обратный вызов
create(string, string, FaceListCreateOptionalParams)
Создайте пустой список лиц с указанным пользователем faceListId, именем, необязательным элементом userData и recognitionModel. В одной подписке разрешено до 64 списков лиц.
Список лиц — это список лиц до 1000 лиц, используемых face — Find Similar.
После создания пользователь должен использовать FaceList — Добавить лицо для импорта лиц.
Образ не будет сохранен. На сервере хранятся только извлеченные функции распознавания лиц до вызова FaceList — Delete .
Поиск похожих используется для таких сценариев, как поиск лиц, похожих на знаменитостей, аналогичная фильтрация лиц или для легкой идентификации лиц. Но если фактически используется для идентификации человека, используйте PersonGroup /
LargePersonGroup и Face — Identify.
Рекомендуется использовать LargeFaceList , если номер лица большой. Он может поддерживать до 1 000 000 лиц.
Для связи со списком лиц необходимо указать "recognitionModel". Значение по умолчанию для "recognitionModel" — "recognition_01". Если требуется последняя модель, явно укажите нужную модель в этом параметре. Новые лица, добавленные в существующий список лиц, будут использовать модель распознавания, уже связанную с коллекцией. Существующие признаки лиц в списке лиц не могут быть обновлены до признаков, извлеченных другой версией модели распознавания.
См. раздел Указание модели распознавания лиц.
function create(faceListId: string, name: string, options?: FaceListCreateOptionalParams): Promise<RestResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- 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
Идентификатор, ссылающийся на конкретный список лиц.
- name
-
string
Определяемое пользователем имя, максимальная длина составляет 128.
- options
- FaceListCreateOptionalParams
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
create(string, string, ServiceCallback<void>)
function create(faceListId: string, name: string, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- name
-
string
Определяемое пользователем имя, максимальная длина составляет 128.
- callback
-
ServiceCallback<void>
Обратный вызов
deleteFace(string, string, RequestOptionsBase)
Удаление лица из списка лиц с помощью указанных faceListId и persistedFaceId.
Добавление и удаление лиц в одном и том же списке лиц и из него обрабатываются последовательно, а также в разные списки лиц и из них параллельно.
function deleteFace(faceListId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- 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
Идентификатор, ссылающийся на конкретный список лиц.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- options
- RequestOptionsBase
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
deleteFace(string, string, ServiceCallback<void>)
function deleteFace(faceListId: string, persistedFaceId: string, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- persistedFaceId
-
string
Идентификатор, ссылающийся на конкретный persistedFaceId существующего лица.
- callback
-
ServiceCallback<void>
Обратный вызов
deleteMethod(string, RequestOptionsBase)
Удаляет указанный список лиц.
function deleteMethod(faceListId: string, options?: RequestOptionsBase): Promise<RestResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- RequestOptionsBase
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(faceListId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- RequestOptionsBase
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
deleteMethod(string, ServiceCallback<void>)
function deleteMethod(faceListId: string, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- callback
-
ServiceCallback<void>
Обратный вызов
get(string, FaceListGetOptionalParams)
Получите faceListId, имя, userData, recognitionModel и лица в списке лиц.
function get(faceListId: string, options?: FaceListGetOptionalParams): Promise<FaceListGetResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- FaceListGetOptionalParams
Необязательные параметры
Возвращаемое значение
Promise<FaceListGetResponse>
Promise<Models.FaceListGetResponse>
get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)
function get(faceListId: string, options: FaceListGetOptionalParams, callback: ServiceCallback<FaceList>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- FaceListGetOptionalParams
Необязательные параметры
- callback
Обратный вызов
get(string, ServiceCallback<FaceList>)
function get(faceListId: string, callback: ServiceCallback<FaceList>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- callback
Обратный вызов
list(FaceListListOptionalParams)
List faceListId, name, userData и recognitionModel списков лиц.
Чтобы получить сведения о лицах внутри faceList, используйте FaceList — Get
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[]>)
function list(callback: ServiceCallback<FaceList[]>)Параметры
- callback
Обратный вызов
update(string, FaceListUpdateOptionalParams)
Обновление сведений о списке лиц.
function update(faceListId: string, options?: FaceListUpdateOptionalParams): Promise<RestResponse>Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- FaceListUpdateOptionalParams
Необязательные параметры
Возвращаемое значение
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, FaceListUpdateOptionalParams, ServiceCallback<void>)
function update(faceListId: string, options: FaceListUpdateOptionalParams, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- options
- FaceListUpdateOptionalParams
Необязательные параметры
- callback
-
ServiceCallback<void>
Обратный вызов
update(string, ServiceCallback<void>)
function update(faceListId: string, callback: ServiceCallback<void>)Параметры
- faceListId
-
string
Идентификатор, ссылающийся на конкретный список лиц.
- callback
-
ServiceCallback<void>
Обратный вызов