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

Este artigo explica como reproduzir um vídeo em uma caixa de diálogo Suplemento do Office.

Observação

Este artigo presume que você esteja familiarizado com os conceitos básicos de usar a caixa de diálogo do Office, conforme descrito em Usar a API de diálogo do Office em seus Suplementos do Office.

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 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 de host, consulte Abrir uma caixa de diálogo de uma página de 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 artigo, chamaremos esta página de "video.dialogbox.html". Veja a seguir um exemplo da 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. Use uma chamada de displayDialogAsync na página host para abrir video.dialogbox.html.

3. Se o suplemento precisar saber quando o usuário fecha a caixa de diálogo, registre um manipulador para o evento DialogEventReceived e manipule o evento 12006. Para obter detalhes, confira Erros e eventos na caixa de diálogo do Office.

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