HandLandmarker

الصف النهائي العلني HandLandmarker

تكشف هذه الأداة عن معالم الصور يدويًا.

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

  • إدخال صورة MPImage
    • الصورة التي يتم فيها تفعيل ميزة "رصد المعالم" باليد.
  • نتيجة مؤشر الإخراج HandLandmarkerResult
    • نتيجة مؤشر قائمة اليد تحتوي على معالم على شكل يد.

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

صنف HandLandmarker.HandLandmarkerOptions خيارات إعداد "HandLandmarker" 

الحقول

public static last Set<Connection> HAND_CONNECTIONS
public static last Set<Connection> HAND_INDEX_FINGER_CONNECTIONS
public static last Set<Connection> HAND_MIDDLE_FINGER_CONNECTIONS
public static last Set<Connection> HAND_PALM_CONNECTIONS
public static last Set<Connection> HAND_PINKY_FINGER_CONNECTIONS
public static last Set<Connection> HAND_RING_FINGER_CONNECTIONS
public static last Set<Connection> HAND_THUMB_CONNECTIONS

الطرق العامة

ثابت HandLandmarker
createFromBuffer(سياق السياق، ByteBuffer modelBuffer)
تنشئ هذه الدالة HandLandmarker من مخزن بيانات مؤقّت نموذج والقيمة التلقائية HandLandmarker.HandLandmarkerOptions.
ثابت HandLandmarker
createFromFile(سياق السياق، مسار نموذج سلسلة)
تنشئ هذه الدالة مثيل HandLandmarker من ملف نموذج وقيمة HandLandmarker.HandLandmarkerOptions التلقائية.
ثابت HandLandmarker
createFromFile(سياق السياق، File modelFile)
تنشئ هذه الدالة مثيل HandLandmarker من ملف نموذج وقيمة HandLandmarker.HandLandmarkerOptions التلقائية.
ثابت HandLandmarker
createFromOptions(سياق السياق، HandLandmarker.HandLandmarkerOptions خيارات مَعلمة)
تنشئ هذه الدالة HandLandmarker مثيلاً من HandLandmarker.HandLandmarkerOptions.
HandLandmarkerResult
detect(صورة MPImage)
تُجري رصد معالم اليد على الصورة الواحدة المقدّمة باستخدام خيارات معالجة الصور التلقائية، أي
HandLandmarkerResult
detect(MPImage image, ImageProcessingOptions imageProcessingOptions)
يتم رصد المعالم يدويًا على الصورة المفردة المقدّمة.
void
detectAsync(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
يرسل بيانات صور مباشرة لرصد معالم اليد، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المقدَّمة في HandLandmarker.HandLandmarkerOptions.
void
detectAsync(صورة MPImage، الطوابع الزمنية الطويلة)
يرسل بيانات صور مباشرة لرصد معالم اليد من خلال خيارات معالجة الصور التلقائية، مثل
HandLandmarkerResult
detectForVideo(صورة MPImage، وImageProcessingOptions خيارات معالجة الصورة، خيارات الطوابع الزمنية الطويلة)
ترصد هذه الميزة المَعالم باليد في إطار الفيديو المتوفّر.
HandLandmarkerResult
detectForVideo(صورة MPImage، الطوابع الزمنية الطويلة)
تُجري عمليات رصد معالم اليد على إطار الفيديو المقدَّم مع خيارات معالجة الصور التلقائية، أي

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

الحقول

public static last Set<Connection> HAND_CONNECTIONS

نهائي ثابت عام ضبط<الاتصال> HAND_INDEX_FINGER_CONNECTIONS

عامة ثابتة نهائية ضبط<الاتصال> HAND_MIDDLE_FINGER_CONNECTIONS

public static last Set<Connection> HAND_PALM_CONNECTIONS

public static last ضبط<Connection> HAND_PINKY_FINGER_CONNECTIONS

public static last Set<Connection> HAND_RING_FINGER_CONNECTIONS

public static last Set<Connection> HAND_THUMB_CONNECTIONS

الطرق العامة

public static HandLandmarker createFromBuffer (سياق السياق، ByteBuffer modelBuffer)

تنشئ هذه الدالة HandLandmarker من مخزن بيانات مؤقّت نموذج والقيمة التلقائية HandLandmarker.HandLandmarkerOptions.

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

public static HandLandmarker createFromFile (سياق السياق، سلسلة نموذج مسار)

تنشئ هذه الدالة مثيل HandLandmarker من ملف نموذج وقيمة HandLandmarker.HandLandmarkerOptions التلقائية.

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

عام ثابت HandLandmarker createFromFile (سياق السياق، ملف formFile)

تنشئ هذه الدالة مثيل HandLandmarker من ملف نموذج وقيمة HandLandmarker.HandLandmarkerOptions التلقائية.

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

عامة ثابتة HandLandmarker createFromOptions (سياق السياق، HandLandmarker.HandLandmarkerOptions

تنشئ هذه الدالة HandLandmarker مثيلاً من HandLandmarker.HandLandmarkerOptions.

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

Public HandLandmarkerResult detect (صورة MPImage)

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

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

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

Public HandLandmarkerResult detect (MPImage image, ImageProcessingOptions imageProcessingOptions)

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

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

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

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

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

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

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

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

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

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

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

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

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

public HandLandmarkerResult detectForVideo (MPImage صورة, ImageProcessingOptions imageProcessingOptions, timestampMs الطويلة)

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

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

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

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

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

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

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

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

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