> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/linha-android/iaserver/iaifaceobject.md).

# IAIFaceObject

Classe wrapper de resultado de reconhecimento facial.

Observação

* Um reconhecimento de quadro será chamado de volta duas vezes, uma vez para o resultado da detecção e uma vez para o resultado do reconhecimento
* Alguns campos são válidos apenas quando são resultados de reconhecimento, como `java {mSimilarity}`, Detecção ao vivo `java{mLiveFlag}`, detecção de máscara `java{mFaceMask}`

```java
public class IAIFaceObject implements Parcelable {
    
/**
* When recognizing the result, it represents the face library id; when detecting the result, it
is meaningless and represents the process id of the detection process
*/
public int mId;

/**
* Confidence of the face
*/
public int mConfidence;

/**
* Face alignment score
*/
public int mAlignScore;

/**
* The face area displayed on the interface
*/
public int mLeft, mTop, mRight, mBottom;
/**
* FP parameter correlation, attitude detection
*/
public int mPitch, mYaw, mRoll;

/**
* -1 is not detected (default), 0 is not living, 1 is living
*/
public int mLiveFlag;

/**
* Pupil distance
*/
public int mEyeDist;

/**
* face file path
*/
@Deprecated
public String mFacePath;

/**
* detect frame path
*/
@Deprecated
public String mOneShotPath;

/**
* The larger the value of [0,100], the higher the similarity
* -1 is the internal return of the algorithm, which is consistent with the algorithm.
* > 0 means recognition was successful, others means failure, please refer to {@link
com.lamy.sdk.aiserver.utils.FaceDetectSimilarityResult}* /
*/
public int mSimilarity = -1;

/**
* Confidence in the live detection
*/
public int mLiveConfidence;

/**
* Attributes: 0 No cover, 1 mask, 2 others. Greater than zero means you're wearing a mask
* Valid when identifying results
*/
public int mFaceMask;

/**
* Valid when identifying results
*/
public int mFaceMaskConfidence;

/**
* The additional information is usually a Bundle object, depending on the service function
protocol
*/
public Parcelable mExtraInfo;

}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://portal-integracao.intelbras.com.br/linha-android/iaserver/iaifaceobject.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.