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 valore persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando non viene chiamato FaceList - Delete Face o FaceList - Delete . Nota persistedFaceId è diverso da faceId generato da Face - Detect. Maggiore qualità dell'immagine del viso significa una migliore precisione di rilevamento e riconoscimento. Si prega di considerare i visi di alta qualità: frontale, chiaro e dimensione del viso è 200x200 pixel (100 pixel tra gli occhi) o superiore. 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 Face - Detect, non esiste alcuna garanzia per rilevare e aggiungere correttamente il viso. Dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), posizione testa grande o occlusioni grandi causeranno errori. L'aggiunta o l'eliminazione di visi da/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 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.
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 valore persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando non viene chiamato FaceList - Delete Face o FaceList - Delete . Nota persistedFaceId è diverso da faceId generato da Face - Detect. Maggiore qualità dell'immagine del viso significa una migliore precisione di rilevamento e riconoscimento. Si prega di considerare i visi di alta qualità: frontale, chiaro e dimensione del viso è 200x200 pixel (100 pixel tra gli occhi) o superiore. 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 Face - Detect, non esiste alcuna garanzia per rilevare e aggiungere correttamente il viso. Dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), posizione testa grande o occlusioni grandi causeranno errori. L'aggiunta o l'eliminazione di visi da/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 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.
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, nome, userData e recognitionModel facoltativi. 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 Face - Find Similar. 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 visi simili a celebrità, il filtro del viso simile o l'identificazione del viso in modo chiaro. Tuttavia, se l'uso effettivo consiste nell'identificare la persona, usare PersonGroup / LargePersonGroup e Face - Identify. Considerare LargeFaceList quando il numero del viso è elevato. Può supportare fino a 1.000.000 visi. 'recognitionModel' deve essere specificato per l'associazione a questo elenco di 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 funzionalità del viso esistenti in un elenco dei 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/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 visi.
get(string, FaceListGetOptionalParams, ServiceCallback<FaceList>)
get(string, ServiceCallback<FaceList>)
list(FaceListListOptionalParams)	Elencare i visi faceListId, nome, userData e 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 valore persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando non viene chiamato FaceList - Delete Face o FaceList - Delete .
Nota persistedFaceId è diverso da faceId generato da Face - Detect.

• Maggiore qualità dell'immagine del viso significa una migliore precisione di rilevamento e riconoscimento. Si prega di considerare i visi di alta qualità: frontale, chiaro e dimensione del viso è 200x200 pixel (100 pixel tra gli occhi) o superiore.
• 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 Face - Detect, non esiste alcuna garanzia per rilevare e aggiungere correttamente il viso.
• Dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), posizione testa grande o occlusioni grandi causeranno errori.
• L'aggiunta o l'eliminazione di visi da/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 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.

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

Restituisce

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 valore persistedFaceId che rappresenta il viso aggiunto. Nessuna immagine verrà archiviata. Solo la funzionalità viso estratta verrà archiviata nel server fino a quando non viene chiamato FaceList - Delete Face o FaceList - Delete .
Nota persistedFaceId è diverso da faceId generato da Face - Detect.

• Maggiore qualità dell'immagine del viso significa una migliore precisione di rilevamento e riconoscimento. Si prega di considerare i visi di alta qualità: frontale, chiaro e dimensione del viso è 200x200 pixel (100 pixel tra gli occhi) o superiore.
• 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 Face - Detect, non esiste alcuna garanzia per rilevare e aggiungere correttamente il viso.
• Dimensioni del viso non rilevabili (36x36 - 4096x4096 pixel), posizione testa grande o occlusioni grandi causeranno errori.
• L'aggiunta o l'eliminazione di visi da/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 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.

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

Restituisce

Promise<FaceListAddFaceFromUrlResponse>

Promise<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, nome, userData e recognitionModel facoltativi. 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 Face - Find Similar.
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 visi simili a celebrità, il filtro del viso simile o l'identificazione del viso in modo chiaro. Tuttavia, se l'uso effettivo consiste nell'identificare la persona, usare PersonGroup / LargePersonGroup e Face - Identify.
Considerare LargeFaceList quando il numero del viso è elevato. Può supportare fino a 1.000.000 visi.
'recognitionModel' deve essere specificato per l'associazione a questo elenco di 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 funzionalità del viso esistenti in un elenco dei 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

Restituisce

Promise<RestResponse>

Promise<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/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 valore persistedFaceId di un viso esistente.

options

RequestOptionsBase

Parametri facoltativi

Restituisce

Promise<RestResponse>

Promise<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 valore 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 valore 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

Restituisce

Promise<RestResponse>

Promise<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 visi.

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

Restituisce

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)

Elencare i visi faceListId, nome, userData e recognitionModel.
Per ottenere informazioni sui visi all'interno di faceList, usare FaceList - Get

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

Parametri

options

FaceListListOptionalParams

Parametri facoltativi

Restituisce

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

Restituisce

Promise<RestResponse>

Promise<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