FaceDetector

המחלקה הסופית הציבורית FaceDetector

זיהוי פנים בתמונות.

ה-API מצפה למודל TFLite עם מטא-נתונים של מודל TFLite.

  • הזנת תמונה MPImage
    • התמונה שעליה פועל מזהה הפנים.
  • פלט של פלט זיהוי פנים FaceDetectorResult
    • תוצאה של 'זיהוי פנים' שמכילה פנים שזוהו.

מחלקות מקננות

מחלקה FaceDetector.FaceDetectorOptions האפשרויות להגדרת FaceDetector. 

שיטות ציבוריות

סטטי FaceDetector
createFromBuffer(הקשר הקשר, ByteBuffer modelBuffer)
יצירת מכונה של FaceDetector ממאגר נתונים זמני של מודל וברירת המחדל FaceDetector.FaceDetectorOptions.
סטטי FaceDetector
createFromFile(Context context, String modelPath)
יצירת מכונת FaceDetector מקובץ מודל וברירת המחדל FaceDetector.FaceDetectorOptions.
סטטי FaceDetector
createFromFile(הקשר Context, File modelFile)
יצירת מכונת FaceDetector מקובץ מודל וברירת המחדל FaceDetector.FaceDetectorOptions.
סטטי FaceDetector
createFromOptions(הקשר הקשר, FaceDetector.FaceDetectorOptions מזהה אפשרויות)
יצירת מכונה של FaceDetector מ-FaceDetector.FaceDetectorOptions.
FaceDetectorResult
detect(תמונת MPImage)
זיהוי פנים של התמונה הבודדת שסופקה, עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
FaceDetectorResult
detect(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions)
מבצע זיהוי פנים בתמונה הבודדת שסופקה.
void
detectAsync(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
נשלחים נתוני תמונה בזמן אמת לצורך זיהוי פנים, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener בFaceDetector.FaceDetectorOptions.
void
detectAsync(תמונת MPImage, long timestampMs)
שליחת נתוני תמונה בזמן אמת לביצוע זיהוי פנים עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
FaceDetectorResult
detectForVideo(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
ביצוע זיהוי פנים בפריים הווידאו שסופק.
FaceDetectorResult
detectForVideo(תמונת MPImage, long timestampMs)
זיהוי פנים במסגרת הווידאו שסופקה עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר

שיטות שעברו בירושה

שיטות ציבוריות

ציבורי סטטי FaceDetector createFromBuffer (הקשר הקשר, ByteBuffer modelBuffer)

יצירת מכונה של FaceDetector ממאגר נתונים זמני של מודל וברירת המחדל FaceDetector.FaceDetectorOptions.

פרמטרים
context ERROR(/Context) של Android.
modelBuffer ByteBuffer או ERROR(/MappedByteBuffer) ישירות של מודל הזיהוי.
קליעות
אם יש שגיאה במהלך היצירה של FaceDetector.

ציבורי סטטי, FaceDetector createFromFile (הקשר הקשר, String modelPath)

יצירת מכונת FaceDetector מקובץ מודל וברירת המחדל FaceDetector.FaceDetectorOptions.

פרמטרים
context ERROR(/Context) של Android.
modelPath נתיב למודל הזיהוי עם מטא נתונים בנכסים.
קליעות
אם יש שגיאה במהלך היצירה של FaceDetector.

ציבורי סטטי FaceDetector createFromFile (הקשר הקשר, קובץ modelFile)

יצירת מכונת FaceDetector מקובץ מודל וברירת המחדל FaceDetector.FaceDetectorOptions.

פרמטרים
context ERROR(/Context) של Android.
modelFile במכונה של מודל הזיהוי File.
קליעות
IOException אם מתרחשת שגיאת קלט/פלט בזמן פתיחה של קובץ מודל ה-tflite.
אם יש שגיאה במהלך היצירה של FaceDetector.

ציבורי סטטי FaceDetector createFromOptions (הקשר לפי הקשר, FaceDetector.FaceDetectorOptions DetectorOptions)

יצירת מכונה של FaceDetector מ-FaceDetector.FaceDetectorOptions.

פרמטרים
context ERROR(/Context) של Android.
detectorOptions מופע של FaceDetector.FaceDetectorOptions.
קליעות
אם יש שגיאה במהלך היצירה של FaceDetector.

Public FaceDetectorResult detect (תמונה MPImage)

זיהוי פנים של התמונה הבודדת שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב. יש להשתמש בשיטה הזו רק אם השדה FaceDetector נוצר באמצעות ERROR(/RunningMode.IMAGE).

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
קליעות
אם אירעה שגיאה פנימית.

Public FaceDetectorResult detect (MPImage image, ImageProcessingOptions image ProcessingOptions)

מבצע זיהוי פנים בתמונה הבודדת שסופקה. יש להשתמש בשיטה הזו רק אם ה-FaceDetector נוצר באמצעות ERROR(/RunningMode.IMAGE).

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית.

public void detectAsync (MPImage image, ImageProcessingOptions image ProcessingOptions, long timestampMs)

נשלחים נתוני תמונה בזמן אמת לצורך זיהוי פנים, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener בFaceDetector.FaceDetectorOptions. יש להשתמש בשיטה הזו רק כשה-FaceDetector נוצר עם ERROR(/RunningMode.LIVE_STREAM).

נדרשת חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת לגלאי הפנים. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית.

public void detectAsync (תמונת MPImage, long timestampMs)

שולחת נתוני תמונה בזמן אמת כדי לבצע זיהוי פנים עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל. כלומר, ללא סיבוב, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שמצוינת בFaceDetector.FaceDetectorOptions. יש להשתמש בשיטה הזו רק אם השדה FaceDetector נוצר באמצעות ERROR(/RunningMode.LIVE_STREAM).

נדרשת חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת לגלאי הפנים. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית.

Public FaceDetectorResult detectForVideo (MPImage image, ImageProcessingOptions image ProcessingOptions, long timestampMs)

ביצוע זיהוי פנים בפריים הווידאו שסופק. יש להשתמש בשיטה הזו רק אם ה-FaceDetector נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית.

Public FaceDetectorResult detectForVideo (MPImage image, long timestampMs)

זיהוי פנים במסגרת הווידאו שסופקה, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר ללא הפעלת סיבוב. יש להשתמש בשיטה הזו רק אם השדה FaceDetector נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-FaceDetector יש תמיכה מהסוגים הבאים של מרחבי צבעים:

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
timestampMs את חותמת הזמן של הקלט (באלפיות שנייה).
קליעות
אם אירעה שגיאה פנימית.