Estados do player
Os estados e as propriedades que descrevem o que o player está fazendo
A maioria dos bugs de integração vem de perguntar algo ao player antes de ele ter condição de responder. Esta página descreve os estados pelos quais o player passa e as propriedades que os reportam.
Inicialização
O elemento do player existe no seu DOM antes de o player por trás dele estar rodando. Métodos chamados nessa janela podem lançar erro, e propriedades podem devolver valores padrão em vez dos reais — duration é 0 e conversionKey é uma string vazia até o vídeo carregar.
A porteira é o player:ready no elemento customizado, e o iframe:connected no iframe. Todo o resto desta página pressupõe que você já passou por ela.
Ler o estado atual
Propriedade
Tipo
alreadyPlayed e paused respondem perguntas diferentes. paused é onde o vídeo está agora; alreadyPlayed é se o visitante chegou a iniciar. Um vídeo que tocou e foi pausado reporta paused: true e alreadyPlayed: true.
Modos em que o player pode estar
Dois estados não são sobre a posição da reprodução, e sim sobre como o player foi iniciado.
Propriedade
Tipo
O SmartAutoPlay começa o vídeo mudo, porque os navegadores recusam autoplay com áudio sem um gesto do usuário. O player anuncia a transição com smartautoplay:active, e com smartautoplay:inactive assim que o vídeo tiver tocado com áudio — seja porque o visitante tirou o mudo, seja porque ele mesmo iniciou.
Estado de conversão
O conversionKey codifica a sessão, o player e a variante, quanto foi assistido e quais variantes de recurso estão ativas. É o valor que você leva para um checkout ou formulário para amarrar a conversão ao que o visitante de fato viu.
Ele devolve string vazia antes de o player estar pronto, que é a forma mais comum de ele acabar vazio em produção. Veja Parâmetros de conversão em URLs para carregá-lo entre páginas.
Alcançar um momento do vídeo
O pitch:time dispara quando a reprodução alcança o pitch time configurado para o player no painel — o momento em que a oferta é feita. É o gatilho habitual para revelar uma chamada para ação.
Para momentos arbitrários, onTime e displayHiddenElements na referência de métodos fazem o mesmo trabalho sem pendurar um listener em todo video:timeupdate.