Notas de lançamento

Mudanças que afetam o comportamento do player na sua página. Atualizações de dependências, testes e CI ficam de fora — o histórico completo está no repositório do player.

4.25.2 — 10 set 2026

Adicionado

• currentSpeed, uma propriedade somente leitura com a velocidade de reprodução atual, no embed JS e no SDK do iframe.

Corrigido

• As headlines voltaram a aparecer no embed em iframe. Da 4.19.0 à 4.25.1, o embed em iframe não renderizava nenhuma headline na sua página, enquanto as visualizações da headline continuavam sendo contadas.
• O speed(rate) funciona no SDK do iframe. Lá ele era uma propriedade, e não o método documentado, então player.speed(1.5) lançava um erro. Se a sua página atribuía ou lia player.speed no SDK do iframe, chame speed(rate) para definir a velocidade e leia currentSpeed.

Alterado

• No embed JS, o urlUpdater devolve a URL como string, como o SDK do iframe, em vez de uma promise. Código que usa await nele continua funcionando. Chame-o depois do player:ready: antes disso ele devolve a URL sem alterações, em vez de esperar o player.

4.25.1 — 27 ago 2026

Corrigido

• Editar a lista de capítulos de um player em execução agora tem efeito imediato. A barra de progresso segmentada se redivide e uma lista de capítulos aberta se atualiza, sem recarregar a página e sem fechar o popup que o espectador abriu.

4.25.0 — 26 ago 2026

Adicionado

• Capítulos. Um vídeo pode ser dividido em capítulos. A barra de progresso mostra um segmento por capítulo, a barra de controles ganha um botão de capítulos e o tooltip de seek mostra o nome do capítulo sob o ponteiro. Players sem capítulos continuam exatamente como antes.
• JavaScript próprio em headlines HTML. Uma headline pode ter um campo js, que roda uma vez, logo depois que a headline aparece. O código recebe o elemento da headline como root e o playerId. Se ele lançar um erro, a headline é renderizada mesmo assim e o player continua tocando. Veja JS da headline.

Corrigido

• O vídeo não aparece mais cortado quando o espectador entra em tela cheia ou no modo imersivo enquanto o autoplay ainda está rodando.

Alterado

• O menu de velocidade e a lista de capítulos dividem o mesmo popup: ele abre sobre o próprio botão, rola quando há mais linhas do que cabem e fecha quando uma linha é escolhida.

4.24.0 — 20 ago 2026

Adicionado

• A thumbnail do player é pintada atrás do vídeo enquanto o primeiro segmento carrega, então o carregamento mostra o quadro de capa em vez de uma caixa preta. Não acontece quando o Smart AutoPlay começa em outro ponto, como uma prévia personalizada ou um seek com startAt.

Corrigido

• As chamadas para ação agora escalam pela imagem pintada, e não pela largura do vídeo, então o modo imersivo não empurra mais os botões de baixo para fora da tela.
• Removido o espaço fantasma de 4px sob uma headline de imagem configurada com todas as margens em zero.

Alterado

• O player:ready passa a ser documentado no elemento do player, e não no document. Só o elemento reemite o evento para um listener registrado depois que o player já está pronto, então um listener adicionado tarde no document — por um gerenciador de tags ou pelo window.onload — nunca rodava. O evento em si não mudou.

4.23.0 — 18 ago 2026

Adicionado

• Headlines de imagem aceitam o layout configurável (margens e largura) que as headlines de texto e HTML já aceitavam. Sem layout, nada muda: a imagem mantém o tamanho intrínseco e a margem inferior de antes.

Corrigido

• Uma headline HTML legada cuja configuração trazia um layout com margens nulas não deixa mais a página em branco. Margens malformadas passam a usar os valores da folha de estilos em vez de lançar um erro, e um width: 0 explícito agora é respeitado.

4.22.0 — 11 ago 2026

Adicionado

• O envio de analytics fica retido enquanto a página é uma prévia de link do Instagram. O Instagram renderiza os links da bio e do perfil numa WebView em miniatura dentro do app, que disparava pageview sem que o visitante chegasse a abrir a página e inflava as visualizações em relação aos cliques contados pela Meta. Uma prévia que nunca é aberta agora não envia nada, e um falso positivo se libera assim que a janela sai da geometria de prévia ou o vídeo toca.

Removido

• A métrica temporária de visibilidade player.view, lançada na 4.20.0 para medir a diferença em relação às visualizações reais. A retenção nas prévias do Instagram a substitui.

4.21.0 — 11 ago 2026

Adicionado

• Mini Player. O vídeo se destaca para um canto fixo quando o player sai da área visível na rolagem e volta quando a rolagem retorna, com um placeholder segurando o layout para que nada abaixo se reorganize. Vem com um botão na barra de controles, um botão de retorno no mini player, um espaçador de página no mobile, integração com o modo imersivo e paridade no SDK do iframe. Desativado por padrão.

Alterado

• A sessão de analytics dura 7 dias em vez de 3 horas, então um visitante que volta continua na mesma sessão em vez de ser contado de novo.

Corrigido

• Reforçado o fallback em cookie usado quando nem localStorage nem sessionStorage estão disponíveis: SameSite=Lax, Secure em páginas com TLS e chaves e valores com percent-encoding.

4.20.3 — 31 jul 2026

Corrigido

• A velocidade de reprodução sobrevive a uma troca de fonte do vídeo. Voltar de uma prévia personalizada do Smart AutoPlay para o vídeo principal redefinia a velocidade para 1.0 logo depois que o Turbo aplicava a velocidade configurada.

4.20.2 — 21 jul 2026

Corrigido

• A sondagem em segundo plano do Smart AutoPlay não dispara mais no meio de um gesto. Ela agora escuta só os eventos de soltura, então a reprodução com som não pode mais começar entre o toque e a soltura, reorganizar a página e fazer o clique cair no <body> em vez da chamada para ação que o visitante apertou.
• O pixel do Google não apaga mais o <head> da página. Ele reconstruía todos os nós do head, incluindo as suas folhas de estilo, o que deixava a página sem estilo por um quadro ao dar play.
• Uma atualização de configuração que desativa o autoUnmute enquanto a sondagem está em andamento agora é respeitada, em vez de ativar o som mesmo assim.

4.20.1 — 17 jul 2026

Alterado

• A barra de controles é renderizada uma vez num contêiner plano com layout controlado por CSS, então redimensionamentos, mudanças de breakpoint e aberturas de menu não remontam mais os controles. Também corrige o fundo da barra em players sem barra de progresso.

Corrigido

• Os pixels do Facebook e do Google não disparam mais um evento sem nome — registrado como missing_event pela Meta — quando o nome do evento do pixel está vazio.
• Restaurada a atribuição de conversão por vtid em agendamentos pelo popup do iClosed, depois que o iClosed passou a fazer cache do iframe do modal.

4.20.0 — 14 jul 2026

Adicionado

• Uma métrica temporária player.view, disparada uma vez quando o player entrava na área visível pela primeira vez, para medir a inflação de visualizações causada por prévias de link sem mexer no pageview. Removida na 4.22.0, quando a retenção nas prévias do Instagram foi lançada.