O que é uma incorporação de vídeo?
Uma incorporação de vídeo insere mídia reproduzível em uma página web ou aplicação por meio de um elemento de vídeo, iframe ou componente de player. Sua configuração controla a origem, a apresentação, o comportamento e as permissões.
Como funcionam as incorporações de vídeo
Uma incorporação é tanto um limite de integração quanto um player visual. Um elemento de mídia nativo permite que a página hospedeira selecione as fontes e se inscreva diretamente em eventos, enquanto um iframe delega o comportamento de documentos, scripts e armazenamento a outra origem. Componentes de player podem encapsular qualquer uma dessas abordagens e expor uma API de aplicação mais restrita. A incorporação ocorre na etapa de apresentação, depois que a mídia foi codificada e disponibilizada para acesso, mas a segurança e o layout da página ainda influenciam o funcionamento da reprodução.
Informações essenciais
- Um iframe de outra origem não pode ser controlado por acesso direto ao DOM; a página hospedeira e o player devem trocar mensagens definidas e validar tanto a origem do remetente quanto a estrutura da mensagem.
- As declarações de permissão do iframe podem controlar recursos como reprodução automática, tela cheia ou reprodução criptografada. Assim, a omissão de permissões pode desativar recursos que, de outra forma, seriam compatíveis.
- Um contêiner responsivo deve reservar a proporção desejada antes de o player carregar; caso contrário, o dimensionamento do iframe ou do vídeo pode causar deslocamentos de layout e recortes incorretos.
Quando as incorporações de vídeo são importantes
Escolha um iframe para isolar o provedor ou um elemento nativo para ter maior controle no nível da página. Permissões restritivas, erros de dimensionamento responsivo ou políticas de cookies de terceiros podem comprometer o comportamento esperado da incorporação.