> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/selphid/release_notes/6.20.0_releasenotes.md).

# 6.20.0

Esta versão adiciona novos endpoints relacionados ao registro de Eventos Personalizados (Custom Events) na plataforma API Tracking. Também elimina metadados herdados (legacy) em `SelphIDFacialExtractionResult`, que já não são usados nas versões modernas do mecanismo de extração facial.

Devido à recente incorporação da estrutura `SelphIDNoLiveDetails`, já não é necessário imprimir os códigos de estado de teste de vida no log; portanto, eles foram removidos.

As mensagens de log relacionadas ao licenciamento offline foram revisadas, eliminando as mensagens contraditórias de ativação de licença.

Por fim, o aplicativo para calcular o hostID, distribuído com SelphID, `selphid-license-activator`, já não depende da instalação do SDK para funcionar. Funciona como um aplicativo independente (standalone), sem necessidade de configurar variáveis de ambiente.

### Adicionado

* Suporte aprimorado para Eventos Personalizados:
  * `SelphIDVerifier::EvaluatePassiveLivenessTrackingEvent()`.
  * `SelphIDVerifier::VoiceAuthenticationTrackingEvent()`.
* Novos endpoints de Eventos Personalizados:
  * `/api/v1/selphid/custom-event/ocr/finish`
  * `/api/v1/selphid/custom-event/security/finish`
  * `/api/v1/selphid/custom-event/liveness`
  * `/api/v1/selphid/custom-event/liveness/finish`
  * `/api/v1/selphid/custom-event/voice/authentication`
  * `/api/v1/selphid/custom-event/voice/authentication/finish`

### Excluído

* Metadados herdados obsoletos de `SelphIDFacialExtractionResult`:
  * Lips
  * GeographicOrigin
  * Emotion
  * Artwork
  * FacialHair
* Códigos de estado de teste de vida dos logs. A partir de agora, use `SelphIDNoLiveDetails::GetReasonMessage()`.
  * 0xAB01
  * 0xAB02
  * 0xAB03
  * 0xAB04
  * 0xAB05
  * 0xAB06
  * 0xAB07
  * 0xAB08

### Aprimorado

* `selphid-license-activator` é executada como um aplicativo independente, para obter o HostID.

### Excluído

* Mensagens de log contraditórias do licenciamento offline.

### Atualizações do contrato da API

Vários campos foram removidos do contrato da API REST, relacionados à resposta de `FacialExtractionResult`:

* `lips`
* `emotion`
* `hair`
* `origin`

```json
{
  "facialTemplate": "BAEBGgEroySjGz2C9iIki35J/FA...",
  "facialTemplateRaw": "BAEBAQHjF08R/Fbogyt7nysPd/K...",
  "updatedTemplateRaw": true,
  "face": { ... },
  "leftEye": { ... },
  "rightEye": { ... },
  "chin": { ... },
  "nose": { ... },
  "leftMouth": { ... },
  "rightMouth": { ... },
  "iod": 118,
  "yaw": 2.4,
  "pitch": -4.32,
  "roll": 0.7,
  "glasses": "Eye",
  "age": 45,
  --> Removido "lips": "Together", <--
  "gender": "Male",
  --> Removido "emotion": "Neutral", <--
  --> Removido "hair": 45.3, <--
  --> Removido "origin": "European", <--
  "mask": 0.89,
  "faceConfidence": 0.99,
  "facialQuality": "Good",
  "validTimeStamp": true,
  "tokenTimeStamp": "2022-01-14T10:42:05.521922Z",
  "sdkDuration": 1234
}
```

Isso afeta a resposta dos seguintes endpoints:

* `/api/v1/selphid/extract`
* `/api/v1/selphid/extract/template`
* `/api/v1/selphid/authenticate-facial/images` (Campos de resposta `extractionQuery` e `extractionTarget`).
* `/api/v1/selphid/authenticate-facial/image/template` (Campos de resposta `extractionQuery` e `extractionTarget`).
* `/api/v1/selphid/authenticate-facial/templates` (Campos de resposta `extractionQuery` e `extractionTarget`).

Também foram adicionados novos endpoints. Isso não quebra o contrato anterior; simplesmente adiciona nova funcionalidade.

* `/api/v1/selphid/custom-event/ocr/finish`
* `/api/v1/selphid/custom-event/security/finish`
* `/api/v1/selphid/custom-event/liveness`
* `/api/v1/selphid/custom-event/liveness/finish`
* `/api/v1/selphid/custom-event/voice/authentication`
* `/api/v1/selphid/custom-event/voice/authentication/finish`