GestureRecognizer

الفئة النهائية العامة GestureRecognizer

التعرف على الإيماءات على الصور.

وتتوقّع واجهة برمجة التطبيقات هذه توفُّر حزمة مواد عرض لنموذج إيماءات اليد المدرّبة مسبقًا أو حزمة مواد عرض مخصّصة يتم إنشاؤها باستخدام "مصمم النماذج". راجع .

  • إدخال صورة MPImage
    • الصورة التي تعمل ميزة التعرّف على الإيماءات عليها.
  • نتيجة الإخراج الإيماءاتRecognizerResult GestureRecognizerResult
    • نتيجة الإيماءاتRecognizerResult تحتوي على معالم باليد وإيماءات اليد التي تم التعرّف عليها.

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

صنف GestureRecognizer.GestureRecognizerOptions خيارات إعداد "GestureRecognizer

الطرق العامة

ثابت GestureRecognizer
createFromBuffer(سياق السياق، ByteBuffer modelBuffer)
تنشئ هذه الدالة GestureRecognizer من مخزن بيانات مؤقّت نموذج والقيمة التلقائية GestureRecognizer.GestureRecognizerOptions.
ثابت GestureRecognizer
createFromFile(سياق السياق، مسار نموذج سلسلة)
تنشئ هذه الدالة مثيل GestureRecognizer من ملف نموذج وقيمة GestureRecognizer.GestureRecognizerOptions التلقائية.
ثابت GestureRecognizer
createFromFile(سياق السياق، File modelFile)
تنشئ هذه الدالة مثيل GestureRecognizer من ملف نموذج وقيمة GestureRecognizer.GestureRecognizerOptions التلقائية.
ثابت GestureRecognizer
createFromOptions(سياق السياق، GestureRecognizer.GestureRecognizerOptions يعرض خيارات التعرّف على الشاشة)
تنشئ هذه الدالة GestureRecognizer مثيلاً من GestureRecognizer.GestureRecognizerOptions.
GestureRecognizerResult
recognize(صورة MPImage)
يتم التعرّف على الإيماءات على الصورة المفردة المقدّمة باستخدام خيارات معالجة الصور التلقائية، أي
GestureRecognizerResult
recognize(MPImage image, ImageProcessingOptions imageProcessingOptions)
يتم التعرّف على الإيماءات على الصورة المفردة المقدّمة.
void
recognizeAsync(صورة MPImage، الطوابع الزمنية الطويلة)
إرسال بيانات الصورة المباشرة لإجراء التعرّف على الإيماءات باستخدام خيارات معالجة الصور التلقائية، أي
void
recognizeAsync(صورة MPImage، وImageProcessingOptions imageProcessingOptions، الطوابع الزمنية الطويلة)
يرسل بيانات الصور المباشرة للتعرّف على الإيماءات، وستكون النتائج متاحة من خلال OutputHandler.ResultListener المتوفّرة في GestureRecognizer.GestureRecognizerOptions.
GestureRecognizerResult
recognizeForVideo(صورة MPImage، الطوابع الزمنية الطويلة)
يتم التعرّف على الإيماءات في إطار الفيديو المقدَّم باستخدام خيارات معالجة الصور التلقائية، أي
GestureRecognizerResult
recognizeForVideo(صورة MPImage، وImageProcessingOptions imageProcessingOptions، الطوابع الزمنية الطويلة)
التعرف على الإيماءات في إطار الفيديو المقدم.

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

الطرق العامة

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

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

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

public static GestureRecognizer createFromFile (سياق السياق، سلسلة formPath)

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

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

public static GestureRecognizer createFromFile (سياق السياق، ملف formFile)

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

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

متاح للجميع ثابت GestureRecognizer createFromOptions (سياق السياق، GestureRecognizer.GestureRecognizerOptions خيارات التعرّف)

تنشئ هذه الدالة GestureRecognizer مثيلاً من GestureRecognizer.GestureRecognizerOptions.

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

public GestureRecognizerResult recognize (صورة MPImage)

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

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

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

public GestureRecognizerResult recognize (MPImage image, ImageProcessingOptions imageProcessingOptions)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

public GestureRecognizerResult recognizeForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, الطوابع الزمنية الطويلة)

التعرف على الإيماءات في إطار الفيديو المقدم. لا تستخدِم هذه الطريقة إلا عند إنشاء GestureRecognizer من خلال ERROR(/RunningMode.VIDEO).

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

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

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