FaceLandmarker

الصف النهائي المتاح للجميع FaceLandmarker

ترصد هذه الميزة معالم الوجوه في الصور.

تتوقّع واجهة برمجة التطبيقات هذه توفُّر حزمة مواد عرض لنموذج معالم مصنَّفة حسب الوجه تم تدريبها مسبقًا. راجع .

  • إدخال صورة MPImage
    • يتم تفعيل الصورة التي يتم فيها التعرّف على المعالم على الوجه.
  • الناتج FaceLandmarkerResult
    • نتيجة FaceLandMarkResult تحتوي على معالم الوجه.

الصفوف المتداخلة

صنف FaceLandmarker.FaceLandmarkerOptions خيارات إعداد "FaceLandmarker" 

الحقول

public static last Set<Connection> FACE_LANDMARKS_CONNECTORS
public static last Set<Connection> FACE_LANDMARKS_FACE_OVAL
public static last Set<Connection> FACE_LANDMARKS_LEFT_EYE
public static last Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
public static last Set<Connection> FACE_LANDMARKS_LEFT_IRIS
public static last Set<Connection> FACE_LANDMARKS_LIPS
public static last Set<Connection> FACE_LANDMARKS_RIGHT_EYE
public static last Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
public static last Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
public static last 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 image, ImageProcessingOptions imageProcessingOptions)
يتم رصد معالم الوجه في الصورة المفردة المقدّمة.
void
detectAsync(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
يرسل بيانات صور مباشرة لرصد معالم الوجوه، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المقدَّمة في FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(صورة MPImage، الطوابع الزمنية الطويلة)
يرسل بيانات صور مباشرة لرصد معالم الوجوه باستخدام خيارات معالجة الصور التلقائية، مثل
FaceLandmarkerResult
detectForVideo(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
ترصد هذه الميزة معالم الوجه في إطار الفيديو المقدَّم.
FaceLandmarkerResult
detectForVideo(صورة MPImage، الطوابع الزمنية الطويلة)
ترصد هذه الميزة معالم الوجه في إطار الفيديو المقدّم من خلال خيارات معالجة الصور التلقائية، أي

الطرق المكتسَبة

الحقول

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_CONNECTORS

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_FACE_OVAL

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_LEFT_EYE

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_LEFT_EYE_BROW

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_LEFT_IRIS

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_LIPS

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_RIGHT_EYE

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_RIGHT_EYE_BROW

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_RIGHT_IRIS

علني ثابت نهائي ضبط<التواصل> FACE_LANDMARKS_TESSELATION

الطرق العامة

public static FaceLandmarker createFromBuffer (سياق السياق، ByteBuffer modelAssetBuffer)

تنشئ هذه الدالة FaceLandmarker مثيلاً من مخزن مؤقت لحزمة مواد عرض نموذجية والقيمة التلقائية FaceLandmarker.FaceLandmarkerOptions.

المَعلمات
سياق جهاز Android ERROR(/Context)
modelAssetBuffer
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceLandmarker".

public static FaceLandmarker createFromFile (سياق السياق، سلسلة formAssetPath)

تنشئ هذه الدالة FaceLandmarker مثيلاً من مسار حزمة مواد عرض النموذج والقيمة التلقائية FaceLandmarker.FaceLandmarkerOptions.

المَعلمات
سياق جهاز Android ERROR(/Context)
modelAssetPath إلى نموذج معالم الوجه مع بيانات التعريف في مواد العرض.
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceLandmarker".

public static FaceLandmarker createFromFile (سياق السياق، ملف formAssetFile)

تنشئ هذه الدالة FaceLandmarker مثيلاً من ملف حِزمة مواد عرض نموذجية والقيمة التلقائية FaceLandmarker.FaceLandmarkerOptions.

المَعلمات
سياق جهاز Android ERROR(/Context)
modelAssetFile مثال على نموذج معالم الوجه File.
الرميات
IOException في حال حدوث خطأ في وحدات الإدخال والإخراج عند فتح ملف نموذج tflite.
في حال حدوث خطأ أثناء إنشاء "FaceLandmarker".

public static FaceLandmarker createFromOptions (سياق السياق، FaceLandmarker.FaceLandmarkerOptions خيارات

تنشئ هذه الدالة FaceLandmarker مثيلاً من FaceLandmarker.FaceLandmarkerOptions.

المَعلمات
سياق جهاز Android ERROR(/Context)
landmarkerOptions مثيل FaceLandmarker.FaceLandmarkerOptions.
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceLandmarker".

public FaceLandmarkerResult detect (MPImage صورة)

يتم رصد معالم الوجه على الصورة المفردة المقدّمة باستخدام خيارات معالجة الصور التلقائية، أي بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker من خلال ERROR(/RunningMode.IMAGE). TODO تحديث مستند جافا لتنسيق إدخال الصورة.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
الرميات
في حال حدوث خطأ داخلي.

عامة FaceLandmarkerResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)

يتم رصد معالم الوجه في الصورة المفردة المقدّمة. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker باستخدام ERROR(/RunningMode.IMAGE). TODO تحديث مستند جافا لتنسيق إدخال الصورة.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
imageProcessingOptions ImageProcessingOptions التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية.
الرميات
IllegalArgumentException إذا كانت السمة ImageProcessingOptions تحدّد منطقة الاهتمام.
في حال حدوث خطأ داخلي.

متاح للجميع إبطال detectAsync (صورة MPImage، ImageProcessingOptions imageProcessingOptions، طوابع زمنية طويلة)

يرسل بيانات صور مباشرة لرصد معالم الوجوه، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المقدَّمة في FaceLandmarker.FaceLandmarkerOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker من خلال ERROR(/RunningMode.LIVE_STREAM).

يجب توفير طابع زمني (بالمللي ثانية) للإشارة إلى وقت إرسال صورة الإدخال إلى معلم الوجه. يجب أن تكون الطوابع الزمنية للإدخال تزيد بشكل منتظم.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
imageProcessingOptions ImageProcessingOptions التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية.
timestampMs الطابع الزمني للإدخال (بالمللي ثانية).
الرميات
IllegalArgumentException إذا كانت السمة ImageProcessingOptions تحدّد منطقة الاهتمام.
في حال حدوث خطأ داخلي.

public إبطال detectAsync (صورةMPImage، طوابع زمنية طويلة)

يرسل بيانات صور مباشرة لرصد معالم الوجوه باستخدام خيارات معالجة الصور التلقائية، أي بدون تطبيق أي تدوير، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المتوفّرة في FaceLandmarker.FaceLandmarkerOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker باستخدام ERROR(/RunningMode.LIVE_STREAM).

يجب توفير طابع زمني (بالمللي ثانية) للإشارة إلى وقت إرسال صورة الإدخال إلى معلم الوجه. يجب أن تكون الطوابع الزمنية للإدخال تزيد بشكل منتظم.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
timestampMs الطابع الزمني للإدخال (بالمللي ثانية).
الرميات
في حال حدوث خطأ داخلي.

عامة FaceLandmarkerResult detectForVideo (MPImage صورة، ImageProcessingOptions imageProcessingOptions, timestampMs طويل)

ترصد هذه الميزة معالم الوجه في إطار الفيديو المقدَّم. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker باستخدام ERROR(/RunningMode.VIDEO).

يجب تقديم الطابع الزمني لإطار الفيديو (بالمللي ثانية). يجب أن تكون الطوابع الزمنية للإدخالات متزايدة بشكل منتظم.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
imageProcessingOptions ImageProcessingOptions التي تحدِّد كيفية معالجة الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية.
timestampMs الطابع الزمني للإدخال (بالمللي ثانية).
الرميات
IllegalArgumentException إذا كانت السمة ImageProcessingOptions تحدّد منطقة الاهتمام.
في حال حدوث خطأ داخلي.

public FaceLandmarkerResult detectForVideo (صورةMPImage)، طوابع زمنية طويلة

ترصد هذه الميزة معالم الوجه في إطار الفيديو المقدّم من خلال خيارات معالجة الصور التلقائية، أي بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceLandmarker من خلال ERROR(/RunningMode.VIDEO).

يجب تقديم الطابع الزمني لإطار الفيديو (بالمللي ثانية). يجب أن تكون الطوابع الزمنية للإدخالات متزايدة بشكل منتظم.

يتيح FaceLandmarker استخدام أنواع مساحات الألوان التالية:

المَعلمات
صورة كائن MediaPipe MPImage للمعالجة.
timestampMs الطابع الزمني للإدخال (بالمللي ثانية).
الرميات
في حال حدوث خطأ داخلي.