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à.
# Streaming tramite un GStreamer plugin
**Nota**
Amazon Rekognition Streaming Video Analysis non sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. Se desideri utilizzare Streaming Video Analysis, registrati prima di tale data. I clienti esistenti con account che hanno utilizzato questa funzionalità negli ultimi 12 mesi possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità di [Rekognition Streaming Video Analysis](https://docs.aws.amazon.com/rekognition/latest/dg/rekognition-streaming-video-analysis-availability-change.html).
Video Amazon Rekognition può analizzare un video in streaming live dalla fotocamera di un dispositivo. Per accedere all'input multimediale da una sorgente del dispositivo, è necessario installarlo. GStreamer GStreamer è un software framework multimediale di terze parti che collega tra loro sorgenti multimediali e strumenti di elaborazione nelle pipeline del flusso di lavoro. È inoltre necessario installare il [plugin Producer di Flusso di video Amazon Kinesis](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) per Gstreamer. Questo processo presuppone che tu abbia configurato correttamente le risorse Video Amazon Rekognition e Amazon Kinesis. Per ulteriori informazioni, consulta [Configurazione delle risorse Video Amazon Rekognition e Amazon Kinesis](setting-up-your-amazon-rekognition-streaming-video-resources.md).
## Fase 1: installare Gstreamer
Scarica e installa Gstreamer, un software di piattaforma multimediale di terze parti. Puoi utilizzare un software di gestione dei pacchetti come Homebrew ([Gstreamer su Homebrew](https://formulae.brew.sh/formula/gstreamer)) o scaricarlo direttamente [dal sito Web di Freedesktop](https://gstreamer.freedesktop.org/download/).
Verifica la corretta installazione di Gstreamer lanciando un feed video con un'origine di test dal tuo terminale della riga di comando.
```
$ gst-launch-1.0 videotestsrc ! autovideosink
```
## Fase 2: installare il plugin Producer di Kinesis Video Streams
In questa sezione, scaricherai la [libreria Producer di Flusso di video Amazon Kinesis](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) e installerai il plugin Gstreamer di Kinesis Video Streams.
Crea una directory e clona il codice di origine dal repository GitHub. Assicurati di includere il parametro `--recursive`.
```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```
Segui le [istruzioni fornite dalla libreria](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) per configurare e compilare il progetto. Assicurati di utilizzare i comandi specifici per la piattaforma per il sistema operativo in uso. Usa il parametro `-DBUILD_GSTREAMER_PLUGIN=ON` quando esegui `cmake` per installare il plugin Gstreamer di Kinesis Video Streams. Questo progetto richiede i seguenti pacchetti aggiuntivi inclusi nell'installazione: GCC o Clang, Curl, Openssl e Log4cplus. Se la compilazione non riesce a causa di un pacchetto mancante, verifica che il pacchetto sia installato e presente nel tuo PATH. Se riscontri l'errore "impossibile eseguire il programma compilato in C" durante la compilazione, esegui nuovamente il comando di compilazione. A volte, il compilatore C corretto non viene trovato.
Verifica l'installazione del plugin Kinesis Video Streams eseguendo il seguente comando.
```
$ gst-inspect-1.0 kvssink
```
Dovrebbero apparire le seguenti informazioni, come i dettagli di fabbrica e del plugin:
```
Factory Details:
Rank primary + 10 (266)
Long-name KVS Sink
Klass Sink/Video/Network
Description GStreamer AWS KVS plugin
Author AWS KVS
Plugin Details:
Name kvssink
Description GStreamer AWS KVS plugin
Filename /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
Version 1.0
License Proprietary
Source module kvssinkpackage
Binary package GStreamer
Origin URL http://gstreamer.net/
...
```
## Fase 3: esegui Gstreamer con il plugin Kinesis Video Streams
Prima di iniziare lo streaming dalla fotocamera di un dispositivo a Kinesis Video Streams, potrebbe essere necessario convertire l'origine multimediale in un codec accettabile per Kinesis Video Streams. Per determinare le specifiche e le funzionalità di formato dei dispositivi attualmente collegati al computer, esegui il seguente comando.
```
$ gst-device-monitor-1.0
```
Per iniziare lo streaming, avvia Gstreamer con il seguente comando di esempio e aggiungi le tue credenziali e le informazioni di Flusso di video Amazon Kinesis. Dovresti utilizzare le chiavi di accesso e la regione del ruolo di servizio IAM che hai creato [concedendo ad Amazon Rekognition l'accesso ai tuoi flussi Kinesis](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream). Per ulteriori informazioni sulle chiavi di accesso, consulta [Gestione delle chiavi di accesso per gli utenti IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) nella *Guida per l'utente IAM*. Inoltre, puoi regolare i parametri degli argomenti del formato video in base alle tue esigenze di utilizzo e disponibili sul tuo dispositivo.
```
$ gst-launch-1.0 autovideosrc device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 !
x264enc bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au,profile=baseline !
kvssink stream-name="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```
Per ulteriori comandi di avvio, consulta [Esempi di comandi di GStreamer avvio](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch).
**Nota**
Se il comando di avvio termina con un errore di mancata negoziazione, controlla l'output dal monitor del dispositivo e assicurati che i valori del parametro `videoconvert` siano funzionalità valide del tuo dispositivo.
Dopo alcuni secondi, vedrai un feed video dalla fotocamera del tuo dispositivo sul flusso video di Kinesis. Per iniziare a rilevare e abbinare i volti con Amazon Rekognition, avvia l'elaboratore di flussi Video Amazon Rekognition. Per ulteriori informazioni, consulta [Panoramica delle operazioni del processore di streaming Video Amazon Rekognition](streaming-video.md#using-rekognition-video-stream-processor).