Notas de la versión

Cambios que afectan el comportamiento del reproductor en tu página. Las actualizaciones de dependencias, las pruebas y el CI quedan fuera — el historial completo está en el repositorio del reproductor.

4.25.2 — 10 sep 2026

Añadido

• currentSpeed, una propiedad de solo lectura con la velocidad de reproducción actual, en la incrustación JS y en el SDK del iframe.

Corregido

• Los titulares vuelven a aparecer en la incrustación en iframe. De la 4.19.0 a la 4.25.1, la incrustación en iframe no renderizaba ningún titular en tu página, mientras las visualizaciones del titular se seguían contando.
• speed(rate) funciona en el SDK del iframe. Allí era una propiedad y no el método documentado, así que player.speed(1.5) lanzaba un error. Si tu página asignaba o leía player.speed en el SDK del iframe, llama a speed(rate) para fijar la velocidad y lee currentSpeed.

Cambiado

• En la incrustación JS, urlUpdater devuelve la URL como string, igual que el SDK del iframe, en lugar de una promesa. El código que lo espera con await sigue funcionando. Llámalo después de player:ready: antes devuelve la URL sin cambios, en lugar de esperar al reproductor.

4.25.1 — 27 ago 2026

Corregido

• Editar la lista de capítulos de un reproductor en ejecución ahora tiene efecto inmediato. La barra de progreso segmentada se vuelve a dividir y una lista de capítulos abierta se actualiza, sin recargar la página y sin cerrar el popup que abrió el espectador.

4.25.0 — 26 ago 2026

Añadido

• Capítulos. Un vídeo se puede dividir en capítulos. La barra de progreso muestra un segmento por capítulo, la barra de controles gana un botón de capítulos y el tooltip de seek muestra el nombre del capítulo bajo el puntero. Los reproductores sin capítulos se ven exactamente como antes.
• JavaScript propio en titulares HTML. Un titular puede llevar un campo js, que se ejecuta una vez, justo después de que aparece el titular. El código recibe el elemento del titular como root y el playerId. Si lanza un error, el titular se renderiza igual y el reproductor sigue reproduciendo. Consulta JS del titular.

Corregido

• El vídeo ya no aparece recortado cuando el espectador entra en pantalla completa o en el modo inmersivo mientras el autoplay todavía está en curso.

Cambiado

• El menú de velocidad y la lista de capítulos comparten un mismo popup: se abre sobre su propio botón, se desplaza cuando hay más filas de las que caben y se cierra cuando se elige una fila.

4.24.0 — 20 ago 2026

Añadido

• La miniatura del reproductor se pinta detrás del vídeo mientras carga el primer segmento, así la carga muestra el fotograma de portada en lugar de una caja negra. No ocurre cuando el Smart AutoPlay empieza en otro punto, como una vista previa personalizada o un seek con startAt.

Corregido

• Las llamadas a la acción ahora escalan según la imagen pintada y no según el ancho del vídeo, así el modo inmersivo ya no empuja los botones inferiores fuera de la pantalla.
• Se eliminó el espacio fantasma de 4px bajo un titular de imagen configurado con todos los márgenes en cero.

Cambiado

• player:ready pasa a documentarse en el elemento del reproductor y no en document. Solo el elemento vuelve a emitir el evento para un listener registrado cuando el reproductor ya está listo, así que un listener añadido tarde en document — desde un gestor de etiquetas o window.onload — nunca se ejecutaba. El evento en sí no cambió.

4.23.0 — 18 ago 2026

Añadido

• Los titulares de imagen aceptan el layout configurable (márgenes y ancho) que los titulares de texto y HTML ya aceptaban. Sin layout no cambia nada: la imagen mantiene su tamaño intrínseco y el margen inferior de antes.

Corregido

• Un titular HTML heredado cuya configuración traía un layout con márgenes nulos ya no deja la página en blanco. Los márgenes mal formados pasan a usar los valores de la hoja de estilos en lugar de lanzar un error, y un width: 0 explícito ahora se respeta.

4.22.0 — 11 ago 2026

Añadido

• El envío de analytics queda retenido mientras la página es una vista previa de enlace de Instagram. Instagram renderiza los enlaces de la bio y del perfil en una WebView en miniatura dentro de la app, que disparaba pageview sin que el visitante llegara a abrir la página e inflaba las visualizaciones frente a los clics que cuenta Meta. Una vista previa que nunca se abre ya no envía nada, y un falso positivo se libera en cuanto la ventana sale de la geometría de vista previa o el vídeo se reproduce.

Eliminado

• La métrica temporal de visibilidad player.view, publicada en la 4.20.0 para medir la diferencia con las visualizaciones reales. La retención en las vistas previas de Instagram la reemplaza.

4.21.0 — 11 ago 2026

Añadido

• Mini Player. El vídeo se separa a una esquina fija cuando el reproductor sale del área visible al desplazarse y vuelve cuando se desplaza de regreso, con un placeholder que sostiene el layout para que nada de abajo se reacomode. Incluye un botón en la barra de controles, un botón de regreso en el mini player, un espaciador de página en móvil, integración con el modo inmersivo y paridad en el SDK del iframe. Desactivado por defecto.

Cambiado

• La sesión de analytics dura 7 días en lugar de 3 horas, así un visitante que vuelve sigue en la misma sesión en lugar de contarse de nuevo.

Corregido

• Se reforzó el fallback en cookie que se usa cuando no hay localStorage ni sessionStorage: SameSite=Lax, Secure en páginas con TLS y claves y valores con percent-encoding.

4.20.3 — 31 jul 2026

Corregido

• La velocidad de reproducción sobrevive a un cambio de fuente del vídeo. Volver de una vista previa personalizada del Smart AutoPlay al vídeo principal restablecía la velocidad a 1.0 justo después de que Turbo aplicaba la velocidad configurada.

4.20.2 — 21 jul 2026

Corregido

• La sonda en segundo plano del Smart AutoPlay ya no se dispara a mitad de un gesto. Ahora escucha solo los eventos de liberación, así la reproducción con sonido ya no puede empezar entre la pulsación y la liberación, reacomodar la página y hacer que el clic caiga en <body> en lugar de la llamada a la acción que pulsó el visitante.
• El píxel de Google ya no borra el <head> de la página. Reconstruía todos los nodos del head, incluidas tus hojas de estilo, lo que dejaba la página sin estilo durante un fotograma al dar play.
• Una actualización de configuración que desactiva autoUnmute mientras la sonda está en curso ahora se respeta, en lugar de activar el sonido de todos modos.

4.20.1 — 17 jul 2026

Cambiado

• La barra de controles se renderiza una sola vez en un contenedor plano con layout controlado por CSS, así los cambios de tamaño, los cruces de breakpoint y las aperturas de menú ya no vuelven a montar los controles. También corrige el fondo de la barra en reproductores sin barra de progreso.

Corregido

• Los píxeles de Facebook y de Google ya no disparan un evento sin nombre — registrado como missing_event por Meta — cuando el nombre del evento del píxel está vacío.
• Se restauró la atribución de conversiones por vtid en las reservas del popup de iClosed, después de que iClosed empezara a cachear el iframe del modal.

4.20.0 — 14 jul 2026

Añadido

• Una métrica temporal player.view, que se disparaba una vez cuando el reproductor entraba en el área visible por primera vez, para medir la inflación de visualizaciones causada por las vistas previas de enlaces sin tocar pageview. Se eliminó en la 4.22.0, cuando se publicó la retención en las vistas previas de Instagram.