Выполняет распознавание лиц на изображениях.
API ожидает модель TFLite с метаданными модели TFLite. .
- Входное изображение
MPImage- Изображение, на котором работает детектор лиц.
- Вывод FaceDetectorResult
FaceDetectorResult- FaceDetectorResult, содержащий обнаруженные лица.
Вложенные классы
| сорт | FaceDetector.FaceDetectorOptions | Варианты настройки FaceDetector . | |
Публичные методы
| статический FaceDetector | createFromBuffer (контекстный контекст, модель ByteBufferBuffer ) Создает экземпляр FaceDetector из буфера модели и значения FaceDetector.FaceDetectorOptions по умолчанию. |
| статический FaceDetector | createFromFile (контекст контекста, String modelPath) Создает экземпляр FaceDetector из файла модели и значения FaceDetector.FaceDetectorOptions по умолчанию. |
| статический FaceDetector | createFromFile (контекстный контекст, файл модели файла ) Создает экземпляр FaceDetector из файла модели и значения FaceDetector.FaceDetectorOptions по умолчанию. |
| статический FaceDetector | createFromOptions (контекст контекста, FaceDetector.FaceDetectorOptionsDetectorOptions ) Создает экземпляр FaceDetector из FaceDetector.FaceDetectorOptions . |
| FaceDetectorРезультат | обнаружить (изображение MPImage ) Выполняет распознавание лиц на предоставленном одиночном изображении с параметрами обработки изображения по умолчанию, т.е. |
| FaceDetectorРезультат | обнаружить (изображение MPImage , ImageProcessingOptions imageProcessingOptions) Выполняет распознавание лиц на предоставленном одиночном изображении. |
| пустота | обнаружитьAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Отправляет данные живого изображения для обнаружения лиц, и результаты будут доступны через OutputHandler.ResultListener , указанный в FaceDetector.FaceDetectorOptions . |
| пустота | обнаружитьAsync (изображение MPImage , длинные отметки времени) Отправляет данные живого изображения для обнаружения лиц с параметрами обработки изображения по умолчанию, т.е. |
| FaceDetectorРезультат | обнаружитьForVideo (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Выполняет распознавание лиц в предоставленном видеокадре. |
| FaceDetectorРезультат | DetectForVideo (изображение MPImage , длинная временная меткаMs) Выполняет распознавание лиц на предоставленном видеокадре с параметрами обработки изображения по умолчанию, т.е. |
Унаследованные методы
Публичные методы
общедоступный статический FaceDetector createFromBuffer (контекст контекста, ByteBuffer modelBuffer)
Создает экземпляр FaceDetector из буфера модели и значения FaceDetector.FaceDetectorOptions по умолчанию.
Параметры
| контекст | ERROR(/Context) . |
|---|---|
| модельBuffer | прямой ByteBuffer или ERROR(/MappedByteBuffer) модели обнаружения. |
Броски
если при создании FaceDetector произошла ошибка. |
общедоступный статический FaceDetector createFromFile (контекстный контекст, String modelPath)
Создает экземпляр FaceDetector из файла модели и значения FaceDetector.FaceDetectorOptions по умолчанию.
Параметры
| контекст | ERROR(/Context) . |
|---|---|
| модельпуть | путь к модели обнаружения с метаданными в активах. |
Броски
если при создании FaceDetector возникла ошибка. |
public static FaceDetector createFromFile (контекст, файл modelFile)
Создает экземпляр FaceDetector из файла модели и значения FaceDetector.FaceDetectorOptions по умолчанию.
Параметры
| контекст | ERROR(/Context) . |
|---|---|
| МодельФайл | экземпляр File модели обнаружения. |
Броски
| Исключение IO | если при открытии файла модели tflite возникает ошибка ввода-вывода. |
|---|---|
если при создании FaceDetector произошла ошибка. |
общедоступный статический FaceDetector createFromOptions (контекстный контекст, FaceDetector.FaceDetectorOptionsDetectorOptions )
Создает экземпляр FaceDetector из FaceDetector.FaceDetectorOptions .
Параметры
| контекст | ERROR(/Context) . |
|---|---|
| Опции детектора | экземпляр FaceDetector.FaceDetectorOptions . |
Броски
если при создании FaceDetector возникла ошибка. |
общедоступное обнаружение FaceDetectorResult (изображение MPImage )
Выполняет распознавание лиц на предоставленном одиночном изображении с параметрами обработки изображения по умолчанию, т. е. без применения поворота. Используйте этот метод только в том случае, если FaceDetector создан с помощью ERROR(/RunningMode.IMAGE) .
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|
Броски
| если произошла внутренняя ошибка. |
общедоступное обнаружение FaceDetectorResult (изображение MPImage , ImageProcessingOptions imageProcessingOptions)
Выполняет распознавание лиц на предоставленном одиночном изображении. Используйте этот метод только в том случае, если FaceDetector создан с помощью ERROR(/RunningMode.IMAGE) .
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|---|
| Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
Броски
| IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
|---|---|
| если произошла внутренняя ошибка. |
public void defineAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Отправляет данные живого изображения для обнаружения лиц, и результаты будут доступны через OutputHandler.ResultListener , указанный в FaceDetector.FaceDetectorOptions . Используйте этот метод только в том случае, если FaceDetector создан с ERROR(/RunningMode.LIVE_STREAM) .
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в детектор лиц. Входные временные метки должны монотонно возрастать.
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|---|
| Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
| временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
| IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
|---|---|
| если произошла внутренняя ошибка. |
public void defineAsync (изображение MPImage , длинная метка времени)
Отправляет данные живого изображения для обнаружения лиц с параметрами обработки изображения по умолчанию, т. е. без применения поворота, а результаты будут доступны через OutputHandler.ResultListener , указанный в FaceDetector.FaceDetectorOptions . Используйте этот метод только в том случае, если FaceDetector создан с ERROR(/RunningMode.LIVE_STREAM) .
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в детектор лиц. Входные временные метки должны монотонно возрастать.
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|---|
| временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
| если произошла внутренняя ошибка. |
public FaceDetectorResultDetectForVideo ( изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Выполняет распознавание лиц в предоставленном видеокадре. Используйте этот метод только в том случае, если FaceDetector создан с ERROR(/RunningMode.VIDEO) .
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно увеличиваться.
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|---|
| Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
| временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
| IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
|---|---|
| если произошла внутренняя ошибка. |
public FaceDetectorResultDetectForVideo ( изображение MPImage , длинная временная меткаMs)
Выполняет распознавание лиц на предоставленном видеокадре с параметрами обработки изображения по умолчанию, т. е. без применения поворота. Используйте этот метод только в том случае, если FaceDetector создан с ERROR(/RunningMode.VIDEO) .
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно возрастать.
FaceDetector поддерживает следующие типы цветового пространства:
Параметры
| изображение | объект MediaPipe MPImage для обработки. |
|---|---|
| временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
| если произошла внутренняя ошибка. |