MLKitObjectDetectionCommon 框架参考

MLKObjectDetector


@interface MLKObjectDetector : NSObject

一种对象检测器和跟踪器，可用于检测图片中的对象并支持跟踪这些对象。

  • 返回采用指定选项的对象检测器。

    声明

    Objective-C

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

    参数

    options

    用于配置对象检测器的选项。它应该是一个 CommonObjectDetectorOptions 的子类。

    返回值

    使用指定选项配置的对象检测器。

  • 不可用。使用类方法。

    声明

    Objective-C

    - (nonnull instancetype)init;

  • 处理指定图片以进行对象检测和跟踪。

    声明

    Objective-C

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

    参数

    image

    要处理的图片。
    completion

    检测到对象或出现错误后，会在主线程上回调的处理程序。

  • 返回指定图片中的对象结果，如果出现错误，则返回 nil。对象检测 在发起调用的线程上同步执行。

    建议在主线程之外调用此方法，以避免阻塞界面。作为 结果，如果在主线程上调用此方法，则会引发 NSException。

    声明

    Objective-C

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

    参数

    image

    要获取结果的图片。
    error

    在获取结果时出错时填充的可选错误参数。

    返回值

    返回给定图片的对象数组，如果出现错误，则返回 nil。