Crea stream e importa dati

Il primo passaggio nell'analisi dei dati video con un'applicazione è la creazione di una pipeline per il flusso continuo di dati. Streams offre la possibilità di importare dati video in tempo reale, che possono poi essere utilizzati come input per i modelli o archiviati in un warehouse.

Creare uno stream

Per poter eseguire lo streaming dei dati video, devi prima creare uno stream.

La prima volta che crei uno stream in un nuovo progetto, la creazione può richiedere un po' di tempo. Questo tempo è di circa 30 minuti. Questo tempo è dovuto al fatto che il sistema deve inizializzare un cluster di calcolo per i calcoli successivi.

Console

Crea uno stream nella Google Cloud console.

  1. Apri la scheda Stream della dashboard Vision di Gemini Enterprise Agent Platform.

    Vai alla scheda Stream

  2. Fai clic su Registrati.

  3. Inserisci il nome dello stream e seleziona una regione. Puoi fare clic su Aggiungi riga per registrare più stream contemporaneamente.

  4. Fai clic sul pulsante Registrati per creare uno o più stream.

Importare video

Dopo aver creato uno stream, puoi iniziare a importare i dati utilizzando questo stream.

Per i video importati si applicano alcune limitazioni e considerazioni:

  • L'origine video di input deve avere le seguenti specifiche:

    Se il video non soddisfa queste specifiche, è possibile che Vision di Gemini Enterprise Agent Platform non elabori correttamente l'input.

  • L'audio viene eliminato durante l'importazione.
  • Se lo stream fa parte di un'app connessa a un warehouse, i parametri video (ad esempio FPS o risoluzione) devono essere gli stessi per l'intero stream; le variazioni nei parametri dei dati video RTSP o nei parametri dei dati video locali non sono supportate.
  • A causa della latenza di avvio del modello, è possibile che manchino i primi secondi di contenuti dei video importati. Questo periodo di tempo può raggiungere i quindici secondi.
  • La terminazione dell'importazione può avvenire dopo una connessione lunga (in media circa 5 ore). Lo strumento vaictl non offre funzionalità di riconnessione; gli utenti devono riconnettersi manualmente.
  • Sebbene vaictl sia uno strumento utile per l'importazione di dati video, non gestisce automaticamente il ripristino dagli errori di rete. Questi errori possono provenire dal lato dell' origine dati o dal lato dell'importazione cloud. È responsabilità dell'utente creare uno script di riavvio per gestire le terminazioni impreviste dell'operazione vaictl.

SDK Vision di Gemini Enterprise Agent Platform

Per inviare una richiesta di importazione di dati video utilizzando uno stream esistente, devi installare l'SDK Vision di Gemini Enterprise Agent Platform.

Esegui le seguenti sostituzioni delle variabili:

  • PROJECT_ID: l' Google Cloud ID progetto.
  • LOCATION_ID: l'ID località. Ad esempio, us-central1. Ulteriori informazioni. Regioni supportate.
  • LOCAL_FILE.EXT: il nome file di un file video locale. Ad esempio, my-video.mp4.
  • STREAM_ID: l'ID stream creato nel cluster Ad esempio, input-1.
  • RTSP_ADDRESS: l'indirizzo del feed Real Time Streaming Protocol (RTSP). Ad esempio, rtsp://my-ip-camera.

Dati video locali:

# This command streams a video file to a stream. Streaming ends when the video ends.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT

Dati video locali (in loop):

# This command streams a video file to a stream. Video is looped into the stream until you stop the command.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send video-file to streams STREAM_ID --file-path LOCAL_FILE.EXT --loop

Dati del feed RTSP (Real Time Streaming Protocol):

# This command will send an RTSP feed into the stream.
# This command has to run in the network that has direct access to the RTSP feed.
vaictl -p PROJECT_ID \
         -l LOCATION_ID \
         -c application-cluster-0 \
         --service-endpoint visionai.googleapis.com \
send rtsp to streams STREAM_ID --rtsp-uri RTSP_ADDRESS

Riprodurre i video importati

Dopo aver creato uno stream e inviato contenuti video allo stream, puoi riprodurre i contenuti video.

Se lasci aperta la scheda della visualizzazione dello stream per più di un'ora, devi aggiornare la pagina per continuare a caricare i contenuti video.

Console

Riproduci il video importato nella Google Cloud console.

  1. Apri la scheda Stream della dashboard Vision di Gemini Enterprise Agent Platform.

    Vai alla scheda Stream

  2. Fai clic sul nome dello stream nell'elenco degli stream.

  3. Nella pagina dei dettagli dello stream video, la visualizzazione live del video importato viene caricata automaticamente.