MediaPipeTasksVision Framework Reference

MPPObjectDetectorOptions


@interface MPPObjectDetectorOptions : MPPTaskOptions <NSCopying>

Options for setting up a ObjectDetector.

  • Running mode of the object detector task. Defaults to .image. ObjectDetector can be created with one of the following running modes:

    1. .image: The mode for performing object detection on single image inputs.
    2. .video: The mode for performing object detection on the decoded frames of a video.
    3. .liveStream: The mode for performing object detection on a live stream of input data, such as from the camera.

    Declaration

    Objective-C

    @property (nonatomic) MPPRunningMode runningMode;

  • An object that confirms to ObjectDetectorLiveStreamDelegate protocol. This object must implement objectDetector(_:didFinishDetectionWithResult:timestampInMilliseconds:error:) to receive the results of performing asynchronous object detection on images (i.e, when runningMode = .liveStream).

    Declaration

    Objective-C

    @property (nonatomic, weak, nullable) id<MPPObjectDetectorLiveStreamDelegate> objectDetectorLiveStreamDelegate;

  • The locale to use for display names specified through the TFLite Model Metadata, if any. Defaults to English.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull displayNamesLocale;

  • The maximum number of top-scored classification results to return. If < 0, all available results will be returned. If 0, an invalid argument error is returned.

    Declaration

    Objective-C

    @property (nonatomic) NSInteger maxResults;

  • Score threshold to override the one provided in the model metadata (if any). Results below this value are rejected.

    Declaration

    Objective-C

    @property (nonatomic) float scoreThreshold;

  • The allowlist of category names. If non-empty, detection results whose category name is not in this set will be filtered out. Duplicate or unknown category names are ignored. Mutually exclusive with categoryDenylist.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSArray<NSString *> *_Nonnull categoryAllowlist;

  • The denylist of category names. If non-empty, detection results whose category name is in this set will be filtered out. Duplicate or unknown category names are ignored. Mutually exclusive with categoryAllowlist.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSArray<NSString *> *_Nonnull categoryDenylist;