Face class
Classe che rappresenta un viso.
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 del viso e facoltativamente con faceId, punti di riferimento e attributi.
|
| detect |
|
| detect |
|
| find |
Dato faceId del viso di query, per cercare i visi simili da una matrice faceId, un elenco di visi o un elenco di visi di grandi dimensioni. La matrice faceId contiene i visi creati da Viso - Rileva con URL o Viso - Rileva con stream, che scadrà al momento specificato da faceIdTimeToLive dopo la creazione. Un "faceListId" viene creato da FaceList : crea contenente persistedFaceIds che non scadono. E un "largeFaceListId" viene creato da LargeFaceList - Creare contenenti persistedFaceId che non scadono. A seconda dell'input, l'elenco di visi simili restituiti contiene faceId o persistedFaceId classificati in base alla somiglianza.
|
| find |
|
| find |
|
| group(string[], Request |
Dividere i visi candidati in gruppi in base alla somiglianza del viso.
|
| 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 faccia 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 estratta verrà archiviata nel server. FaceId è un identificatore della funzionalità viso e verrà usato in Viso - Identificare, Viso - Verificae viso - Trovasimili . La funzione o i visi archiviati scadrà e verrà eliminata 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, visoHair, occhiali, emozione, capelli, trucco, occlusione, accessori, sfocatura, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere altamente 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 Viso - Identificare, Viso - Verificae Viso - Trova simili ('returnFaceId' è true), usare visi che sono: frontal, clear 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 avranno bisogno di una dimensione minima minima proporzionale.
- È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere Come specificare un modello di rilevamento
- Vengono forniti valori diversi di 'recognitionModel'. 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 il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. Una volta specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Per altre informazioni, vedere Specificare un modello di riconoscimento.
function detectWithStream(image: HttpRequestBody, options?: FaceDetectWithStreamOptionalParams): Promise<FaceDetectWithStreamResponse>Parametri
- image
- HttpRequestBody
Flusso di immagini.
Parametri facoltativi
Valori restituiti
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 del 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 - Identificare, Viso - Verificae viso - Trovasimili . La funzione o i visi archiviati scadrà e verrà eliminata 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, visoHair, occhiali, emozione, capelli, trucco, occlusione, accessori, sfocatura, esposizione, rumore, maschera e qualitàForRecognition. Alcuni dei risultati restituiti per attributi specifici potrebbero non essere altamente 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 Viso - Identificare, Viso - Verificae Viso - Trova simili ('returnFaceId' è true), usare visi che sono: frontal, clear 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 avranno bisogno di una dimensione minima minima proporzionale.
È possibile specificare valori diversi di 'detectionModel'. Per usare e confrontare modelli di rilevamento diversi, vedere Come specificare un modello di rilevamento.
Vengono forniti valori diversi di 'recognitionModel'. 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 il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. Una volta specificato, i faceId rilevati verranno associati al modello di riconoscimento specificato. Per 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
Valori restituiti
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 faceId del viso di query, per cercare i visi simili da una matrice faceId, un elenco di visi o un elenco di visi di grandi dimensioni. La matrice faceId contiene i visi creati da Viso - Rileva con URL o Viso - Rileva con stream, che scadrà al momento specificato da faceIdTimeToLive dopo la creazione. Un "faceListId" viene creato da FaceList : crea contenente persistedFaceIds che non scadono. E un "largeFaceListId" viene creato da LargeFaceList - Creare contenenti persistedFaceId che non scadono. A seconda dell'input, l'elenco di visi simili restituiti contiene faceId o persistedFaceId classificati in base alla somiglianza.
Trova simile ha due modalità di lavoro, "matchPerson" e "matchFace". "matchPerson" è la modalità predefinita che tenta di trovare visi della stessa persona possibile usando soglie interne della stessa persona. È utile trovare le altre foto di una persona nota. Si noti che verrà restituito un elenco vuoto se nessun viso supera le soglie interne. La modalità "matchFace" ignora le soglie della stessa persona e restituisce comunque visi simili classificati, anche la somiglianza è bassa. Può essere usato nei casi come la ricerca di volti celebrità.
L'elemento 'recognitionModel' associato al faceId della query deve essere uguale a "recognitionModel" usato dalla matrice faceId di destinazione, dall'elenco dei volti o dall'elenco dei 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 scadrà al momento specificato da faceIdTimeToLive dopo la chiamata di rilevamento
- options
- FaceFindSimilarOptionalParams
Parametri facoltativi
Valori restituiti
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 scadrà 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 scadrà 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 viso.
- L'output è uno o più gruppi di visi non contigui e un messyGroup. Un gruppo di volti contiene visi che hanno un aspetto simile, spesso della stessa persona. I gruppi di visi 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 contenente visi che non possono trovare un viso controparte simile dai visi originali. Il messyGroup non verrà visualizzato nel risultato se tutti i visi hanno trovato le controparti.
- L'API di gruppo richiede almeno 2 visi candidati e 1000 al massimo. È consigliabile provare Viso - Verificare quando sono presenti solo 2 visi candidati.
- I faceId "recognitionModel" associati ai visi della query devono essere uguali.
function group(faceIds: string[], options?: RequestOptionsBase): Promise<FaceGroupResponse>Parametri
- faceIds
-
string[]
Matrice di faceId candidati creati da Face - Detect. Il massimo è 1000 visi
- options
- RequestOptionsBase
Parametri facoltativi
Valori restituiti
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 - Detect. 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 - Detect. 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 faccia da un gruppo di persone o da un gruppo di persone di grandi dimensioni.
Per ogni viso nella matrice faceIds, Face Identify calcola le analogie tra il viso della query e tutti i visi nel gruppo di persone (dato da personGroupId) o un gruppo di persone di grandi dimensioni (dato da largePersonGroupId) e restituirà le persone candidate per il viso classificato in base alla confidenza di somiglianza. Il gruppo di persone/gruppo di persone di grandi dimensioni deve essere sottoposto a training per prepararlo per l'identificazione. Per altre informazioni, vedere PersonGroup - Train e LargePersonGroup - Train.
Osservazioni:
- L'algoritmo consente di identificare in modo indipendente più di un viso alla stessa richiesta, ma non più di 10 visi.
- Ogni persona nel gruppo di persone/gruppo di persone di grandi dimensioni potrebbe avere più di un viso, ma non più di 248 visi.
- Qualità dell'immagine del viso più elevata significa una migliore precisione di identificazione. Si prega di considerare i visi di alta qualità: le dimensioni frontali, chiare e del viso sono di 200x200 pixel (100 pixel tra gli occhi) o più grandi.
- Il numero di candidati restituiti è limitato da maxNumOfCandidatesReturned e confidenceThreshold. Se non viene identificata alcuna persona, i candidati restituiti saranno una matrice vuota.
- Provare Viso - Trova simili quando è necessario trovare visi simili da un elenco di visi o da un elenco di visi di grandi dimensioni anziché da un gruppo di persone o da un gruppo di persone di grandi dimensioni.
- I faceId "recognitionModel" associati ai visi della query devono essere uguali a "recognitionModel" usati 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
Valori restituiti
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:
- Qualità dell'immagine del viso più elevata significa una migliore precisione di identificazione. Si prega di considerare i visi di alta qualità: le dimensioni frontali, chiare e del viso sono di 200x200 pixel (100 pixel tra gli occhi) o più grandi.
- Per gli scenari sensibili all'accuratezza, è consigliabile prendere il proprio giudizio.
- 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
Valori restituiti
Promise<FaceVerifyFaceToFaceResponse>
Prometti<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
Valori restituiti
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