FaceLandmarker

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

זיהוי של ציוני פנים בתמונות.

ה-API הזה מצפה לחבילת נכסים של מודל ציוני דרך שעברו אימון מראש. .

  • הזנת תמונה MPImage
    • התמונה שעליה פועל זיהוי הפנים של ציוני דרך.
  • פלט FaceLandmarkerResult
    • תוצאה של סמן פנים שמכילה ציוני דרך של פנים.

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

מחלקה FaceLandmarker.FaceLandmarkerOptions אפשרויות להגדרת FaceLandmarker. 

שדות

Public סטטי סופי Set<Connection> FACE_LANDMARKS_CONNECTORS
Public סטטי סופי Set<Connection> FACE_LANDMARKS_FACE_OVAL
Public סטטי סופי Set<Connection> FACE_LANDMARKS_LEFT_EYE
Public סטטי סופי Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
Public סטטי סופי Set<Connection> FACE_LANDMARKS_LEFT_IRIS
Public סטטי סופי Set<Connection> FACE_LANDMARKS_LIPS
Public סטטי סופי Set<Connection> FACE_LANDMARKS_RIGHT_EYE
Public סטטי סופי Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
Public סטטי סופי Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
Public סטטי סופי Set<Connection> FACE_LANDMARKS_TESSELATION

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

סטטי FaceLandmarker
createFromBuffer(הקשר הקשר, ByteBuffer modelAssetBuffer)
יצירת מכונה של FaceLandmarker ממאגר נתונים זמני של חבילת נכסים של מודל ומברירת המחדל FaceLandmarker.FaceLandmarkerOptions.
סטטי FaceLandmarker
createFromFile(הקשר הקשר, String modelAssetPath)
הפונקציה יוצרת מופע של FaceLandmarker מנתיב של חבילת נכס לדוגמה ומברירת המחדל של FaceLandmarker.FaceLandmarkerOptions.
סטטי FaceLandmarker
createFromFile(הקשר הקשר, File modelAssetFile)
יצירת מכונה של FaceLandmarker מקובץ חבילת נכסים של מודל ומברירת המחדל של FaceLandmarker.FaceLandmarkerOptions.
סטטי FaceLandmarker
createFromOptions(הקשר הקשר, FaceLandmarker.FaceLandmarkerOptions ציון דרך)
יצירת מכונה של FaceLandmarker מ-FaceLandmarker.FaceLandmarkerOptions.
FaceLandmarkerResult
detect(תמונת MPImage)
התכונה מבצעת זיהוי של ציוני פנים בתמונה הבודדת, עם אפשרויות ברירת מחדל לעיבוד תמונה, כלומר
FaceLandmarkerResult
detect(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions)
ביצוע זיהוי של ציוני פנים בתמונה הבודדת שסופקה.
void
detectAsync(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
נשלחים נתוני תמונה בזמן אמת כדי לבצע זיהוי של ציוני פנים, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener בFaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(תמונת MPImage, long timestampMs)
נשלחים נתוני תמונה בזמן אמת כדי לבצע זיהוי של ציוני פנים באמצעות אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר
FaceLandmarkerResult
detectForVideo(תמונה מסוג MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)
זיהוי ציוני פנים בפריים שסופק.
FaceLandmarkerResult
detectForVideo(תמונת MPImage, long timestampMs)
הפונקציה מבצעת זיהוי של ציוני פנים בפריים הווידאו שסופק עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר

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

שדות

ציבורי סטטי סופי Set<Connection> FACE_LANDMARKS_CONNECTORS

ציבורי סטטי סופי Set<Connection> FACE_LANDMARKS_FACE_OVAL

ציבורי סטטי סופי הגדרה<חיבור> FACE_LANDMARKS_LEFT_EYE

ציבורי סטטי סופי Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW

ציבורי סטטי סופי הגדרה<חיבור> FACE_LANDMARKS_LEFT_IRIS

ציבורי סטטי סופי הגדרה<חיבור> FACE_LANDMARKS_LIPS

ציבורי סטטי סופי הגדרה<חיבור> FACE_LANDMARKS_RIGHT_EYE

ציבורי סטטי סופי Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW

ציבורי סטטי סופי הגדרה<חיבור> FACE_LANDMARKS_RIGHT_IRIS

ציבורי סטטי סופי Set<Connection> FACE_LANDMARKS_TESSELATION

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

ציבורי סטטי FaceLandmarker createFromBuffer (הקשר הקשר, ByteBuffer modelAssetBuffer)

יצירת מכונה של FaceLandmarker ממאגר נתונים זמני של חבילת נכסים של מודל ומברירת המחדל FaceLandmarker.FaceLandmarkerOptions.

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

ציבורי סטטי FaceLandmarker createFromFile (הקשר הקשר, מחרוזת modelAssetPath)

הפונקציה יוצרת מופע של FaceLandmarker מנתיב של חבילת נכס לדוגמה ומברירת המחדל של FaceLandmarker.FaceLandmarkerOptions.

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

ציבורי סטטי FaceLandmarker createFromFile (הקשר הקשר, קובץ modelAssetFile)

יצירת מכונה של FaceLandmarker מקובץ חבילת נכסים של מודל ומברירת המחדל של FaceLandmarker.FaceLandmarkerOptions.

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

ציבורי סטטי FaceLandmarker createFromOptions (הקשר הקשר, FaceLandmarker.FaceLandmarkerOptions landmarkerOptions)

יצירת מכונה של FaceLandmarker מ-FaceLandmarker.FaceLandmarkerOptions.

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

ציבורי FaceLandmarkerResult detect (תמונה MPImage)

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

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

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

Public FaceLandmarkerResult detect (MPImage image, ImageProcessingOptions image ProcessingOptions)

ביצוע זיהוי של ציוני פנים בתמונה הבודדת שסופקה. יש להשתמש בשיטה הזו רק כשהשדה FaceLandmarker נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפורמט קלט תמונה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Public FaceLandmarkerResult detectForVideo (MPImage image, long timestampMs)

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

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

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

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