Pular navegação

Conexão automática de um vídeo incorporado à IFrame API

Atualizado: 12.08.2026
Abrir como Markdown

Normalmente, você cria um player por create() . Se já houver um iframe na página, conecte a API a ele automaticamente.

Siga estas etapas:

  1. Adicione o parâmetro de URL ?auto ao script da IFrame Player API.
  2. Adicione o parâmetro de URL ?enableIframeApi ao src de cada <iframe> de vídeo.
O handler onKinescopeIframeAPIReady é executado quando cada player é criado. Se a página tiver vários vídeos com enableIframeApi, assine playerFactory.Events.Created para processar todas as instâncias.

Exemplo

<!doctype html>
<html>
  <head>
    <!-- Script da IFrame Player API com o parâmetro ?auto:
         todos os elementos <iframe> correspondentes na página se conectam à API.
         defer executa o script após a análise do HTML. -->
    <script defer src="https://player.kinescope.io/latest/iframe.player.js?auto"></script>

    <script>
      function onKinescopeIframeAPIReady(playerFactory) {
        playerFactory.on(playerFactory.Events.Created, ({ data: player }) => {
          player.setVolume(0.5)
        })
      }
    </script>
  </head>
  <body>
    <!-- enableIframeApi permite a conexão com a IFrame API -->
    <iframe
      src="https://kinescope.io/embed/VIDEO_ID?enableIframeApi"
      allow="autoplay; fullscreen; picture-in-picture; encrypted-media; gyroscope; accelerometer; clipboard-write; screen-wake-lock;"
      style="border: none;"
    ></iframe>
  </body>
</html>

Próximos passos