חומר עזר בנושא MLKitObjectDetectionCommon Framework

MLKObjectDetector

@interface MLKObjectDetector : NSObject

גלאי אובייקטים וכלי מעקב שמזהים אובייקטים בתמונה ותומך במעקב אחריהם.

• +objectDetectorWithOptions:

  מחזירה גלאי אובייקטים עם האפשרויות הנתונות.

  הצהרה

  Objective-C

  + (nonnull instancetype)objectDetectorWithOptions:
      (nonnull MLKCommonObjectDetectorOptions *)options;

  פרמטרים

  options

  אפשרויות להגדרה של מזהה האובייקטים. היא צריכה להיות מופע של אחת ממחלקות המשנה של CommonObjectDetectorOptions.

  הערך המוחזר

  מזהה אובייקטים שהוגדר עם האפשרויות הנתונות.

• -init

  לא זמינים. משתמשים בשיטות הכיתה.

  הצהרה

  Objective-C

  - (nonnull instancetype)init;

• -processImage:completion:

  מעבד את התמונה הנתונה לצורך זיהוי אובייקטים ומעקב אחר אובייקטים.

  הצהרה

  Objective-C

  - (void)processImage:(nonnull id<MLKCompatibleImage>)image
            completion:(nonnull MLKObjectDetectionCallback)completion;

  פרמטרים

  image	התמונה לעיבוד.
  completion	רכיב ה-handler יכול לבצע קריאה חוזרת ל-thread הראשי עם אובייקטים שזוהו או שגיאות.

• -resultsInImage:error:

  מחזירה תוצאות של אובייקטים בתמונה הנתונה או nil אם הייתה שגיאה. זיהוי האובייקטים מתבצע באופן סינכרוני ב-thread של הקריאה.

  מומלץ לקרוא לשיטה הזו מחוץ ל-thread הראשי כדי להימנע מחסימת הממשק. כתוצאה מכך, יש עלייה בערך NSException אם השיטה הזו מופעלת ב-thread הראשי.

  הצהרה

  Objective-C

  - (nullable NSArray<MLKObject *> *)
      resultsInImage:(nonnull id<MLKCompatibleImage>)image
               error:(NSError *_Nullable *_Nullable)error;

  פרמטרים

  image	התמונה שאליה רוצים לקבל תוצאות.
  error	פרמטר שגיאה אופציונלי מאוכלס במקרה של שגיאה בקבלת תוצאות.

  הערך המוחזר

  מערך של אובייקטים גורם לתמונה הנתונה או ל-nil אם הייתה שגיאה.