Поделиться через


FaceListOperations class

Класс, представляющий FaceListOperations.

Конструкторы

FaceListOperations(FaceClientContext)

Создайте FaceListOperations.

Методы

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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)
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. Сведения об использовании и сравнении различных моделей обнаружения см. в статье Как указать модель обнаружения.
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)
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". Если требуется последняя модель, явно укажите нужную модель в этом параметре. Новые лица, добавленные в существующий список лиц, будут использовать модель распознавания, уже связанную с коллекцией. Существующие признаки лиц в списке лиц не могут быть обновлены до признаков, извлеченных другой версией модели распознавания. См. раздел Указание модели распознавания лиц.

create(string, string, FaceListCreateOptionalParams, ServiceCallback<void>)
create(string, string, ServiceCallback<void>)
deleteFace(string, string, RequestOptionsBase)

Удаление лица из списка лиц с помощью указанных faceListId и persistedFaceId.
Добавление и удаление лиц в одном и том же списке лиц и из него обрабатываются последовательно, а также в разные списки лиц и из них параллельно.

deleteFace(string, string, RequestOptionsBase, ServiceCallback<void>)
deleteFace(string, string, ServiceCallback<void>)
deleteMethod(string, RequestOptionsBase)

Удаляет указанный список лиц.

deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
deleteMethod(string, ServiceCallback<void>)
get(string, FaceListGetOptionalParams)

Получите faceListId, имя, userData, recognitionModel и лица в списке лиц.

get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)
get(string, ServiceCallback<FaceList>)
list(FaceListListOptionalParams)

List faceListId, name, userData и recognitionModel списков лиц.
Чтобы получить сведения о лицах внутри faceList, используйте FaceList — Get

list(FaceListListOptionalParams, ServiceCallback<FaceList[]>)
list(ServiceCallback<FaceList[]>)
update(string, FaceListUpdateOptionalParams)

Обновление сведений о списке лиц.

update(string, FaceListUpdateOptionalParams, ServiceCallback<void>)
update(string, ServiceCallback<void>)

Сведения о конструкторе

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

Поток изображений.

options
FaceListAddFaceFromStreamOptionalParams

Необязательные параметры

Возвращаемое значение

Promise<Models.FaceListAddFaceFromStreamResponse>

addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)

function addFaceFromStream(faceListId: string, image: HttpRequestBody, options: FaceListAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)

Параметры

faceListId

string

Идентификатор, ссылающийся на конкретный список лиц.

image
HttpRequestBody

Поток изображений.

options
FaceListAddFaceFromStreamOptionalParams

Необязательные параметры

callback

ServiceCallback<PersistedFace>

Обратный вызов

addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)

function addFaceFromStream(faceListId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)

Параметры

faceListId

string

Идентификатор, ссылающийся на конкретный список лиц.

image
HttpRequestBody

Поток изображений.

callback

ServiceCallback<PersistedFace>

Обратный вызов

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-адрес изображения

options
FaceListAddFaceFromUrlOptionalParams

Необязательные параметры

Возвращаемое значение

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-адрес изображения

options
FaceListAddFaceFromUrlOptionalParams

Необязательные параметры

callback

ServiceCallback<PersistedFace>

Обратный вызов

addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)

function addFaceFromUrl(faceListId: string, url: string, callback: ServiceCallback<PersistedFace>)

Параметры

faceListId

string

Идентификатор, ссылающийся на конкретный список лиц.

url

string

Общедоступный URL-адрес изображения

callback

ServiceCallback<PersistedFace>

Обратный вызов

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<Models.FaceListGetResponse>

get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)

function get(faceListId: string, options: FaceListGetOptionalParams, callback: ServiceCallback<FaceList>)

Параметры

faceListId

string

Идентификатор, ссылающийся на конкретный список лиц.

options
FaceListGetOptionalParams

Необязательные параметры

callback

ServiceCallback<FaceList>

Обратный вызов

get(string, ServiceCallback<FaceList>)

function get(faceListId: string, callback: ServiceCallback<FaceList>)

Параметры

faceListId

string

Идентификатор, ссылающийся на конкретный список лиц.

callback

ServiceCallback<FaceList>

Обратный вызов

list(FaceListListOptionalParams)

List faceListId, name, userData и recognitionModel списков лиц.
Чтобы получить сведения о лицах внутри faceList, используйте FaceList — Get

function list(options?: FaceListListOptionalParams): Promise<FaceListListResponse>

Параметры

options
FaceListListOptionalParams

Необязательные параметры

Возвращаемое значение

Promise<Models.FaceListListResponse>

list(FaceListListOptionalParams, ServiceCallback<FaceList[]>)

function list(options: FaceListListOptionalParams, callback: ServiceCallback<FaceList[]>)

Параметры

options
FaceListListOptionalParams

Необязательные параметры

callback

ServiceCallback<FaceList[]>

Обратный вызов

list(ServiceCallback<FaceList[]>)

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

Параметры

callback

ServiceCallback<FaceList[]>

Обратный вызов

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>

Обратный вызов