SDK de JavaScript para vídeo Release Notes
v2.36.0 — noviembre de 2026
Añadido
-
Se ha llevado a cabo la validación de iOS 27. El SDK web de Vonage se ha validado en iOS 27, lo que confirma su correcto funcionamiento en los navegadores móviles de iOS y en las aplicaciones WebView.
-
Observabilidad del cliente: información sobre las restricciones de calidad. Las estadísticas ofrecen ahora más detalles sobre por qué se limita la calidad del vídeo, tanto para los suscriptores como para los editores:
- Las estadísticas de vídeo de los suscriptores indican ahora si se está limitando la calidad del vídeo recibido y cuál es el origen de dicha limitación. La nueva
senderQualityRestrictioncaracterísticas de las estadísticas de vídeo del suscriptor (stats.video) refleja las restricciones aplicadas por el remitente inmediato (el enrutador multimedia en las sesiones enrutadas, o el editor en las sesiones retransmitidas). - El nuevo
remotePublisherQualityRestrictionEsta propiedad refleja las restricciones aplicadas por el editor de origen, como las limitaciones de CPU o de ancho de banda de enlace ascendente. - Los cambios en la restricción de calidad del remitente ahora también se notifican al abonado
videoQualityChangedcon el eventoreasoncon el valor"senderQualityRestriction". - El motivo «Condición de la red» incluye ahora dos nuevos valores, que se aplican únicamente al transporte del editor:
"noSubscribers"(la velocidad de transmisión del editor está limitada porque no hay suscriptores activos) y"downstreamConstraint"(la velocidad de transmisión del emisor viene limitada por las condiciones del receptor en el sentido descendente, normalmente cuando la retransmisión simultánea del cliente está desactivada).
Para más información, consulte esta documentación.
- Las estadísticas de vídeo de los suscriptores indican ahora si se está limitando la calidad del vídeo recibido y cuál es el origen de dicha limitación. La nueva
-
Reintento de publicación integrado. El SDK ahora vuelve a intentar automáticamente una operación que haya fallado
session.publish()cuando el fallo se debe a un error recuperable, por lo que las aplicaciones ya no necesitan implementar su propia lógica de reintento. Tres nuevas propiedades opcionales del objeto de opciones del editor (que se pasa aOT.initPublisher(), o asession.publish()(al publicar sin un editor preinicializado) controlan este comportamiento:maxPublishTimeout(por defecto15000ms) establece el tiempo máximo permitido para que la operación de publicación se complete con éxito. Mientras el temporizador está en marcha, el SDK vuelve a intentar la operación ante cualquier error recuperable. Los errores no recuperables se siguen devolviendo de forma inmediata, y se devuelve un error de tiempo de espera si este expira. Cuando se configura explícitamente, actúa como un tiempo de espera estricto. Si se deja en el valor predeterminado, el temporizador se detiene mientras el socket está desconectado y se reanuda cuando se vuelve a conectar.onRetryEs una función de devolución de llamada que se invoca cada vez que se produce un error recuperable y está a punto de realizarse un nuevo intento. Recibe el error que ha provocado el nuevo intento. Tiene carácter meramente informativo y no permite cancelar el nuevo intento.fallbackOnPartialPermission(por defectofalse), cuandotrue, permite que la publicación continúe con los dispositivos autorizados si el usuario concede acceso solo a algunos de ellos, o si se revoca el permiso de un dispositivo una vez iniciada la publicación. Los dispositivos rechazados o cuyos permisos se han revocado se notifican a través de laaccessDeniedevento. Si se rechazan todos los dispositivos solicitados, la publicación falla como antes.
Para más información, consulte esta documentación.
-
Cifrado de extremo a extremo: nuevo error cuando el cifrado no está activado. Al establecer una clave de cifrado en una sesión que no se haya creado con el cifrado de extremo a extremo activado, ahora se genera una nueva
OT_ENCRYPTION_NOT_ENABLEDerror. Anteriormente, el secreto se ignoraba sin avisar. Para obtener más información, consulta esta documentación.
Fijo
- Se ha solucionado un problema en WKWebView para iOS por el que, al aplicar un filtro de desenfoque de fondo o de sustitución de fondo con vídeo, el vídeo publicado aparecía girado 90 grados, tanto en la vista previa del editor como para los suscriptores.
- Se ha mejorado la estabilidad del filtro de vídeo de sustitución de fondo en Safari.
- Se ha mejorado la fiabilidad de los editores y los suscriptores en las sesiones que utilizan el enrutamiento adaptativo de medios, al cambiar entre conexiones retransmitidas y enrutadas.
- Se han corregido las fugas de memoria que podían producirse al crear y eliminar repetidamente editores, o al cambiar el flujo publicado.
- Se ha mejorado la reconexión automática a la sesión. Cuando el servidor rechaza un intento de reconexión con un error que no se puede solucionar, el cliente deja de intentarlo y se desconecta inmediatamente, en lugar de seguir intentándolo hasta que expire el tiempo de espera de reconexión.
- Se ha solucionado un problema por el que un editor sin fuente de audio podía generar un error al actualizar su nivel de audio.
- Se ha solucionado un problema por el que al llamar a
Subscriber.subscribeToCaptions()antes de que el suscriptor hubiera terminado de conectarse a la transmisión, podría fallar. Ahora, la llamada se aplica una vez que el suscriptor está listo.
- Se ha solucionado un problema por el que la obtención de estadísticas de WebRTC podía fallar en algunos navegadores y vistas web, lo que afectaba a la recopilación de estadísticas y a las pruebas de red. Ahora, el SDK detecta de forma más fiable la API de estadísticas compatible con el navegador.
v2.35.4 — noviembre de 2026
Fijo
- Se ha solucionado un problema por el que aparecían advertencias de obsolescencia para el
transportStatsysenderStatspropiedades estadísticas y eladdEventListenerLas API se registraban en la consola incluso cuando la aplicación no utilizaba dichas API obsoletas. Ahora, las advertencias solo aparecen cuando la aplicación utiliza una API obsoleta. Esta versión también corrige elstatsContainerpropiedad de la editorialnetworkConditionChangedevento, que ahora incluye elstats,subscriberIdyconnectionIdpropiedades, como lavideoQualityChangedevento.
v2.35.3 — octubre de 2026
Fijo
- Se ha solucionado un problema en las sesiones AMR por el que un suscriptor podía emitir un
disconnectedevento sin emitir posteriormente unconnectedevento tras restablecerse la conexión.
- Se ha solucionado un problema por el que
networkDegradationSourcesolo podría informar debothOrUnclearen sesiones 1:1 enrutadas compatibles con AMR. Ahora, cuando sea necesario, se vuelve a intentar activar las estadísticas del emisor una vez finalizada la suscripción, lo que mejora la detección de si la degradación es local o remota.
- Se ha solucionado un problema por el que el vídeo podía permanecer desactivado tras un cambio a audio alternativo y una transición al modo multimedia AMR, incluso después de que las condiciones de la red hubieran mejorado.
- Se ha solucionado un problema por el que
networkDegradationSourcepodría identificar erróneamente el origen del deterioro de la red en las conexiones entre pares (P2P).
- Se ha solucionado un problema por el que, al activar un filtro de vídeo, cambiar la resolución preferida del editor y, a continuación, desactivar y volver a activar el vídeo, se producía un efecto de zoom inesperado.
- Se ha corregido una condición de carrera que podía provocar un
OpenTok:MediaProcessor:errorerror alpublishVideo(true)se llamó mientrasapplyVideoFilter()aún estaba en curso.
- Se ha mejorado la gestión del estado de recambio de audio del suscriptor para que
networkConditionChangedinforma de las condiciones de la red de forma constante mientras la función «Subscriber Audio Fallback» está activa.
- Se han eliminado los elementos innecesarios
audioAcquisitionProblemincidentes que se producen durante la reconexión, la desconexión o un fallo de PeerConnection.
- Se ha corregido el duplicado
promisedeclaraciones en las definiciones de TypeScript que podrían provocar los errores TS2300 y TS2717 de TypeScript en proyectos que utilicen OpenTok.js 2.35.1 o 2.35.2.
- Se ha solucionado un problema por el que la opción «Audio de reserva del editor» podía permanecer activa tras llamar a
publishVideo(false)seguido inmediatamente porpublishVideo(true), lo que impedía que el vídeo se reanudara cuando mejoraban las condiciones de la red.
- Se ha solucionado un problema por el que al llamar a
publishAudio(false)durante el proceso de «Publisher Audio Fallback» podría provocar que los suscriptores recibieranvideoEnabledovideoDisabledeventos conreason=publishVideo.
- Se ha solucionado un problema por el que un suscriptor no recibía un
connectedsuceso tras la recuperación de AMR de una conexión P2P interrumpida y el retorno al modo de transmisión enrutada.
- Se ha mejorado la fiabilidad de las suscripciones en Safari 26 al ampliar el tiempo de espera para la recopilación de candidatos ICE de retransmisión, lo que ha reducido los errores de tiempo de espera 1501 y 1554.
v2.34.3 — septiembre de 2026
Fijo
- Se ha solucionado un problema por el que al recuperar estadísticas de WebRTC se podía producir un
TypeErroren WKWebView para iOS y en aplicaciones integradas con Capacitor, lo que provoca errores al recopilar estadísticas o al realizar pruebas de red.
- Se ha solucionado un problema por el que el
audioLocalCandidateType,videoLocalCandidateType,audioRemoteCandidateTypeyvideoRemoteCandidateTypeLos campos de las estadísticas de calidad de servicio (QoS) podrían mostrar valores incorrectos al utilizar el último candidato ICE en lugar del seleccionado.
- Se ha mejorado la lógica de reconexión automática para que el tiempo de espera de reconexión ya no se reinicie con cada reconexión de transporte, lo que evita que el cliente quede atrapado en un ciclo infinito de reconexiones.
- Se ha solucionado un problema por el que los filtros de vídeo, el desenfoque de fondo y la sustitución de fondo no funcionaban en Safari 27 y iOS 27.
v2.35.2 — septiembre de 2026
Fijo
- Se ha solucionado un problema por el que podía aparecer brevemente un parpadeo negro en una transmisión a la que se acababa de suscribir, justo después de suscribirse, durante las llamadas individuales en Safari.
- Se ha solucionado un problema por el que al recuperar estadísticas de WebRTC se podía producir un
TypeErroren WKWebView para iOS y en aplicaciones integradas con Capacitor, lo que provoca errores al recopilar estadísticas o al realizar pruebas de red.
- Se ha solucionado un problema en Firefox por el que, al activar y desactivar rápidamente el vídeo (llamando a
publishVideo(false)inmediatamente después depublishVideo(true)) podía hacer que el vídeo publicado quedara desactivado de forma intermitente, mostrando un recuadro negro hasta el siguiente cambio de estado.
- Se ha solucionado un problema por el que el
audioLocalCandidateType,videoLocalCandidateType,audioRemoteCandidateTypeyvideoRemoteCandidateTypeLos campos de las estadísticas de calidad de servicio (QoS) podrían mostrar valores incorrectos al utilizar el último candidato ICE en lugar del seleccionado.
- Se ha solucionado un problema por el que un suscriptor podía no iniciarse cuando la política de reproducción automática del navegador bloqueaba la reproducción de vídeo. Ahora, el suscriptor espera hasta que expire el tiempo de espera del intento de reproducción y continúa con el audio silenciado (que el usuario puede activar), en lugar de que falle la suscripción.
- Se ha mejorado la lógica de reconexión automática para que el tiempo de espera de reconexión ya no se reinicie con cada reconexión de transporte, lo que evita que el cliente quede atrapado en un ciclo infinito de reconexiones.
- Se ha solucionado un problema por el que los filtros de vídeo, el desenfoque de fondo y la sustitución de fondo no funcionaban en Safari 27 y iOS 27.