Primeros pasos con la API de Video de Vonage

Utiliza esta guía para poner en marcha tu primera sesión de Vonage Video rápidamente: configura tu Account y aplicación, y luego sigue las instrucciones de inicio rápido para conectarte y transmitir.

Requisitos previos

Crear un Account de Vonage

Regístrate para obtener una Account de Vonage.

Una vez que te hayas registrado, se te redirigirá a la Panel de Vonage para crear una nueva aplicación.

Crear una solicitud

Después de iniciar sesión en Panel de VonageCrea una aplicación para tu proyecto de vídeo de Vonage.

  1. En el menú de navegación de la izquierda, haz clic en Applications.
  2. Desde el Applications haga clic en Crear una nueva aplicación para crear una nueva aplicación.
  3. Indique un nombre para su proyecto.
  4. Haz clic en Generar clave pública y privada. Se generará un archivo que contenga tu clave privada. Descárgalo y guárdalo, lo necesitarás más adelante.
  5. Desplácese hacia abajo, hasta el Capacidades lista. Pulse Vídeo capacidad de.
  6. Haz clic en Generar nueva aplicación botón.

Autenticación

Una vez generada tu aplicación, deberías poder ver varias credenciales. Por ahora solo necesitas dos de ellas:

  • N.º de solicitud: Se trata de un identificador alfanumérico único para su aplicación de vídeo.
  • Clave privada: Esta clave se utiliza para Autenticación basada en JWT. Asegúrese de guardarlo en un lugar seguro.

Los necesitará para autenticar su solicitud.

Crea tu primera sesión de vídeo

Una vez que tengas listas las credenciales de tu panel de control, utiliza los SDK de cliente y servidor para crear una sesión, generar tokens y conectar tu aplicación de extremo a extremo. Sigue esta sección para comprender qué credenciales se almacenan en el servidor y cómo las utiliza el cliente para publicar y suscribirse.

Para conectar tu cliente a su sesión, necesitas:

  • ID de la aplicación y clave privada — se genera al crear la aplicación; se utiliza para la autenticación basada en JWT.
  • ID de sesión - identifica la sesión ("sala"). Véase el Guía de sesiones.
  • Token - credencial efímera que concede acceso y define el rol del cliente.

En primer lugar, tendrás que instalar el SDK de vídeo que elijas de la siguiente lista. A continuación, siga las instrucciones Inicio rápido para generar el identificador de sesión y el token utilizando la función SDK de servidorDevuélvelos al cliente, inicializa el cliente y conéctate. Véase sesiones de unión por antecedentes.

Instalar el SDK

Elija el SDK que coincida con su plataforma cliente y siga su guía de instalación:

Inicio rápido

Sigue estos pasos para pasar de las credenciales del backend a un cliente que publique y se suscriba en una sesión en directo:

  1. Crear una sesión - crear una sala única en su servidor para que los clientes se unan.
  2. Generar un token — Emitir una credencial de corta duración (rol/TTL) para cada participante.
  3. Inicializar una sesión y conectar — Configura el SDK con tu ID de aplicación y tu ID de sesión; a continuación, conéctate utilizando el token.
  4. Publicar una transmisión - cámara de captura/micrófono y enviar medios a la sesión.
  5. Suscribirse a los flujos - adjunte medios remotos a su interfaz de usuario y escuche los eventos de transmisión.

¿Aún no tienes un backend? Prueba el Entorno de pruebas de la Video API para probar las sesiones.

El futuro

  • Grabación de vídeos: Aprenda a capturar, almacenar y recuperar sesiones mediante el archivado automático o a petición.
  • Verificación de los webhooks: Proteja sus retrollamadas con firmas secretas para que pueda confiar en cada evento que reciba su aplicación.
  • Moderación de vídeos: Aplica roles, desconecta de forma forzada y silencia a los participantes para mantener el control de las sesiones.
  • Ajustes del editor: Ajusta las propiedades de la cámara, el audio y la velocidad de fotogramas para obtener una calidad óptima en cada dispositivo.
  • Configuración de los abonados: Gestione los abonados, responda a los eventos del flujo y personalice la experiencia del espectador.