El primer paso para analizar los 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 modelos o almacenarse en un almacén de datos.
Crea una transmisión
Para poder transmitir datos de video, primero debes crear una transmisión.
La primera vez que creas una transmisión en un proyecto nuevo, puede tardar un tiempo en crearse. Este tiempo es de alrededor de 30 minutos. Esto 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 Google Cloud consola de.
Abre la pestaña Streams del panel de Gemini Enterprise Agent Platform Vision.
Haz clic en Registrar.
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.
Haz clic en el botón Registrar para crear una o más transmisiones.
Transfiere videos
Después de crear una transmisión, puedes comenzar a transferir datos con ella.
Se aplican algunas limitaciones y consideraciones a los videos transferidos:
- La fuente de video de entrada debe tener las siguientes especificaciones:
- Codificación H.264
- Resolución <= 1080p
- ~25 FPS
Si el video no cumple con estas especificaciones, es posible que Gemini Enterprise Agent Platform Vision no procese bien la entrada.
- El audio se descarta durante la transferencia.
- Si la transmisión forma parte de una app conectada a un almacén de datos, los parámetros de video (como FPS o 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 transferidos. Esta cantidad de tiempo puede alcanzar los quince segundos.
- La finalización de la transferencia puede ocurrir después de una conexión larga
(alrededor de 5 horas, en promedio). No hay capacidad de reconexión desde la herramienta
vaictl. Los usuarios deben volver a conectarse de forma manual. - Si bien
vaictles una herramienta útil para transferir datos de video, la herramienta 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 la nube. Es responsabilidad del usuario crear una secuencia de comandos de reinicio para controlar las finalizaciones inesperadas de la operaciónvaictl.
SDK de Gemini Enterprise Agent Platform Vision
Para enviar una solicitud para transferir datos de video con una transmisión existente, debes instalar el SDK de Gemini Enterprise Agent Platform Vision.
Realiza las siguientes sustituciones de variables:
- PROJECT_ID: Es el ID del Google Cloud proyecto.
- LOCATION_ID: Es tu ID de ubicación. Por ejemplo,
us-central1. Más información. Regiones admitidas. - LOCAL_FILE.EXT: Es el nombre de archivo 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
Reproduce videos transferidos
Después de crear una transmisión y enviar contenido de video a la transmisión, puedes reproducir el contenido de video.
Si dejas abierta la pestaña de vista de transmisión durante más de una hora, debes actualizar la página para seguir cargando el contenido de video.
Console
Reproduce el video transferido en la Google Cloud consola de.
Abre la pestaña Streams del panel de Gemini Enterprise Agent Platform Vision.
Haz clic en el nombre de la transmisión en la lista de transmisiones.
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.