Usar a caixa de diálogo do Office para mostrar um vídeo

Reproduza um vídeo em uma caixa de diálogo do Suplemento do Office para criar experiências de usuário mais envolventes.

Vídeos em caixas de diálogo são perfeitos para:

• Tutoriais de integração que orientam os usuários pelos recursos do suplemento.
• Demonstrações de produtos que mostram a funcionalidade.
• Conteúdo de treinamento que ajuda os usuários a se atualizarem rapidamente.

Para reproduzir um vídeo em uma caixa de diálogo com a API de diálogo do Office, siga estas etapas.

1. Crie uma página de vídeo dedicada que contenha um iframe e nenhum outro conteúdo. A página deve estar no mesmo domínio que a página host. Para obter um lembrete do que é uma página host, consulte Abrir uma caixa de diálogo de uma página host.

   src No atributo do iframe, aponte para a URL de um vídeo online. O protocolo da URL do vídeo deve ser HTTPS. Neste exemplo, chamaremos esta página devideo.dialogbox.html.

   Aqui está a marcação:

   <iframe class="ms-firstrun-video__player"  width="640" height="360"
       src="https://www.youtube.com/embed/XVfOe5mFbAE?rel=0&autoplay=1"
       frameborder="0" allowfullscreen>
   </iframe>
   

2. Chame displayDialogAsync a página do host para abrir video.dialogbox.html.

3. (Opcional) Se o suplemento precisar saber quando o usuário fecha a caixa de diálogo, manipule eventos de fechamento da caixa de diálogo. Registre um manipulador para o DialogEventReceived evento e manipule o evento 12006. Para obter detalhes, consulte Erros e eventos na caixa de diálogo Office.

Veja isso em ação

Para obter um exemplo de um vídeo sendo reproduzido em uma caixa de diálogo, consulte o padrão de design de jogo americano de vídeo.

Confira também

• Usar a API da Caixa de Diálogo do Office nos suplementos do Office
• Práticas recomendadas e regras para a API de Caixa de Diálogo do Office
• Lidar com erros e eventos na caixa de diálogo do Office