SDK de cliente web

Importante
SDK web actualizado. Ahora se sirve desde https://video.standard.vonage.com/v2/js/opentok.min.js. Problemas solucionados en Safari 15.4 y 15.5. Las versiones 15.4 y 15.5 de Safari (que se incluyen con iOS 15.4 y 15.5 y macOS 12.3 y 12.4) corrigen los siguientes problemas, que podrían afectar a las aplicaciones que utilizan OpenTok.js (en Safari):
Problemas de audio al utilizar determinados modelos de auriculares Bluetooth. En algunos modelos de auriculares Bluetooth, el audio puede fallar. Este Error de WebKit se ha corregido en Safari 15.4.
Problemas de eco al cambiar de micrófono en macOS Safari. Al cambiar el micrófono utilizado por un editor, podía producirse un eco del audio del editor. El eco no aparecía en el lado del abonado. Este Error de WebKit se ha corregido en Safari 15.5.
Error crítico al publicar vídeo H.264 en sesiones enrutadas en iOS 15.1. En iOS 15.1, la publicación de vídeo H.264 en sesiones enrutadas fallaba. Este Error de WebKit se ha corregido en Safari 15.4. El volumen de audio bajo es iOS Safari. Este Error de WebKit se ha corregido en Safari 15.4.

Cifrado de extremo a extremo: En OpenTok.js 2.27.0, el cifrado de extremo a extremo no funcionará con clientes que utilicen versiones anteriores de OpenTok.js. Cuando actualices tu aplicación para usar OpenTok.js 2.27.0+, asegúrate de que todos los clientes estén usando OpenTok.js 2.27.0+ si la aplicación utiliza cifrado de extremo a extremo.

Visión general

Todas las Applications que usan la Video API de Vonage están compuestas por dos partes:

  • El lado del cliente, que utiliza los SDK de cliente de Vonage Video y se ejecuta en el navegador o la aplicación móvil del usuario.
  • La parte del servidor, que utiliza el SDK del servidor de vídeo de Vonage y se ejecuta en su servidor para pasar información de autenticación al cliente

El Client SDK para crear aplicaciones basadas en web que utilicen la Video API de Vonage es OpenTok.js. Esta biblioteca JavaScript proporciona la mayor parte de la funcionalidad básica para su aplicación, incluyendo:

  • Conectarse a una sesión
  • Publicación de flujos en una sesión
  • Suscripción a flujos en una sesión

Todos los SDK de cliente de Vonage Video podrán interactuar entre sí. Puedes obtener más información sobre los aspectos básicos de los clientes, servidores, sesiones y más de Vonage Video en nuestro Descripción general de la Video API página.

Puedes encontrar la referencia del SDK web de la API de Video de Vonage aquí.

Cargando OpenTok.js

Para cargar OpenTok.js en tu página web, añade la siguiente etiqueta script:

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

También puede instalar OpenTok.js utilizando el archivo @vonage/client-sdk-video paquete npm.

Visite el Guía de referencia para ver todos los métodos disponibles para el SDK de OpenTok.js.

La versión actual de la biblioteca OpenTok.js puede interoperar con aplicaciones de Vonage Video escritas con la versión 2.31+ de los SDK del cliente de Vonage Video:

  • OpenTok.js (Web)
  • SDK para Android
  • SDK para iOS
  • SDK para Windows
  • SDK para macOS
  • SDK para Linux
  • SDK de React Native

Compatibilidad con navegadores

La biblioteca OpenTok.js es compatible actualmente con:

  • Google Chrome (última versión)
  • Google Chrome para Android (última versión)
  • Google Chrome para iOS (última versión)
  • Firefox (última versión)
  • Firefox para Android (última versión)
  • Compatibilidad beta con Firefox para iOS (última versión)
  • Microsoft Edge versiones 79+ para Windows y macOS (versiones de Edge basadas en Chromium)
  • Safari 11+ en macOS e iOS. Para obtener información sobre la interoperabilidad de vídeo y otras cuestiones, consulte el Compatible con el navegador Safari página.
  • Opera (sólo la última versión de escritorio)
  • Electron (última versión)
  • Samsung Internet (última versión)
  • WebView Android API nivel 36+
  • WebView en iOS 18.6+

Compatible con Safari

Apple ha añadido compatibilidad con WebRTC en Safari 11 para macOS y Safari en iOS 11, y ya se pueden utilizar aplicaciones OpenTok.js en Safari.

Además, Safari 12.1 es compatible con el códec de vídeo VP8, además de H.264. Safari 12.1 es compatible con VP8 en macOS 10.14.4, y también está disponible para macOS 10.13.6 y 10.12.6. Además, está disponible en la última versión de iOS 12.2. Y está disponible en la última versión de iOS 12.2.

Debes utilizar la versión 2.16.0 o posterior de OpenTok.js para utilizar el códec de vídeo VP8 en Safari.

Para obtener más información sobre la compatibilidad con códecs de vídeo, consulte este enlace guía del desarrollador.

Limitaciones

Las siguientes son limitaciones de OpenTok.js en Safari:

  • La publicación de vídeos para compartir pantalla no es compatible con Safari en iOS ni con Safari 12 y versiones anteriores en macOS. Es compatible con Safari 13+ en macOS.
  • Safari no admite el acceso a la cámara (o la publicación de secuencias) en páginas cargadas mediante los esquemas http: (inseguro) o file: (sistema de archivos) URI. Debe servir la página a través de https: (seguro). Sin embargo, puede activar una bandera para soportar HTTP (para pruebas).
  • Safari no admite el acceso a la cámara en localhost. Debe utilizar 0.0.0.0:xx (donde xx es el número de puerto, por ejemplo 80).
  • El cifrado de extremo a extremo no puede funcionar en Safari cuando se abren las herramientas para desarrolladores.

Versiones anteriores

Las versiones más antiguas de Safari utilizan exclusivamente el códec de vídeo H.264, por lo que no son compatibles con el códec de vídeo VP8.

En sesiones enrutadas (sesiones que utilizan el Media Router), debe utilizar un proyecto con el códec preferido configurado en H.264, para que las versiones anteriores de Safari puedan publicar y suscribirse al vídeo. Establezca el códec de vídeo preferido para un proyecto en la página Proyecto de su cuenta de la Video API.

En un sesión enrutada (una sesión que utiliza el enrutador de medios OpenTok) en un proyecto que tiene el códec de video preferido configurado en VP8 (no H.264), los clientes que utilizan versiones anteriores de Safari pueden utilizar la plataforma de video de Vonage pero sin soporte de video.

Requisitos del sistema

Para una transmisión de vídeo fiable en los navegadores modernos, asegúrate de que tu dispositivo cumple estas especificaciones recomendadas:

  • CPU: Un procesador reciente de doble núcleo; uno de cuatro núcleos (por ejemplo, Intel Core i5 / Ryzen 5) o mejor para 1080p o multitarea pesada.
  • GPU: Gráficos integrados modernos (Intel UHD/Iris Xe o AMD Radeon o Nvidia Graphics) para 1080p; se recomienda encarecidamente la compatibilidad con decodificación de hardware para codificación de vídeo.
  • RAM: Al menos 8 GB para el streaming diario; 16 GB recomendados si mantienes muchas pestañas o apps abiertas.
  • Almacenamiento: SSD preferido para carga rápida y capacidad de respuesta del sistema.
  • Red: Conectividad a Internet fiable; funciona a través de Wi-Fi, Ethernet o móvil.
  • Otros: La aceleración de hardware debe estar activada en el navegador para un rendimiento óptimo.

Estas recomendaciones garantizan una reproducción estable, un menor uso de la CPU y un rendimiento fluido al transmitir vídeo.

Numbers de versión

Puedes incluir la librería OpenTok.js en tu página web utilizando una etiqueta <script> etiqueta:

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

El número de versión de OpenTok.js consta de tres partes:

  • El número de versión principal - Este número (el primero) se incrementa cuando hay una nueva versión que incluye un cambio en la API que no es compatible con versiones anteriores.
  • El número de versión menor - Este número (el segundo) se incrementa cuando hay una nueva versión que añade nuevas funcionalidades.
  • El número de parche - Este número (el tercero) se incrementa cuando hay una nueva versión que corrige errores o mejora el rendimiento sin añadir nuevas funcionalidades.

Por ejemplo, v2.4.0 es la versión mayor 2, la versión menor 4 (de la versión mayor 2) y la revisión 0 (de v2.4). A medida que se publican versiones de revisión, los cambios se incluyen en la revisión menor raíz. Por ejemplo, cuando se publica la v2.2.3, sus cambios se incluyen en la v2.2.

Para hacer referencia a una revisión concreta, puede incluir el número de versión completo (como "v2.4.0") en el campo src . Sin embargo, te recomendamos que especifiques sólo el número de versión principal. Vonage admite oficialmente la versión actual de la biblioteca. Si estás cargando una versión anterior, te pedimos que la actualices para aprovechar las últimas correcciones de errores y funciones de la plataforma de video de Vonage.

Importante: Utilice siempre las bibliotecas que le proporcionamos sin modificar. Esto garantiza que utilices el último código actualizado y probado. La Video API de Vonage no admite el uso de bibliotecas modificadas.

Para saber cuándo estarán disponibles las nuevas versiones de OpenTok.js, suscríbete a la API de Video de Vonage Anuncios foro.