FaceListOperations class

Pacchetto:

@azure/cognitiveservices-face

Classe che rappresenta un oggetto FaceListOperations.

Costruttori

FaceListOperations(FaceClientContext)

Creare un oggetto FaceListOperations.

Metodi

addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams)	Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi. Per gestire un'immagine contiene più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un elemento persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server finché non viene chiamato FaceList - Elimina viso o FaceList - Elimina. Nota persistedFaceId è diverso da faceId generato da Viso - Rileva. Qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e riconoscimento. 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. 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. Il rettangolo "targetFace" deve contenere un viso. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da Viso - Rileva, non esiste alcuna garanzia di rilevare e aggiungere correttamente il viso. Le dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), la posizione della testa grande o le occlusioni di grandi dimensioni causeranno errori. L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo. 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.
addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)
addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams)	Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi. Per gestire un'immagine contiene più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un elemento persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server finché non viene chiamato FaceList - Elimina viso o FaceList - Elimina. Nota persistedFaceId è diverso da faceId generato da Viso - Rileva. Qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e riconoscimento. 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. 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. Il rettangolo "targetFace" deve contenere un viso. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da Viso - Rileva, non esiste alcuna garanzia di rilevare e aggiungere correttamente il viso. Le dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), la posizione della testa grande o le occlusioni di grandi dimensioni causeranno errori. L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo. 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.
addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)
addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)
create(string, string, FaceListCreateOptionalParams)	Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome, un userData e recognitionModel facoltativo. In una sottoscrizione sono consentiti fino a 64 elenchi di visi. L'elenco dei visi è un elenco di visi, fino a 1.000 visi e usato da Viso - Trova simili. Dopo la creazione, l'utente deve usare FaceList - Aggiungi viso per importare i visi. Nessuna immagine verrà archiviata. Solo le funzionalità del viso estratte vengono archiviate nel server fino a quando non viene chiamato FaceList - Delete. Trova simile viene usato per scenari come la ricerca di volti simili a celebrità, un filtro viso simile o come identificazione del viso chiaro. Tuttavia, se l'uso effettivo consiste nell'identificare la persona, usare PersonGroup / LargePersonGroup e Viso - Identificare. Considerare LargeFaceList quando il numero del viso è elevato. Può supportare fino a 1.000.000 visi. 'recognitionModel' deve essere specificato per associare l'elenco dei visi. Il valore predefinito per 'recognitionModel' è 'recognition_01', se è necessario il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. I nuovi visi aggiunti a un elenco di visi esistenti useranno il modello di riconoscimento già associato alla raccolta. Le caratteristiche dei visi esistenti in un elenco di visi non possono essere aggiornate alle funzionalità estratte da un'altra versione del modello di riconoscimento. Fare riferimento a Specificare un modello di riconoscimento del viso.
create(string, string, FaceListCreateOptionalParams, ServiceCallback<void>)
create(string, string, ServiceCallback<void>)
deleteFace(string, string, RequestOptionsBase)	Eliminare un viso da un elenco di visi specificando faceListId e persistedFaceId. L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo.
deleteFace(string, string, RequestOptionsBase, ServiceCallback<void>)
deleteFace(string, string, ServiceCallback<void>)
deleteMethod(string, RequestOptionsBase)	Eliminare un elenco di visi specificato.
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
deleteMethod(string, ServiceCallback<void>)
get(string, FaceListGetOptionalParams)	Recuperare il faceListId di un elenco di visi, nome, userData, recognitionModel e visi nell'elenco dei volti.
get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)
get(string, ServiceCallback<FaceList>)
list(FaceListListOptionalParams)	List face lists' faceListId, name, userData and recognitionModel. Per ottenere informazioni sui visi all'interno di faceList, usare FaceList - Get
list(FaceListListOptionalParams, ServiceCallback<FaceList[]>)
list(ServiceCallback<FaceList[]>)
update(string, FaceListUpdateOptionalParams)	Aggiornare le informazioni di un elenco di visi.
update(string, FaceListUpdateOptionalParams, ServiceCallback<void>)
update(string, ServiceCallback<void>)

Dettagli costruttore

FaceListOperations(FaceClientContext)

Creare un oggetto FaceListOperations.

new FaceListOperations(client: FaceClientContext)

Parametri

client

FaceClientContext

Riferimento al client del servizio.

Dettagli metodo

addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams)

Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi.
Per gestire un'immagine contiene più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un elemento persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server finché non viene chiamato FaceList - Elimina viso o FaceList - Elimina.
Nota persistedFaceId è diverso da faceId generato da Viso - Rileva.

• Qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e riconoscimento. 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.
• 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.
• Il rettangolo "targetFace" deve contenere un viso. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da Viso - Rileva, non esiste alcuna garanzia di rilevare e aggiungere correttamente il viso.
• Le dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), la posizione della testa grande o le occlusioni di grandi dimensioni causeranno errori.
• L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo.
• 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.

function addFaceFromStream(faceListId: string, image: HttpRequestBody, options?: FaceListAddFaceFromStreamOptionalParams): Promise<FaceListAddFaceFromStreamResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

image

HttpRequestBody

Flusso di immagini.

options

FaceListAddFaceFromStreamOptionalParams

Parametri facoltativi

Valori restituiti

Promise<FaceListAddFaceFromStreamResponse>

Promise<Models.FaceListAddFaceFromStreamResponse>

addFaceFromStream(string, HttpRequestBody, FaceListAddFaceFromStreamOptionalParams, ServiceCallback<PersistedFace>)

function addFaceFromStream(faceListId: string, image: HttpRequestBody, options: FaceListAddFaceFromStreamOptionalParams, callback: ServiceCallback<PersistedFace>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

image

HttpRequestBody

Flusso di immagini.

options

FaceListAddFaceFromStreamOptionalParams

Parametri facoltativi

callback

ServiceCallback<PersistedFace>

Callback

addFaceFromStream(string, HttpRequestBody, ServiceCallback<PersistedFace>)

function addFaceFromStream(faceListId: string, image: HttpRequestBody, callback: ServiceCallback<PersistedFace>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

image

HttpRequestBody

Flusso di immagini.

callback

ServiceCallback<PersistedFace>

Callback

addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams)

Aggiungere un viso a un elenco di visi specificato, fino a 1.000 visi.
Per gestire un'immagine contiene più visi, è possibile specificare il viso di input come immagine con un rettangolo targetFace. Restituisce un elemento persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server finché non viene chiamato FaceList - Elimina viso o FaceList - Elimina.
Nota persistedFaceId è diverso da faceId generato da Viso - Rileva.

• Qualità dell'immagine del viso più elevata significa una migliore precisione di rilevamento e riconoscimento. 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.
• 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.
• Il rettangolo "targetFace" deve contenere un viso. Zero o più visi verranno considerati come un errore. Se il rettangolo "targetFace" specificato non viene restituito da Viso - Rileva, non esiste alcuna garanzia di rilevare e aggiungere correttamente il viso.
• Le dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), la posizione della testa grande o le occlusioni di grandi dimensioni causeranno errori.
• L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo.
• 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.

function addFaceFromUrl(faceListId: string, url: string, options?: FaceListAddFaceFromUrlOptionalParams): Promise<FaceListAddFaceFromUrlResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

url

string

URL raggiungibile pubblicamente di un'immagine

options

FaceListAddFaceFromUrlOptionalParams

Parametri facoltativi

Valori restituiti

Promise<FaceListAddFaceFromUrlResponse>

Prometti<Models.FaceListAddFaceFromUrlResponse>

addFaceFromUrl(string, string, FaceListAddFaceFromUrlOptionalParams, ServiceCallback<PersistedFace>)

function addFaceFromUrl(faceListId: string, url: string, options: FaceListAddFaceFromUrlOptionalParams, callback: ServiceCallback<PersistedFace>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

url

string

URL raggiungibile pubblicamente di un'immagine

options

FaceListAddFaceFromUrlOptionalParams

Parametri facoltativi

callback

ServiceCallback<PersistedFace>

Callback

addFaceFromUrl(string, string, ServiceCallback<PersistedFace>)

function addFaceFromUrl(faceListId: string, url: string, callback: ServiceCallback<PersistedFace>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

url

string

URL raggiungibile pubblicamente di un'immagine

callback

ServiceCallback<PersistedFace>

Callback

create(string, string, FaceListCreateOptionalParams)

Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome, un userData e recognitionModel facoltativo. In una sottoscrizione sono consentiti fino a 64 elenchi di visi.
L'elenco dei visi è un elenco di visi, fino a 1.000 visi e usato da Viso - Trova simili.
Dopo la creazione, l'utente deve usare FaceList - Aggiungi viso per importare i visi. Nessuna immagine verrà archiviata. Solo le funzionalità del viso estratte vengono archiviate nel server fino a quando non viene chiamato FaceList - Delete.
Trova simile viene usato per scenari come la ricerca di volti simili a celebrità, un filtro viso simile o come identificazione del viso chiaro. Tuttavia, se l'uso effettivo consiste nell'identificare la persona, usare PersonGroup / LargePersonGroup e Viso - Identificare.
Considerare LargeFaceList quando il numero del viso è elevato. Può supportare fino a 1.000.000 visi.
'recognitionModel' deve essere specificato per associare l'elenco dei visi. Il valore predefinito per 'recognitionModel' è 'recognition_01', se è necessario il modello più recente, specificare in modo esplicito il modello necessario in questo parametro. I nuovi visi aggiunti a un elenco di visi esistenti useranno il modello di riconoscimento già associato alla raccolta. Le caratteristiche dei visi esistenti in un elenco di visi non possono essere aggiornate alle funzionalità estratte da un'altra versione del modello di riconoscimento. Fare riferimento a Specificare un modello di riconoscimento del viso.

function create(faceListId: string, name: string, options?: FaceListCreateOptionalParams): Promise<RestResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

name

string

Il nome definito dall'utente, la lunghezza massima è 128.

options

FaceListCreateOptionalParams

Parametri facoltativi

Valori restituiti

Promise<RestResponse>

Prometti<msRest.RestResponse>

create(string, string, FaceListCreateOptionalParams, ServiceCallback<void>)

function create(faceListId: string, name: string, options: FaceListCreateOptionalParams, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

name

string

Il nome definito dall'utente, la lunghezza massima è 128.

options

FaceListCreateOptionalParams

Parametri facoltativi

callback

ServiceCallback<void>

Callback

create(string, string, ServiceCallback<void>)

function create(faceListId: string, name: string, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

name

string

Il nome definito dall'utente, la lunghezza massima è 128.

callback

ServiceCallback<void>

Callback

deleteFace(string, string, RequestOptionsBase)

Eliminare un viso da un elenco di visi specificando faceListId e persistedFaceId.
L'aggiunta o l'eliminazione di visi da e verso uno stesso elenco di visi vengono elaborati in sequenza e da/verso elenchi di visi diversi sono in parallelo.

function deleteFace(faceListId: string, persistedFaceId: string, options?: RequestOptionsBase): Promise<RestResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

persistedFaceId

string

Id che fa riferimento a un particolare elemento PersistedFaceId di un viso esistente.

options

RequestOptionsBase

Parametri facoltativi

Valori restituiti

Promise<RestResponse>

Prometti<msRest.RestResponse>

deleteFace(string, string, RequestOptionsBase, ServiceCallback<void>)

function deleteFace(faceListId: string, persistedFaceId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

persistedFaceId

string

Id che fa riferimento a un particolare elemento PersistedFaceId di un viso esistente.

options

RequestOptionsBase

Parametri facoltativi

callback

ServiceCallback<void>

Callback

deleteFace(string, string, ServiceCallback<void>)

function deleteFace(faceListId: string, persistedFaceId: string, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

persistedFaceId

string

Id che fa riferimento a un particolare elemento PersistedFaceId di un viso esistente.

callback

ServiceCallback<void>

Callback

deleteMethod(string, RequestOptionsBase)

Eliminare un elenco di visi specificato.

function deleteMethod(faceListId: string, options?: RequestOptionsBase): Promise<RestResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

RequestOptionsBase

Parametri facoltativi

Valori restituiti

Promise<RestResponse>

Prometti<msRest.RestResponse>

deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)

function deleteMethod(faceListId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

RequestOptionsBase

Parametri facoltativi

callback

ServiceCallback<void>

Callback

deleteMethod(string, ServiceCallback<void>)

function deleteMethod(faceListId: string, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

callback

ServiceCallback<void>

Callback

get(string, FaceListGetOptionalParams)

Recuperare il faceListId di un elenco di visi, nome, userData, recognitionModel e visi nell'elenco dei volti.

function get(faceListId: string, options?: FaceListGetOptionalParams): Promise<FaceListGetResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

FaceListGetOptionalParams

Parametri facoltativi

Valori restituiti

Promise<FaceListGetResponse>

Promise<Models.FaceListGetResponse>

get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)

function get(faceListId: string, options: FaceListGetOptionalParams, callback: ServiceCallback<FaceList>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

FaceListGetOptionalParams

Parametri facoltativi

callback

ServiceCallback<FaceList>

Callback

get(string, ServiceCallback<FaceList>)

function get(faceListId: string, callback: ServiceCallback<FaceList>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

callback

ServiceCallback<FaceList>

Callback

list(FaceListListOptionalParams)

List face lists' faceListId, name, userData and recognitionModel.
Per ottenere informazioni sui visi all'interno di faceList, usare FaceList - Get

function list(options?: FaceListListOptionalParams): Promise<FaceListListResponse>

Parametri

options

FaceListListOptionalParams

Parametri facoltativi

Valori restituiti

Promise<FaceListListResponse>

Promise<Models.FaceListListResponse>

list(FaceListListOptionalParams, ServiceCallback<FaceList[]>)

function list(options: FaceListListOptionalParams, callback: ServiceCallback<FaceList[]>)

Parametri

options

FaceListListOptionalParams

Parametri facoltativi

callback

ServiceCallback<FaceList[]>

Callback

list(ServiceCallback<FaceList[]>)

function list(callback: ServiceCallback<FaceList[]>)

Parametri

callback

ServiceCallback<FaceList[]>

Callback

update(string, FaceListUpdateOptionalParams)

Aggiornare le informazioni di un elenco di visi.

function update(faceListId: string, options?: FaceListUpdateOptionalParams): Promise<RestResponse>

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

FaceListUpdateOptionalParams

Parametri facoltativi

Valori restituiti

Promise<RestResponse>

Prometti<msRest.RestResponse>

update(string, FaceListUpdateOptionalParams, ServiceCallback<void>)

function update(faceListId: string, options: FaceListUpdateOptionalParams, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

options

FaceListUpdateOptionalParams

Parametri facoltativi

callback

ServiceCallback<void>

Callback

update(string, ServiceCallback<void>)

function update(faceListId: string, callback: ServiceCallback<void>)

Parametri

faceListId

string

ID che fa riferimento a un elenco di visi specifico.

callback

ServiceCallback<void>

Callback