MLKitFaceDetection 架構參考資料

MLKFaceDetectorOptions


@interface MLKFaceDetectorOptions : NSObject

指定臉部偵測工具的選項。

  • 用於將屬性分類 (例如笑臉) 的臉部偵測工具分類模式。預設值為 .none。

    聲明

    Objective-C

    @property (nonatomic) MLKFaceDetectorClassificationMode classificationMode;

  • 臉部偵測工具效能模式，決定結果的準確度和偵測速度。預設為 .fast。

    聲明

    Objective-C

    @property (nonatomic) MLKFaceDetectorPerformanceMode performanceMode;

  • 臉部偵測工具地標模式，用於判定偵測作業傳回的地標結果類型。預設為 .none。

    聲明

    Objective-C

    @property (nonatomic) MLKFaceDetectorLandmarkMode landmarkMode;

  • 臉部偵測工具輪廓模式，決定偵測作業傳回的輪廓結果類型。 預設為 .none。

    將這個模式設為 .all 時，系統會傳回以下偵測結果：

    performanceMode 設為 .fast，且 classificationMode 和 landmarkMode 都設為 .none，則系統在偵測到輪廓的範圍內只會傳回醒目的臉孔。

    如果 performanceMode 設為 .accurate，或將 classificationMode 或 landmarkMode 設為 .all，系統就會傳回所有偵測到的臉孔，但只有顯眼的臉孔才會偵測到輪廓。

    聲明

    Objective-C

    @property (nonatomic) MLKFaceDetectorContourMode contourMode;

  • 所需的最小臉孔尺寸。尺寸會以頭部寬度與圖片寬度的比例表示。舉例來說，如果指定的值為 0.1，則要搜尋的最小表面約為搜尋圖片寬度的 10%。預設值為 0.1。這個選項不適用於輪廓偵測。

    聲明

    Objective-C

    @property (nonatomic) CGFloat minFaceSize;

  • 是否啟用臉部偵測功能的臉部追蹤功能。預設值為「否」。當 performanceMode 設為 .fast，且 classificationMode 和 landmarkMode 都設為 .none 時，系統就會忽略這個選項並停用追蹤。

    聲明

    Objective-C

    @property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=isTrackingEnabled) BOOL trackingEnabled;