Você pode incorporar qualquer vídeo do Loom diretamente nos seus artigos usando o código de embed que o Loom gera. Diferente de algumas plataformas, o Loom oferece um código embeded pronto a ser usado que funciona em todos os três editores do Document360 sem necessidade de modificação de URL.
Quando usar embeds de Tear
- Gravações de tela e guias: incorpore uma gravação do Tear junto a um procedimento para oferecer aos leitores uma demonstração visual sem deixar o artigo.
- Comunicação em equipe assíncrona: incorpore vídeos da Loom em artigos da base de conhecimento interna para compartilhar contexto, anúncios ou explicações em formato de vídeo.
- Substituindo explicações longas escritas: para fluxos de trabalho complexos de interface, um vídeo embutido do Loom pode comunicar em segundos o que levaria vários parágrafos para descrever.
Referência rápida
O Loom gera o código de embeds para você. O exemplo abaixo mostra como é um código típico de embed do Loom; o seu próprio ID de vídeo contém.
<div style="position: relative; padding-bottom: 41.66666666666667%; height: 0;">
<iframe src="https://www.loom.com/embed/982aa03ae70544ddaf5e390722edf9d2"
frameborder="0"
webkitallowfullscreen
mozallowfullscreen
allowfullscreen
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;">
</iframe>
</div>
A padding-bottom porcentagem controla a proporção de aspecto do contêiner de vídeo. Loom define isso automaticamente com base no tamanho que você escolher.
Como incorporar um vídeo de Loom
Obtenha o código de embeds do Loom
- Vá até o Loom e abra o vídeo que você quer incorporar.
- Clique em Compartilhar > Incorporar.
- Selecione a caixa de seleção Tamanho Fixo e escolha o tamanho desejado do vídeo.
- Clique em Copiar código de incorporação.
Cole o código embeded no Document360
O próximo passo depende do editor que você está usando:
| Editor | Etapas |
|---|---|
| Editor Markdown | Cole o código de incorporação copiado diretamente no editor no local desejado. |
| Editor WYSIWYG | Clique em Inserir vídeo > Código incorporado. Cole o código e clique em Inserir. |
| Editor WYSIWYG avançado | Clique em Inserir > Vídeo > Incorporar código. Cole o código e clique em Adicionar embed. |
O vídeo do Loom agora está incorporado ao seu artigo.
Exemplo
Código de incorporação:
<div style="position: relative; padding-bottom: 41.66666666666667%; height: 0;">
<iframe src="https://www.loom.com/embed/982aa03ae70544ddaf5e390722edf9d2"
frameborder="0"
webkitallowfullscreen
mozallowfullscreen
allowfullscreen
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;">
</iframe>
</div>
Saída:
Escopo e cobertura
| Item | Detalhes |
|---|---|
| Incorporar código fonte | Gerado pelo Loom, não é necessária modificação manual de URL |
| Opções de tamanho | Tamanho fixo (selecionado no Loom) ou responsivo (padrão) |
| Suporte ao editor | Markdown, WYSIWYG e Advanced WYSIWYG, os passos variam de editor para editor |
| Proporção de aspecto | Controlado pela padding-bottom porcentagem no código embed. |
Melhores práticas
- Use Tamanho fixo para layout previsível: a opção Tamanho fixo no Loom define dimensões explícitas no código de incorporação, o que produz um resultado consistente entre navegadores. O padrão responsivo preenche a largura do contêiner, que pode variar dependendo do layout do seu artigo.
- Verifique as configurações de privacidade de vídeo antes de incorporar: Os vídeos do Loom podem ser configurados como privados, públicos ou apenas para ambientes de trabalho. Um vídeo privado não será assistido por leitores fora do seu espaço de trabalho no Loom. Certifique-se de que o vídeo esteja configurado como público ou com o nível de compartilhamento apropriado antes de incorporar.
- Prefira o fluxo avançado de embeds WYSIWYG ao invés de colar HTML bruto: usar o código Insert > Video > Embed mantém o bloco de vídeo devidamente estruturado dentro do editor. Colar HTML bruto diretamente pode funcionar, mas pode ser mais difícil de editar ou mover depois.
- Adicione uma breve descrição acima ou abaixo do embed: leitores que usam tecnologias assistivas ou configurações restritivas do navegador podem não conseguir visualizar vídeos incorporados. Um resumo de uma frase do que o vídeo cobre garante que o conteúdo seja acessível a todos os leitores.
- Mantenha as gravações do Loom concisas: vídeos incorporados que são muito longos reduzem a chance de os leitores assistirem. Para artigos de base de conhecimento, procure vídeos com menos de 3 minutos e use capítulos ou carimbos de tempo na gravação do Tear se o conteúdo for complexo.