Créer des flux et ingérer des données

La première étape de l'analyse de vos données vidéo avec une application consiste à créer un pipeline pour le flux continu de données. Les flux permettent d'ingérer des données vidéo en temps réel, qui peuvent ensuite être utilisées comme entrée pour les modèles ou stockées dans un entrepôt.

Créer un flux

Pour pouvoir diffuser des données vidéo, vous devez d'abord créer un flux.

La première fois que vous créez un flux dans un nouveau projet, cela peut prendre un certain temps. Ce délai est d'environ 30 minutes. Ce délai est nécessaire au système pour initialiser un cluster de calcul pour les calculs ultérieurs.

Console

Créez un flux dans la console Google Cloud .

  1. Ouvrez l'onglet Flux du tableau de bord Vision de Gemini Enterprise Agent Platform.

    Accéder à l'onglet "Flux"

  2. Cliquez sur Enregistrer.

  3. Saisissez le nom du flux et sélectionnez une région. Vous pouvez cliquer sur Ajouter une ligne pour enregistrer plusieurs flux en même temps.

  4. Cliquez sur le bouton Enregistrer pour créer un ou plusieurs flux.

Ingérer des vidéos

Une fois le flux créé, vous pouvez commencer à ingérer des données à l'aide de ce flux.

Certaines limites et considérations s'appliquent aux vidéos ingérées :

  • La source vidéo d'entrée doit respecter les spécifications suivantes :

    Si la vidéo ne répond pas à ces spécifications, il est possible que Gemini Enterprise Agent Platform Vision ne traite pas correctement l'entrée.

  • L'audio est supprimé lors de l'ingestion.
  • Si le flux fait partie d'une application connectée à un entrepôt, les paramètres vidéo (tels que la FPS ou la résolution) doivent être identiques pour l'ensemble du flux. Les variations dans les paramètres de données vidéo RTSP ou de données vidéo locales ne sont pas acceptées.
  • En raison de la latence de démarrage du modèle, il est possible que les premières secondes du contenu des vidéos ingérées soient manquantes. Cette durée peut atteindre 15 secondes.
  • L'arrêt de l'ingestion peut se produire après une longue connexion (environ cinq heures en moyenne). L'outil vaictl ne permet pas de se reconnecter. Les utilisateurs doivent le faire manuellement.
  • Bien que vaictl soit un outil utile pour ingérer des données vidéo, il ne gère pas automatiquement la récupération en cas d'erreurs réseau. Ces erreurs peuvent provenir de la source de données ou de l'ingestion Cloud. Il incombe à l'utilisateur de créer un script de redémarrage pour gérer les arrêts inattendus des opérations vaictl.

SDK Vision Gemini Enterprise Agent Platform

Pour envoyer une requête afin d'ingérer des données vidéo à l'aide d'un flux existant, vous devez installer le SDK Vision de Gemini Enterprise Agent Platform.

Effectuez les substitutions de variables suivantes :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • LOCATION_ID : ID de zone géographique. Exemple :us-central1 En savoir plus Régions où le service est disponible.
  • LOCAL_FILE.EXT : nom d'un fichier vidéo local. Exemple : my-video.mp4.
  • STREAM_ID : ID du flux que vous avez créé dans le cluster (par exemple, input-1).
  • RTSP_ADDRESS : adresse de votre flux Real Time Streaming Protocol (RTSP). Par exemple, rtsp://my-ip-camera.

Données vidéo locales :

# 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

Données vidéo locales (en boucle) :

# 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

Données du flux Real-Time Streaming Protocol (RTSP) :

# 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

Lire des vidéos ingérées

Une fois que vous avez créé un flux et envoyé du contenu vidéo, vous pouvez le lire.

Si vous laissez l'onglet de la vue du flux ouvert pendant plus d'une heure, vous devez actualiser la page pour continuer à charger le contenu vidéo.

Console

Regardez la vidéo ingérée dans la console Google Cloud .

  1. Ouvrez l'onglet Flux du tableau de bord Vision de Gemini Enterprise Agent Platform.

    Accéder à l'onglet "Flux"

  2. Cliquez sur le nom du flux dans la liste des flux.

  3. La page d'informations sur le flux vidéo affiche automatiquement la vue en direct de la vidéo ingérée.