MLKitPoseDetectionCommon 架構參考資料

MLKPoseDetector


@interface MLKPoseDetector : NSObject

用於執行身體姿勢估算的偵測工具。

  • 傳回具有指定選項的姿勢偵測工具。

    聲明

    Objective-C

    + (nonnull instancetype)poseDetectorWithOptions:
        (nonnull MLKCommonPoseDetectorOptions *)options;

    參數

    options

    設定動作偵測工具的選項。

    傳回值

    以指定選項設定的姿勢偵測工具。

  • 無法使用,使用類別方法。

    聲明

    Objective-C

    - (nonnull instancetype)init;
  • 處理指定圖片進行姿勢偵測。

    聲明

    Objective-C

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

    參數

    image

    要處理的圖片。

    completion

    用於在主要執行緒 (偵測到姿勢) 回呼的處理常式。

  • 傳回指定圖片中的姿勢結果。姿勢偵測會在呼叫執行緒上同步執行。

    建議您從主執行緒呼叫此方法,以免封鎖 UI。因此,如果在主執行緒上呼叫此方法,就會引發 NSException

    聲明

    Objective-C

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

    參數

    image

    要用於取得結果的圖片。

    error

    取得結果時發生錯誤時填入的選用錯誤參數。

    傳回值

    在指定圖片中偵測到姿勢陣列,如果發生錯誤,則傳回 nil。 如未偵測到姿勢,就會傳回空白陣列。