تفعيل ميزة "التعرّف على الوجوه" في الصور
نتوقّع في واجهة برمجة التطبيقات استخدام نموذج TFLite مع البيانات الوصفية لنموذج TFLite.
- إدخال صورة
MPImage- الصورة التي تعمل عليها أداة التعرّف على الوجوه.
- نتيجة الإخراج FaceDetectorResult
FaceDetectorResult- نتيجة ميزة FaceDetectorResult تتضمّن الوجوه التي تم رصدها.
الصفوف المتداخلة
| صنف | FaceDetector.FaceDetectorOptions | خيارات إعداد "FaceDetector" |
|
الطرق العامة
| ثابت FaceDetector |
createFromBuffer(سياق السياق، ByteBuffer modelBuffer)
تنشئ هذه الدالة
FaceDetector من مخزن بيانات مؤقّت نموذج والقيمة التلقائية FaceDetector.FaceDetectorOptions. |
| ثابت FaceDetector |
createFromFile(سياق السياق، مسار نموذج سلسلة)
تنشئ هذه الدالة مثيل
FaceDetector من ملف نموذج وقيمة FaceDetector.FaceDetectorOptions التلقائية. |
| ثابت FaceDetector |
createFromFile(سياق السياق، File modelFile)
تنشئ هذه الدالة مثيل
FaceDetector من ملف نموذج وقيمة FaceDetector.FaceDetectorOptions التلقائية. |
| ثابت FaceDetector |
createFromOptions(سياق السياق، FaceDetector.FaceDetectorOptions أمر رصد خيارات)
تنشئ هذه الدالة
FaceDetector مثيلاً من FaceDetector.FaceDetectorOptions. |
| FaceDetectorResult | |
| FaceDetectorResult |
detect(MPImage image, ImageProcessingOptions imageProcessingOptions)
يجري اكتشاف الوجه في الصورة الواحدة المقدّمة.
|
| void |
detectAsync(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
يرسل بيانات صور مباشرة لرصد الوجوه، وستكون النتائج متاحة من خلال
OutputHandler.ResultListener المقدَّمة في FaceDetector.FaceDetectorOptions. |
| void |
detectAsync(صورة MPImage، الطوابع الزمنية الطويلة)
يتم إرسال بيانات الصور المباشرة لرصد الوجوه باستخدام خيارات معالجة الصور التلقائية، أي
|
| FaceDetectorResult |
detectForVideo(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
ترصد هذه الميزة الوجوه في إطار الفيديو المقدَّم.
|
| FaceDetectorResult |
detectForVideo(صورة MPImage، الطوابع الزمنية الطويلة)
يتم التعرّف على الوجه في إطار الفيديو المقدَّم من خلال خيارات معالجة الصور التلقائية، أي
|
الطرق المكتسَبة
الطرق العامة
public static FaceDetector createFromBuffer (سياق السياق، ByteBuffer modelBuffer)
تنشئ هذه الدالة FaceDetector من مخزن بيانات مؤقّت نموذج والقيمة التلقائية FaceDetector.FaceDetectorOptions.
المَعلمات
| سياق | جهاز Android ERROR(/Context) |
|---|---|
| modelBuffer | ByteBuffer أو ERROR(/MappedByteBuffer) لنموذج الرصد. |
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceDetector".
|
public static FaceDetector createFromFile (سياق السياق، سلسلة مسار النموذج)
تنشئ هذه الدالة مثيل FaceDetector من ملف نموذج وقيمة FaceDetector.FaceDetectorOptions التلقائية.
المَعلمات
| سياق | جهاز Android ERROR(/Context) |
|---|---|
| modelPath | إلى نموذج الكشف مع بيانات وصفية في مواد العرض. |
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceDetector".
|
متاح للجميع ثابت FaceDetector createFromFile (سياق السياق، ملف formFile)
تنشئ هذه الدالة مثيل FaceDetector من ملف نموذج وقيمة FaceDetector.FaceDetectorOptions التلقائية.
المَعلمات
| سياق | جهاز Android ERROR(/Context) |
|---|---|
| modelFile | مثيل نموذج الرصد File. |
الرميات
| IOException | في حال حدوث خطأ في وحدات الإدخال والإخراج عند فتح ملف نموذج tflite. |
|---|---|
في حال حدوث خطأ أثناء إنشاء "FaceDetector".
|
متاح للجميع ثابت FaceDetector createFromOptions (سياق السياق، FaceDetector.FaceDetectorOptions أداة رصد الخيارات)
تنشئ هذه الدالة FaceDetector مثيلاً من FaceDetector.FaceDetectorOptions.
المَعلمات
| سياق | جهاز Android ERROR(/Context) |
|---|---|
| detectorOptions | مثيل FaceDetector.FaceDetectorOptions. |
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceDetector".
|
public FaceDetectorResult detect (MPImage صورة)
يتم التعرّف على الوجه في الصورة الواحدة المقدّمة باستخدام خيارات معالجة الصور التلقائية،
أي بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector باستخدام ERROR(/RunningMode.IMAGE).
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|
الرميات
| في حال حدوث خطأ داخلي. |
علني FaceDetectorResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)
يجري اكتشاف الوجه في الصورة الواحدة المقدّمة. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector من خلال ERROR(/RunningMode.IMAGE).
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions التي تحدِّد كيفية معالجة
الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية. |
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
| في حال حدوث خطأ داخلي. |
متاح للجميع إبطال detectAsync (صورة MPImage، ImageProcessingOptions imageProcessingOptions، طوابع زمنية طويلة)
يرسل بيانات صور مباشرة لرصد الوجوه، وستكون النتائج متاحة من خلال
OutputHandler.ResultListener المقدَّمة في FaceDetector.FaceDetectorOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector من خلال ERROR(/RunningMode.LIVE_STREAM).
يجب توفير طابع زمني (بالمللي ثانية) للإشارة إلى وقت إرسال صورة الإدخال إلى أداة رصد الوجوه. يجب أن تكون الطوابع الزمنية للإدخال تزيد بشكل منتظم.
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions التي تحدِّد كيفية معالجة
الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية. |
| timestampMs | الطابع الزمني للإدخال (بالمللي ثانية). |
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
| في حال حدوث خطأ داخلي. |
public إبطال detectAsync (صورةMPImage، طوابع زمنية طويلة)
يرسل بيانات الصور المباشرة لرصد الوجوه باستخدام خيارات معالجة الصور التلقائية، أي
بدون تطبيق أي تدوير، وستكون النتائج متاحة من خلال OutputHandler.ResultListener
المقدّمة في FaceDetector.FaceDetectorOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector
باستخدام ERROR(/RunningMode.LIVE_STREAM).
يجب توفير طابع زمني (بالمللي ثانية) للإشارة إلى وقت إرسال صورة الإدخال إلى أداة رصد الوجوه. يجب أن تكون الطوابع الزمنية للإدخال تزيد بشكل منتظم.
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| timestampMs | الطابع الزمني للإدخال (بالمللي ثانية). |
الرميات
| في حال حدوث خطأ داخلي. |
علنية FaceDetectorResult detectForVideo (MPImage صورة، ImageProcessingOptions imageProcessingOptions, timestampMs)
ترصد هذه الميزة الوجوه في إطار الفيديو المقدَّم. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector من خلال ERROR(/RunningMode.VIDEO).
يجب تقديم الطابع الزمني لإطار الفيديو (بالمللي ثانية). يجب أن تكون الطوابع الزمنية للإدخالات متزايدة بشكل منتظم.
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions التي تحدِّد كيفية معالجة
الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية. |
| timestampMs | الطابع الزمني للإدخال (بالمللي ثانية). |
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
| في حال حدوث خطأ داخلي. |
public FaceDetectorResult detectForVideo (صورةMPImage)، طوابع زمنية طويلة
تعمل هذه الميزة على التعرّف على الوجه في إطار الفيديو المقدَّم من خلال خيارات معالجة الصور التلقائية، أي بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceDetector من خلال ERROR(/RunningMode.VIDEO).
يجب تقديم الطابع الزمني لإطار الفيديو (بالمللي ثانية). يجب أن تكون الطوابع الزمنية للإدخالات متزايدة بشكل منتظم.
يتيح FaceDetector استخدام أنواع مساحات الألوان التالية:
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| timestampMs | الطابع الزمني للإدخال (بالمللي ثانية). |
الرميات
| في حال حدوث خطأ داخلي. |