Cómo crear transmisiones y transferir datos

El primer paso para analizar tus datos de video con una aplicación es crear una canalización para el flujo continuo de datos. Streams ofrece la capacidad de transferir datos de video en tiempo real, que luego se pueden usar como entrada para los modelos o almacenarse en un almacén.

Crea una transmisión

Para poder transmitir datos de video, primero debes crear una transmisión.

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

Console

Crea una transmisión en la consola de Google Cloud .

  1. Abre la pestaña Streams del panel de Vision de Gemini Enterprise Agent Platform.

    Ir a la pestaña Flujos

  2. Haz clic en Registrar.

  3. Ingresa el nombre de la transmisión y selecciona una región. Puedes hacer clic en Agregar fila para registrar varias transmisiones al mismo tiempo.

  4. Haz clic en el botón Registrar para crear una o más transmisiones.

Transfiere videos

Después de crear un flujo, puedes comenzar a transferir datos a través de él.

Se aplican algunas limitaciones y consideraciones al video que se sube:

  • La fuente de video de entrada debe tener las siguientes especificaciones:

    Si el video no cumple con estas especificaciones, es posible que Gemini Enterprise Agent Platform Vision no procese bien la entrada.

  • Se descarta el audio durante la transferencia.
  • Si la transmisión forma parte de una app conectada a un almacén, los parámetros de video (como los FPS o la resolución) deben ser los mismos para toda la transmisión. No se admiten variaciones en los parámetros de datos de video RTSP ni en los parámetros de datos de video locales.
  • Debido a la latencia de inicio del modelo, es posible que falten los primeros segundos de contenido en los videos que se hayan transferido. Este tiempo puede alcanzar hasta quince segundos.
  • La finalización de la transferencia puede ocurrir después de una conexión prolongada (alrededor de 5 horas, en promedio). La herramienta vaictl no tiene capacidad de reconexión, por lo que los usuarios deben reconectarse manualmente.
  • Si bien vaictl es una herramienta útil para transferir datos de video, no controla automáticamente la recuperación de errores de red. Estos errores pueden provenir del lado de la fuente de datos o del lado de la transferencia a Cloud. Es responsabilidad del usuario crear una secuencia de comandos de reinicio para controlar las finalizaciones inesperadas de la operación vaictl.

SDK de Vision de Agent Platform de Gemini Enterprise

Para enviar una solicitud para transferir datos de video con una transmisión existente, debes instalar el SDK de Vision de Gemini Enterprise Agent Platform.

Realiza las siguientes sustituciones de variables:

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

Datos de video 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 video locales (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 del feed 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 videos transferidos

Después de crear una transmisión y enviarle contenido de video, puedes reproducir el contenido de video.

Si dejas abierta la pestaña de vista de transmisión por más de una hora, debes actualizar la página para seguir cargando el contenido de video.

Console

Reproduce el video transferido en la consola de Google Cloud .

  1. Abre la pestaña Streams del panel de Vision de Gemini Enterprise Agent Platform.

    Ir a la pestaña Flujos

  2. Haz clic en el nombre del flujo en la lista de flujos.

  3. En la página de detalles de la transmisión de video por Internet, se carga automáticamente la vista en vivo del video transferido.