Face class
Classe che rappresenta un oggetto Face.
Costruttori
| Face(Face |
Creare un viso. |
Metodi
| detect |
Rilevare i visi umani in un'immagine, restituire rettangoli del viso e facoltativamente con faceId, punti di riferimento e attributi.
|
| detect |
|
| detect |
|
| detect |
Rilevare i visi umani in un'immagine, restituire rettangoli viso e facoltativamente con faceId, punti di riferimento e attributi.
|
| detect |
|
| detect |
|
| find |
Dato il faceId della query, per cercare i visi simili da una matrice faceId, un elenco di volti o un elenco di volti di grandi dimensioni. la matrice faceId contiene i visi creati da Face - Rileva con URL o Viso - Rileva conflusso, che scadono al momento specificato da faceIdTimeToLive dopo la creazione. Un "faceListId" viene creato da FaceList - Crea contenente persistentiFaceIds che non scadono. E un "largeFaceListId" viene creato da LargeFaceList - Crea contenente persistentiFaceId che non scadono anche. A seconda dell'input, l'elenco di visi simili restituiti contiene faceIds o persistentiFaceIds classificati in base alla somiglianza.
|
| find |
|
| find |
|
| group(string[], Request |
Dividere i visi candidati in gruppi in base alla somiglianza del volto.
|
| group(string[], Request |
|
| group(string[], Service |
|
| identify(string[], Face |
Identificazione da 1 a molti per trovare le corrispondenze più vicine della persona di query specifica viso da un gruppo di persone o da un gruppo di persone di grandi dimensioni.
Osservazioni:
|
| identify(string[], Face |
|
| identify(string[], Service |
|
| verify |
Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.
|
| verify |
|
| verify |
|
| verify |
Verificare se due visi appartengono a una stessa persona. Confronta un ID viso con un ID persona |
| verify |
|
| verify |
Dettagli costruttore
Face(FaceClientContext)
Creare un viso.
new Face(client: FaceClientContext)Parametri
- client
- FaceClientContext
Riferimento al client del servizio.
Dettagli metodo
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams)
Rilevare i visi umani in un'immagine, restituire rettangoli del viso e facoltativamente con faceId, punti di riferimento e attributi.
- Nessuna immagine verrà archiviata. Solo la funzionalità viso estratto verrà archiviata nel server. FaceId è un identificatore della funzionalità viso e verrà usato in Viso - Identificazione, Viso - Verifica e Viso - Trova simile. Le funzionalità del viso archiviate scadono e verranno eliminate al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento originale.
- I parametri facoltativi includono faceId, punti di riferimento e attributi. Gli attributi includono età, sesso, headPose, smile, visore, occhiali, emozioni, capelli, trucco, occlusione, accessori, sfocatura, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere molto accurati.
- Sono supportati JPEG, PNG, GIF (il primo fotogramma) e il formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
- È possibile restituire fino a 100 visi per un'immagine. I visi vengono classificati in base alle dimensioni del rettangolo del viso da grandi a piccole.
- Per ottenere risultati ottimali durante l'esecuzione di query su Viso - Identificazione, Viso - Verifica e Viso - Trova simile ('returnFaceId' è true), usare i visi che sono frontali, chiari e con una dimensione minima di 200x200 pixel (100 pixel tra gli occhi).
- La dimensione minima del viso rilevabile è di 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel dovranno avere dimensioni minime proporzionalmente maggiori.
- È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere Come specificare un modello di rilevamento
- Vengono forniti valori 'recognitionModel' diversi. Se sono necessarie operazioni di completamento come Verify, Identify, Find Similar, specificare il modello di riconoscimento con il parametro 'recognitionModel'. Il valore predefinito per 'recognitionModel' è 'recognition_01', se necessario per il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. Dopo aver specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Altre informazioni, vedere Specificare un modello di riconoscimento.
function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>Parametri
- image
- HttpRequestBody
Flusso di immagini.
Parametri facoltativi
Restituisce
Promise<FaceDetectWithStreamResponse>
Promise<Models.FaceDetectWithStreamResponse>
detectWithStream(HttpRequestBody, FaceDetectWithStreamOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, options: FaceDetectWithStreamOptionalParams, callback: ServiceCallback<DetectedFace[]>)Parametri
- image
- HttpRequestBody
Flusso di immagini.
Parametri facoltativi
- callback
Callback
detectWithStream(HttpRequestBody, ServiceCallback<DetectedFace[]>)
function detectWithStream(image: HttpRequestBody, callback: ServiceCallback<DetectedFace[]>)Parametri
- image
- HttpRequestBody
Flusso di immagini.
- callback
Callback
detectWithUrl(string, FaceDetectWithUrlOptionalParams)
Rilevare i visi umani in un'immagine, restituire rettangoli viso e facoltativamente con faceId, punti di riferimento e attributi.
Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server. FaceId è un identificatore della funzionalità viso e verrà usato in Viso - Identifica, Viso -Verifica e Viso - Trova simile. Le funzionalità del viso archiviate scadono e verranno eliminate al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento originale.
I parametri facoltativi includono faceId, punti di riferimento e attributi. Gli attributi includono età, sesso, headPose, sorriso, visoHair, occhiali, emozioni, capelli, trucco, occlusione, accessori, blur, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere estremamente accurati.
Sono supportati JPEG, PNG, GIF (primo frame) e formato BMP. Le dimensioni consentite del file di immagine sono da 1 KB a 6 MB.
È possibile restituire fino a 100 visi per un'immagine. I visi sono classificati in base alle dimensioni del rettangolo viso da grandi a piccole.
Per risultati ottimali durante la query viso - Identificare, Viso -Verifica e Viso - Trova simile ('returnFaceId' è true), usare i visi: frontali, chiari e con dimensioni minime di 200x200 pixel (100 pixel tra gli occhi).
Le dimensioni minime del viso rilevabili sono 36x36 pixel in un'immagine non superiore a 1920x1080 pixel. Le immagini con dimensioni superiori a 1920x1080 pixel richiedono dimensioni minime proporzionali maggiori.
È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere Come specificare un modello di rilevamento.
Vengono forniti valori 'recognitionModel' diversi. Se sono necessarie operazioni di completamento come Verifica, Identificazione, Trova simile, specificare il modello di riconoscimento con il parametro 'recognitionModel'. Il valore predefinito per 'recognitionModel' è 'recognition_01', se necessario, specificare in modo esplicito il modello necessario in questo parametro. Dopo aver specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Altre informazioni, vedere Specificare un modello di riconoscimento.
function detectWithUrl(url: string, options?: FaceDetectWithUrlOptionalParams): Promise<FaceDetectWithUrlResponse>Parametri
- url
-
string
URL raggiungibile pubblicamente di un'immagine
- options
- FaceDetectWithUrlOptionalParams
Parametri facoltativi
Restituisce
Promise<FaceDetectWithUrlResponse>
Promise<Models.FaceDetectWithUrlResponse>
detectWithUrl(string, FaceDetectWithUrlOptionalParams, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, options: FaceDetectWithUrlOptionalParams, callback: ServiceCallback<DetectedFace[]>)Parametri
- url
-
string
URL raggiungibile pubblicamente di un'immagine
- options
- FaceDetectWithUrlOptionalParams
Parametri facoltativi
- callback
Callback
detectWithUrl(string, ServiceCallback<DetectedFace[]>)
function detectWithUrl(url: string, callback: ServiceCallback<DetectedFace[]>)Parametri
- url
-
string
URL raggiungibile pubblicamente di un'immagine
- callback
Callback
findSimilar(string, FaceFindSimilarOptionalParams)
Dato il faceId della query, per cercare i visi simili da una matrice faceId, un elenco di volti o un elenco di volti di grandi dimensioni. la matrice faceId contiene i visi creati da Face - Rileva con URL o Viso - Rileva conflusso, che scadono al momento specificato da faceIdTimeToLive dopo la creazione. Un "faceListId" viene creato da FaceList - Crea contenente persistentiFaceIds che non scadono. E un "largeFaceListId" viene creato da LargeFaceList - Crea contenente persistentiFaceId che non scadono anche. A seconda dell'input, l'elenco di visi simili restituiti contiene faceIds o persistentiFaceIds classificati in base alla somiglianza.
Trova simile ha due modalità di lavoro, "matchPerson" e "matchFace". "matchPerson" è la modalità predefinita che tenta di trovare i visi della stessa persona possibile usando soglie interne della stessa persona. È utile trovare altre foto di una persona nota. Si noti che un elenco vuoto verrà restituito se non vengono superate le soglie interne. La modalità "matchFace" ignora le soglie della stessa persona e restituisce visi simili in ogni caso, anche la somiglianza è bassa. Può essere usato nei casi come la ricerca di volti celebrità.
Il 'recognitionModel' associato all'faceId della query deve essere uguale al 'recognitionModel' usato dalla matrice faceId di destinazione, dall'elenco dei volti o dall'elenco di volti di grandi dimensioni.
function findSimilar(faceId: string, options?: FaceFindSimilarOptionalParams): Promise<FaceFindSimilarResponse>Parametri
- faceId
-
string
FaceId del viso della query. L'utente deve chiamare Viso: rilevare prima di tutto per ottenere un faceId valido. Si noti che questo faceId non è persistente e scade al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento
- options
- FaceFindSimilarOptionalParams
Parametri facoltativi
Restituisce
Promise<FaceFindSimilarResponse>
Promise<Models.FaceFindSimilarResponse>
findSimilar(string, FaceFindSimilarOptionalParams, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, options: FaceFindSimilarOptionalParams, callback: ServiceCallback<SimilarFace[]>)Parametri
- faceId
-
string
FaceId del viso della query. L'utente deve chiamare Viso: rilevare prima di tutto per ottenere un faceId valido. Si noti che questo faceId non è persistente e scade al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento
- options
- FaceFindSimilarOptionalParams
Parametri facoltativi
- callback
Callback
findSimilar(string, ServiceCallback<SimilarFace[]>)
function findSimilar(faceId: string, callback: ServiceCallback<SimilarFace[]>)Parametri
- faceId
-
string
FaceId del viso della query. L'utente deve chiamare Viso: rilevare prima di tutto per ottenere un faceId valido. Si noti che questo faceId non è persistente e scade al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento
- callback
Callback
group(string[], RequestOptionsBase)
Dividere i visi candidati in gruppi in base alla somiglianza del volto.
- L'output è uno o più gruppi di viso disgiunti e un gruppo disordinato. Un gruppo di volti contiene visi che hanno un aspetto simile, spesso della stessa persona. I gruppi di viso sono classificati in base alle dimensioni del gruppo, ad esempio il numero di visi. Si noti che i visi appartenenti a una stessa persona possono essere suddivisi in diversi gruppi nel risultato.
- MessyGroup è un gruppo di volti speciale che contiene visi che non possono trovare un viso simile da visi originali. Il messyGroup non verrà visualizzato nel risultato se tutti i visi trovati le loro controparti.
- L'API del gruppo richiede almeno 2 visi candidati e 1000 al massimo. Ti consigliamo di provare Face - Verifica quando hai solo 2 visi candidati.
- I faceId 'recognitionModel' associati ai visi di query devono essere uguali.
function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>Parametri
- faceIds
-
string[]
Matrice di faceId candidati creati da Face - Rileva. Il massimo è 1000 visi
- options
- RequestOptionsBase
Parametri facoltativi
Restituisce
Promise<FaceGroupResponse>
Promise<Models.FaceGroupResponse>
group(string[], RequestOptionsBase, ServiceCallback<GroupResult>)
function group(faceIds: string[], options: RequestOptionsBase, callback: ServiceCallback<GroupResult>)Parametri
- faceIds
-
string[]
Matrice di faceId candidati creati da Face - Rileva. Il massimo è 1000 visi
- options
- RequestOptionsBase
Parametri facoltativi
- callback
Callback
group(string[], ServiceCallback<GroupResult>)
function group(faceIds: string[], callback: ServiceCallback<GroupResult>)Parametri
- faceIds
-
string[]
Matrice di faceId candidati creati da Face - Rileva. Il massimo è 1000 visi
- callback
Callback
identify(string[], FaceIdentifyOptionalParams)
Identificazione da 1 a molti per trovare le corrispondenze più vicine della persona di query specifica viso da un gruppo di persone o da un gruppo di persone di grandi dimensioni.
Per ogni viso nella matrice faceIds, FaceIdentifi calcola le somiglianze tra il viso della query e tutti i visi nel gruppo di persone (dato da personGroupId) o da un gruppo di persone di grandi dimensioni (dato da largePersonGroupId) e restituirà le persone candidate per il viso classificato dalla confidenza di somiglianza. Il gruppo di persone/gruppo di persone di grandi dimensioni deve essere sottoposto a training per renderlo pronto per l'identificazione. Per altre informazioni, vedere PersonGroup - Training e LargePersonGroup - Train.
Osservazioni:
- L'algoritmo consente di identificare più di un viso in modo indipendente con la stessa richiesta, ma non più di 10 visi.
- Ogni persona nel gruppo di persone/gruppo di persone grandi potrebbe avere più di un viso, ma non più di 248 visi.
- Qualità dell'immagine del viso superiore significa una migliore precisione di identificazione. Si prega di considerare i visi di alta qualità: frontal, chiaro e dimensioni del viso è 200x200 pixel (100 pixel tra gli occhi) o maggiore.
- Il numero di candidati restituiti è limitato da maxNumOfCandidatesReturned e confidenceThreshold. Se non viene identificata alcuna persona, i candidati restituiti saranno una matrice vuota.
- Prova Viso- Trova simile quando devi trovare visi simili da un elenco viso/un elenco di volti di grandi dimensioni anziché un gruppo di persone/un gruppo di persone di grandi dimensioni.
- Il 'recognitionModel' associato ai visi di query' faceId deve essere uguale al 'recognitionModel' usato dal gruppo di persone di destinazione o dal gruppo di persone di grandi dimensioni.
function identify(faceIds: string[], options?: FaceIdentifyOptionalParams): Promise<FaceIdentifyResponse>Parametri
- faceIds
-
string[]
Matrice di visi di query faceId creati da Face - Detect. Ognuno dei visi viene identificato in modo indipendente. Il numero valido di faceId è compreso tra [1, 10].
- options
- FaceIdentifyOptionalParams
Parametri facoltativi
Restituisce
Promise<FaceIdentifyResponse>
Promise<Models.FaceIdentifyResponse>
identify(string[], FaceIdentifyOptionalParams, ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], options: FaceIdentifyOptionalParams, callback: ServiceCallback<IdentifyResult[]>)Parametri
- faceIds
-
string[]
Matrice di visi di query faceId creati da Face - Detect. Ognuno dei visi viene identificato in modo indipendente. Il numero valido di faceId è compreso tra [1, 10].
- options
- FaceIdentifyOptionalParams
Parametri facoltativi
- callback
Callback
identify(string[], ServiceCallback<IdentifyResult[]>)
function identify(faceIds: string[], callback: ServiceCallback<IdentifyResult[]>)Parametri
- faceIds
-
string[]
Matrice di visi di query faceId creati da Face - Detect. Ognuno dei visi viene identificato in modo indipendente. Il numero valido di faceId è compreso tra [1, 10].
- callback
Callback
verifyFaceToFace(string, string, RequestOptionsBase)
Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.
Osservazioni:
- Maggiore qualità dell'immagine del viso significa una migliore precisione di identificazione. Si prega di considerare i visi di alta qualità: frontale, chiaro e dimensione del viso è 200x200 pixel (100 pixel tra gli occhi) o superiore.
- Per gli scenari sensibili all'accuratezza, effettuare un giudizio personale.
- I faceId "recognitionModel" associati ai visi della query devono essere uguali a "recognitionModel" usati dal viso di destinazione, dal gruppo di persone o dal gruppo di persone di grandi dimensioni.
function verifyFaceToFace(faceId1: string, faceId2: string, options?: RequestOptionsBase): Promise<FaceVerifyFaceToFaceResponse>Parametri
- faceId1
-
string
FaceId del primo viso, proviene da Face - Detect
- faceId2
-
string
FaceId del secondo viso, proviene da Face - Detect
- options
- RequestOptionsBase
Parametri facoltativi
Restituisce
Promise<FaceVerifyFaceToFaceResponse>
Promise<Models.FaceVerifyFaceToFaceResponse>
verifyFaceToFace(string, string, RequestOptionsBase, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, options: RequestOptionsBase, callback: ServiceCallback<VerifyResult>)Parametri
- faceId1
-
string
FaceId del primo viso, proviene da Face - Detect
- faceId2
-
string
FaceId del secondo viso, proviene da Face - Detect
- options
- RequestOptionsBase
Parametri facoltativi
- callback
Callback
verifyFaceToFace(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToFace(faceId1: string, faceId2: string, callback: ServiceCallback<VerifyResult>)Parametri
- faceId1
-
string
FaceId del primo viso, proviene da Face - Detect
- faceId2
-
string
FaceId del secondo viso, proviene da Face - Detect
- callback
Callback
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams)
Verificare se due visi appartengono a una stessa persona. Confronta un ID viso con un ID persona
function verifyFaceToPerson(faceId: string, personId: string, options?: FaceVerifyFaceToPersonOptionalParams): Promise<FaceVerifyFaceToPersonResponse>Parametri
- faceId
-
string
FaceId del viso, proviene da Face - Detect
- personId
-
string
Specificare una determinata persona in un gruppo di persone o in un gruppo di persone di grandi dimensioni. personId viene creato in PersonGroup Person - Create o LargePersonGroup Person - Create.
Parametri facoltativi
Restituisce
Promise<FaceVerifyFaceToPersonResponse>
Promise<Models.FaceVerifyFaceToPersonResponse>
verifyFaceToPerson(string, string, FaceVerifyFaceToPersonOptionalParams, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, options: FaceVerifyFaceToPersonOptionalParams, callback: ServiceCallback<VerifyResult>)Parametri
- faceId
-
string
FaceId del viso, proviene da Face - Detect
- personId
-
string
Specificare una determinata persona in un gruppo di persone o in un gruppo di persone di grandi dimensioni. personId viene creato in PersonGroup Person - Create o LargePersonGroup Person - Create.
Parametri facoltativi
- callback
Callback
verifyFaceToPerson(string, string, ServiceCallback<VerifyResult>)
function verifyFaceToPerson(faceId: string, personId: string, callback: ServiceCallback<VerifyResult>)Parametri
- faceId
-
string
FaceId del viso, proviene da Face - Detect
- personId
-
string
Specificare una determinata persona in un gruppo di persone o in un gruppo di persone di grandi dimensioni. personId viene creato in PersonGroup Person - Create o LargePersonGroup Person - Create.
- callback
Callback