Referência do framework MLKitFaceDetection

MLKFaceDetector

@interface MLKFaceDetector : NSObject

Um detector facial que detecta rostos em uma imagem.

• +faceDetectorWithOptions:

  Retorna um detector facial com as opções oferecidas.

  Declaração

  Objective-C

  + (nonnull instancetype)faceDetectorWithOptions:
      (nonnull MLKFaceDetectorOptions *)options;

  Parâmetros

  options

  Opções para configurar o detector facial.

  Valor de retorno

  Um detector facial configurado com as opções oferecidas.

• +faceDetector

  Retorna um detector facial com opções padrão.

  Declaração

  Objective-C

  + (nonnull instancetype)faceDetector;

  Valor de retorno

  Um detector facial configurado com opções padrão.

• -init

  Indisponível. Usar os métodos da classe.

  Declaração

  Objective-C

  - (nonnull instancetype)init;

• -processImage:completion:

  Processa a imagem especificada para detecção facial.

  Declaração

  Objective-C

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

  Parâmetros

  image	Imagem a ser processada.
  completion	Gerenciador para retornar a chamada na linha de execução principal com rostos detectados ou com erro.

• -resultsInImage:error:

  Retorna resultados de rostos na imagem fornecida ou nil se houver um erro. A detecção facial é realizada de maneira síncrona na linha de execução de chamada.

  É recomendável chamar esse método fora da linha de execução principal para evitar o bloqueio da interface. Como resultado, uma NSException será gerada se esse método for chamado na linha de execução principal.

  Declaração

  Objective-C

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

  Parâmetros

  image	A imagem com os resultados que serão mostrados.
  error	Um parâmetro de erro opcional preenchido quando há um erro ao obter resultados.

  Valor de retorno

  A matriz de resultados de rostos é a imagem fornecida ou nil, caso ocorra um erro.