التعرف على الإيماءات على الصور.
وتتوقّع واجهة برمجة التطبيقات هذه توفُّر حزمة مواد عرض لنموذج إيماءات اليد المدرّبة مسبقًا أو حزمة مواد عرض مخصّصة يتم إنشاؤها باستخدام "مصمم النماذج". راجع
- إدخال صورة
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 | |
| 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 تحدّد
منطقة الاهتمام. |
|---|---|
| في حال حدوث خطأ داخلي. |