Crear streams e ingerir datos

El primer paso para analizar los datos de vídeo con una aplicación es crear un flujo de procesamiento para el flujo continuo de datos. Streams ofrece la posibilidad de ingerir datos de vídeo en tiempo real, que luego se pueden usar como entrada para modelos o almacenar en un almacén.

Crear un flujo

Para poder transmitir datos de vídeo, primero debes crear un stream.

La primera vez que crees un flujo en un proyecto nuevo, puede que tarde un poco en crearse. Este tiempo es de unos 30 minutos. Este tiempo se debe a que el sistema necesita inicializar un clúster de computación para los cálculos posteriores.

Consola

Crea un flujo en la Google Cloud consola.

  1. Abre la pestaña Streams (Streams) del panel de control de Vertex AI Vision.

    Ve a la pestaña Streams.

  2. Haz clic en Registrarse.

  3. Introduce el nombre del flujo y selecciona una región. Puedes hacer clic en Añadir fila para registrar varias emisiones al mismo tiempo.

  4. Haz clic en el botón Registrar para crear uno o varios flujos.

Ingerir vídeos

Una vez que haya creado un flujo, podrá empezar a ingerir datos con él.

Se aplican algunas limitaciones y consideraciones al vídeo insertado:

  • La fuente de vídeo de entrada debe cumplir las siguientes especificaciones:

    Si el vídeo no cumple estas especificaciones, es posible que Vertex AI Vision no procese bien la entrada.

  • El audio se pierde durante la ingesta.
  • Si el flujo forma parte de una aplicación conectada a un almacén, los parámetros de vídeo (como los FPS o la resolución) deben ser los mismos para todo el flujo. No se admiten variaciones en los parámetros de datos de vídeo RTSP ni en los parámetros de datos de vídeo locales.
  • Debido a la latencia de inicio del modelo, es posible que falten los primeros segundos de contenido de los vídeos insertados. Este tiempo puede ser de hasta quince segundos.
  • La finalización de la ingestión puede producirse tras una conexión larga (aproximadamente 5 horas de media). La herramienta vaictl no ofrece la posibilidad de volver a conectarse, por lo que los usuarios deben hacerlo manualmente.
  • Aunque vaictl es una herramienta útil para ingerir datos de vídeo, no gestiona automáticamente la recuperación de errores de red. Estos errores pueden proceder de la fuente de datos o de la ingestión en la nube. Es responsabilidad del usuario crear una secuencia de comandos de reinicio para gestionar las finalizaciones inesperadas de la operación vaictl.

SDK de Vertex AI Vision

Para enviar una solicitud para ingerir datos de vídeo mediante un flujo ya creado, debes instalar el SDK de Vertex AI Vision.

Sustituye las siguientes variables:

  • PROJECT_ID: tu ID de proyecto Google Cloud .
  • LOCATION_ID: tu ID de ubicación. Por ejemplo, us-central1. Más información Regiones admitidas
  • LOCAL_FILE.EXT: el nombre de archivo de un archivo de vídeo local. Por ejemplo, my-video.mp4.
  • STREAM_ID: el ID de la emisión que has creado en el clúster. Por ejemplo, input-1.
  • RTSP_ADDRESS: la dirección de tu feed del protocolo de transmisión en tiempo real (RTSP). Por ejemplo, rtsp://my-ip-camera.

Datos de vídeo 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

Datos de vídeo local (en bucle):

# 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

Datos de feeds del protocolo de transmisión en tiempo real (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

Reproducir vídeos insertados

Una vez que hayas creado una emisión y enviado contenido de vídeo a ella, podrás reproducirlo.

Si dejas abierta la pestaña de la vista de la emisión durante más de una hora, debes actualizar la página para que se siga cargando el contenido de vídeo.

Consola

Reproduce el vídeo insertado en la Google Cloud consola.

  1. Abre la pestaña Streams (Streams) del panel de control de Vertex AI Vision.

    Ve a la pestaña Streams.

  2. En la lista de emisiones, haz clic en el nombre de la emisión.

  3. En la página de detalles de la transmisión de vídeo, se carga automáticamente la vista en directo del vídeo insertado.