Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Comprendere le operazioni relative alle immagini e ai video di Rekognition
Amazon Rekognition offre due set di API principali per l'analisi di immagini e video:
-
Amazon Rekognition Image: questa API è progettata per l'analisi delle immagini.
-
Amazon Rekognition Video: questa API si concentra sull'analisi dei video archiviati e in streaming.
Entrambe le API sono in grado di rilevare varie entità come volti e oggetti. Per una comprensione completa dei tipi di confronto e rilevamento supportati, consulta la sezione dedicata. Comprendere i tipi di analisi di Rekognition
Operazioni di Immagini Amazon Rekognition
Le operazioni di Amazon Rekognition Image sono sincrone. L'input e la risposta sono in formato JSON. Le operazioni di Immagini Amazon Rekognition analizzano un'immagine di input in formato .jpg o .png. L'immagine trasmessa a un'operazione di Immagini Amazon Rekognition Image può essere archiviata in un bucket Amazon S3. Se non utilizzi l'AWS CLI, puoi anche passare byte di immagini codificate Base64 direttamente a un'operazione Amazon Rekognition. Per ulteriori informazioni, consulta Lavorare con le immagini.
Operazioni di Video Amazon Rekognition
L'API Amazon Rekognition Video facilita l'analisi dei video archiviati in un bucket Amazon S3 o trasmessi in streaming tramite Amazon Kinesis Video Streams.
Per le operazioni relative ai video archiviati, tieni presente quanto segue:
-
Le operazioni sono asincrone.
-
L'analisi deve essere avviata con un'operazione «Start» (ad esempio, StartFaceDetectionper il rilevamento dei volti nei video memorizzati).
-
Lo stato di completamento dell'analisi viene pubblicato su un argomento di Amazon SNS.
-
Per recuperare i risultati di un'analisi, usa l'operazione «Get» corrispondente (ad esempio, GetFaceDetection).
-
Per ulteriori informazioni, consultate Lavorare con l'analisi video memorizzata.
Per l'analisi dei video in streaming:
-
Le funzionalità includono la ricerca facciale nelle raccolte Rekognition Video e il rilevamento di etichette (oggetti o concetti).
-
I risultati dell'analisi per le etichette vengono inviati come notifiche Amazon SNS e Amazon S3.
-
I risultati della ricerca facciale vengono inviati a un flusso di dati Kinesis.
-
La gestione dell'analisi dei video in streaming viene effettuata tramite un processore di streaming Amazon Rekognition Video (ad esempio, creando un processore utilizzando). CreateStreamProcessor
-
Per ulteriori informazioni, consulta Lavorare con gli eventi video in streaming.
Ogni operazione di analisi video restituisce i metadati relativi al video analizzato, oltre a un ID del lavoro e un tag di lavoro. Operazioni come il rilevamento delle etichette e la moderazione dei contenuti per i video consentono l'ordinamento per timestamp o nome dell'etichetta e l'aggregazione dei risultati per timestamp o per segmento.
Non-storage e operazioni basate sullo storage
Le operazioni di Amazon Rekognition sono raggruppate nelle seguenti categorie.
-
Non-storage Operazioni API: in queste operazioni, Amazon Rekognition non conserva alcuna informazione. Si forniscono immagini e video di input, l'operazione esegue l'analisi e restituisce i risultati, ma nulla viene salvato da Amazon Rekognition. Per ulteriori informazioni, consulta Non-storage operazioni.
-
Storage-based Operazioni API: i server Amazon Rekognition possono archiviare le informazioni facciali rilevate in contenitori noti come raccolte. Amazon Rekognition fornisce ulteriori operazioni API che è possibile utilizzare per cercare le informazioni sui volti mantenute per le corrispondenze dei volti stessi. Per ulteriori informazioni, consulta Storage-based operazioni API.
Utilizzo dell'AWS SDK o di HTTP per richiamare le operazioni API di Amazon Rekognition
È possibile chiamare le operazioni API di Amazon Rekognition utilizzando l'AWS SDK o direttamente tramite HTTP. A meno che non si abbia una buona ragione per non farlo, è consigliato sempre utilizzare l'SDK AWS. Gli esempi di Java in questa sezione utilizzano l'SDK AWS. Non viene fornito un file di progetto Java, ma è possibile utilizzare AWS Toolkit for Eclipse per sviluppare applicazioni AWS utilizzando Java.
Negli esempi di .NET riportati in questa sezione viene utilizzato AWS SDK per .NET. È possibile utilizzare AWS Toolkit for Visual Studio per sviluppare applicazioni AWS tramite .NET. Include modelli utili e AWS Explorer per l'implementazione delle applicazioni e la gestione dei servizi.
La documentazione di riferimento API di questa guida riguarda la procedura di chiamata delle operazioni di Amazon Rekognition con HTTP. Per le informazioni di riferimento su Java, consulta AWS SDK per Java.
Gli endpoint del servizio Amazon Rekognition che è possibile utilizzare sono documentati su regioni ed endpoint AWS.
Quando si richiama Amazon Rekognition con HTTP, utilizzare le operazioni POST HTTP.
