Crea stream e importa dati

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

Creare uno stream

Per poter trasmettere in streaming i dati video, devi prima creare uno stream.

La prima volta che crei uno stream in un nuovo progetto, la procedura potrebbe richiedere del tempo. Il tempo di esecuzione è 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 console Google Cloud.

  1. Apri la scheda Stream della dashboard di Vertex AI Vision.

    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 Registra per creare uno o più stream.

Importare i video

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

Al video importato si applicano alcune limitazioni e considerazioni:

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

    Se il video non soddisfa queste specifiche, Vertex AI Vision potrebbe non elaborare bene l'input.

  • L'audio viene perso durante l'importazione.
  • Se lo stream fa parte di un'app collegata a un magazzino, i parametri video (ad es. 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, i video importati potrebbero non includere i primi secondi di contenuti. Questo intervallo di tempo può raggiungere i quindici secondi.
  • L'interruzione dell'importazione può verificarsi dopo una connessione prolungata (in media circa 5 ore). Non è possibile ricollegare lo strumento vaictl manualmente; gli utenti devono ricollegarsi manualmente.
  • Sebbene vaictl sia uno strumento utile per l'importazione dei dati video, non gestisce automaticamente il recupero dagli errori di rete. Questi errori possono provenire dal lato dell'origine dati o dall'importazione in Cloud. È responsabilità dell'utente creare uno script di riavvio per gestire le interruzioni impreviste delle operazioni vaictl.

SDK Vertex AI Vision

Per inviare una richiesta di importazione dei dati video utilizzando uno stream esistente, devi installare l'SDK Vertex AI Vision.

Apporta le seguenti sostituzioni delle variabili:

  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • LOCATION_ID: il tuo ID posizione. Ad esempio, us-central1. Scopri di più. Regioni supportate.
  • LOCAL_FILE.EXT: il nome di un file video locale. Ad esempio, my-video.mp4.
  • STREAM_ID: l'ID stream che hai creato nel cluster. Ad esempio, input-1.
  • RTSP_ADDRESS: l'indirizzo del feed del protocollo di streaming in tempo reale (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 aver inviato i contenuti video, puoi riprodurli.

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

Console

Riproduci il video importato nella console Google Cloud.

  1. Apri la scheda Stream della dashboard di Vertex AI Vision.

    Vai alla scheda Stream

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

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