חדש: LiteRT: זמן הריצה המתקדם של Google ל-AI במכשיר, שנקרא בעבר TensorFlow Lite.

דף זה תורגם על ידי Cloud Translation API.

GestureRecognizer

מחלקה סופית ציבורית GestureRecognizer

משמש לזיהוי תנועה בתמונות.

ה-API הזה מצפה לחבילת נכסים של מודל תנועות ידיים שהוכשרה מראש, או חבילה בהתאמה אישית שנוצרה באמצעות Model Maker. .

הזנת תמונה MPImage
- התמונה שעליה מופעל זיהוי התנועה.
תוצאה של זיהוי תנועות לפלט GestureRecognizerResult
- תוצאה של זיהוי תנועה שמכילה ציוני דרך של ידיים ותנועות ידיים מזוהות.

מחלקות מקננות

מחלקה GestureRecognizer.GestureRecognizerOptions אפשרויות להגדרת GestureRecognizer.

שיטות ציבוריות

סטטי GestureRecognizer	createFromBuffer(הקשר הקשר, ByteBuffer modelBuffer) יצירת מכונה של `GestureRecognizer` ממאגר נתונים זמני של מודל וברירת המחדל `GestureRecognizer.GestureRecognizerOptions`.
סטטי GestureRecognizer	createFromFile(Context context, String modelPath) יצירת מכונת `GestureRecognizer` מקובץ מודל וברירת המחדל `GestureRecognizer.GestureRecognizerOptions`.
סטטי GestureRecognizer	createFromFile(הקשר Context, File modelFile) יצירת מכונת `GestureRecognizer` מקובץ מודל וברירת המחדל `GestureRecognizer.GestureRecognizerOptions`.
סטטי GestureRecognizer	createFromOptions(הקשר Context, GestureRecognizer.GestureRecognizerOptions דוח אפשרויות) יצירת מכונה של `GestureRecognizer` מ-`GestureRecognizer.GestureRecognizerOptions`.
GestureRecognizerResult	recognize(תמונת MPImage) זיהוי תנועה בתמונה הבודדת שסופקה, עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
GestureRecognizerResult	recognize(MPImage image, ImageProcessingOptions imageProcessingOptions) משמש לזיהוי תנועה בתמונה הבודדת שסופקה.
void	recognizeAsync(תמונה מסוג MPImage, long timestampMs) שליחה של נתוני תמונה בזמן אמת כדי לבצע זיהוי תנועה עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
void	recognizeAsync(תמונה מסוג MPImage, ImageProcessingOptions imageprocessingOptions, חותמת זמן ארוכה) נשלחים נתוני תמונה בזמן אמת כדי לבצע זיהוי תנועה, והתוצאות יהיו זמינות דרך `OutputHandler.ResultListener` שסופק ב`GestureRecognizer.GestureRecognizerOptions`.
GestureRecognizerResult	recognizeForVideo(תמונה מסוג MPImage, long timestampMs) זיהוי תנועה בפריים הווידאו שסופק עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר
GestureRecognizerResult	recognizeForVideo(תמונת MPImage, ImageProcessingOptions imageprocessingOptions, חותמת זמן ארוכה) זיהוי תנועה בפריים המוצג בסרטון.

שיטות שעברו בירושה

מכיתה com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() סוגר ומנקה את משימת הראייה של MediaPipe.
סטטי ארוך	generateResultTimestampMs(RunningMode runningMode, Packet packet) חותמת הזמן של אובייקט תוצאת משימה של ראייה ממצב ריצה של משימת ראייה ומחבילת הפלט.

מהכיתה Java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
בטל סופי	notify()
בטל סופי	notifyAll()
String	toString()
בטל סופי	wait(long arg0, int arg1)
בטל סופי	wait(long arg0)
בטל סופי	wait()

מהממשק Java.lang.AutoCloseable

מופשט בטל

close()

שיטות ציבוריות

ציבורי סטטי GestureRecognizer createFromBuffer (הקשר הקשר, ByteBuffer modelBuffer)

יצירת מכונה של GestureRecognizer ממאגר נתונים זמני של מודל וברירת המחדל GestureRecognizer.GestureRecognizerOptions.

פרמטרים

context	`ERROR(/Context)` של Android.
modelBuffer	`ByteBuffer` או `ERROR(/MappedByteBuffer)` ישירות של מודל הזיהוי.

קליעות

	אם יש שגיאה במהלך היצירה של `GestureRecognizer`.

ציבורי סטטי GestureRecognizer createFromFile (Contextcontext, String modelPath)

יצירת מכונת GestureRecognizer מקובץ מודל וברירת המחדל GestureRecognizer.GestureRecognizerOptions.

פרמטרים

context	`ERROR(/Context)` של Android.
modelPath	נתיב למודל זיהוי התנועה עם מטא-נתונים בנכסים.

קליעות

	אם יש שגיאה במהלך היצירה של `GestureRecognizer`.

ציבורי סטטי GestureRecognizer createFromFile (Contextcontext, File modelFile)

יצירת מכונת GestureRecognizer מקובץ מודל וברירת המחדל GestureRecognizer.GestureRecognizerOptions.

פרמטרים

context	`ERROR(/Context)` של Android.
modelFile	במופע של מודל זיהוי התנועה `File`.

קליעות

IOException	אם מתרחשת שגיאת קלט/פלט בזמן פתיחה של קובץ מודל ה-tflite.
	אם יש שגיאה במהלך היצירה של `GestureRecognizer`.

ציבורי סטטי GestureRecognizer createFromOptions (הקשר הקשר, GestureRecognizer.GestureRecognizerOptionsOgnizerOptions IdentificationrOptions)

יצירת מכונה של GestureRecognizer מ-GestureRecognizer.GestureRecognizerOptions.

פרמטרים

context	`ERROR(/Context)` של Android.
recognizerOptions	מופע של `GestureRecognizer.GestureRecognizerOptions`.

קליעות

	אם יש שגיאה במהלך היצירה של `GestureRecognizer`.

Public GestureRecognizerResult recognize (MPImage)

זיהוי תנועה בתמונה הבודדת שסופקה, עם אפשרויות ברירת מחדל לעיבוד התמונה, כלומר ללא סיבוב. יש להשתמש בשיטה הזו רק אם ה-GestureRecognizer נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפי פורמט קלט תמונה.

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.

קליעות

	אם אירעה שגיאה פנימית.

Public GestureRecognizerResult recognize (MPImage image, ImageProcessingOptions image ProcessingOptions)

משמש לזיהוי תנועה בתמונה הבודדת שסופקה. יש להשתמש בשיטה הזו רק אם ה-GestureRecognizer נוצר באמצעות ERROR(/RunningMode.IMAGE). TODO עדכן מסמך Java לפי פורמט קלט תמונה.

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.
imageProcessingOptions	`ImageProcessingOptions` שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך `ImageProcessingOptions.regionOfInterest()` יגרום ל-method הזה לגרום לחריגת invalidArgument.

קליעות

IllegalArgumentException	אם השדה `ImageProcessingOptions` מציין אזור עניין.
	אם אירעה שגיאה פנימית.

public void recognizeAsync (MPImage image, long timestampMs)

שליחת נתוני תמונה בזמן אמת לביצוע זיהוי תנועה עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל. כלומר, ללא סיבוב, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שמוקצה בGestureRecognizer.GestureRecognizerOptions. יש להשתמש בשיטה הזו רק כשהשדה ERROR(/GestureRecognition) נוצר באמצעות ERROR(/RunningMode.LIVE_STREAM).

צריך לספק חותמת זמן (באלפיות שנייה) כדי לציין מתי תמונת הקלט נשלחת למזהה התנועות. חותמות הזמן של הקלט צריכות להיות במגמת עלייה מונוטונית.

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.
timestampMs	את חותמת הזמן של הקלט (באלפיות שנייה).

קליעות

	אם אירעה שגיאה פנימית.

public void recognizeAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

נשלחים נתוני תמונה בזמן אמת כדי לבצע זיהוי תנועה, והתוצאות יהיו זמינות דרך OutputHandler.ResultListener שסופק בGestureRecognizer.GestureRecognizerOptions. יש להשתמש בשיטה הזו רק כשהשדה ERROR(/GestureRecognition) נוצר באמצעות ERROR(/RunningMode.LIVE_STREAM).

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.
imageProcessingOptions	`ImageProcessingOptions` שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך `ImageProcessingOptions.regionOfInterest()` יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs	את חותמת הזמן של הקלט (באלפיות שנייה).

קליעות

IllegalArgumentException	אם השדה `ImageProcessingOptions` מציין אזור עניין.
	אם אירעה שגיאה פנימית.

Public GestureRecognizerResult recognizeForVideo (MPImage image, long timestampMs)

זיהוי תנועה בפריים הווידאו שסופק, עם אפשרויות עיבוד התמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב. יש להשתמש בשיטה הזו רק אם השדה GestureRecognizer נוצר באמצעות ERROR(/RunningMode.VIDEO).

ההרשאה נדרשת לספק את חותמת הזמן של הפריים בסרטון (באלפיות השנייה). חותמות הזמן של הקלט צריכות לעלות באופן מונוטוני.

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.
timestampMs	את חותמת הזמן של הקלט (באלפיות שנייה).

קליעות

	אם אירעה שגיאה פנימית.

Public GestureRecognizerResult recognizeForVideo (MPImage image, ImageProcessingOptions imageאפשרויות, חותמת זמן ארוכה m)

זיהוי תנועה בפריים המוצג בסרטון. יש להשתמש בשיטה הזו רק אם ה-GestureRecognizer נוצר באמצעות ERROR(/RunningMode.VIDEO).

ב-GestureRecognizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

ERROR(/Bitmap.Config.ARGB_8888)

פרמטרים

תמונה	אובייקט `MPImage` MediaPipe לעיבוד.
imageProcessingOptions	`ImageProcessingOptions` שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך `ImageProcessingOptions.regionOfInterest()` יגרום ל-method הזה לגרום לחריגת invalidArgument.
timestampMs	את חותמת הזמן של הקלט (באלפיות שנייה).

קליעות

IllegalArgumentException	אם השדה `ImageProcessingOptions` מציין אזור עניין.
	אם אירעה שגיאה פנימית.