Player de vídeo
O player de vídeo permite reproduzir vídeos em diferentes formatos de fontes externas. Isso está incluído no pacote Dashboard.
Os seguintes formatos de vídeo têm suporte. Para obter mais informações, consulte Limitações.
- MP4
- OGG
- WEBM
- YouTube
URLs usadas no player de vídeo devem ser adicionadas à lista de permissões pelo administrador de locatários no Administração de Administration. Para obter mais informações, consulte Gerenciando o Content Security Policy. Para obter exemplos de listas de permissão, consulte Exemplos de lista de permissões de player de vídeo.
Quando usar
O player de vídeo é útil quando você deseja incluir um vídeo no seu aplicativo. Por exemplo, para exibir uma demonstração ou um vídeo de treinamento, adicionar um tutorial ou apresentar notícias corporativas.
Adicionando vídeos
Você pode adicionar o objeto de player de vídeo a uma pasta que está editando. Adicione ou cole um link de vídeo no objeto de vídeo. O vídeo é transmitido de uma fonte. Ele não é carregado no Qlik Sense. Por padrão, o formato de vídeo do link será detectado automaticamente, o vídeo não será reproduzido automaticamente, e controles de vídeo estarão disponíveis para os consumidores do aplicativo.
Faça o seguinte:
- No painel de ativos do modo de edição avançada, abra Objetos personalizados > Dashboard bundle e arraste um objeto de Player de vídeo até a pasta ou clique em Adicionar à pasta.
- Adicione um vídeo como URL no campo Add URL do objeto de player de vídeo ou no painel de propriedades, em Video > URL. Você pode formatar o campo URL como uma expressão.
- Autodetect formato é a configuração padrão, e o campo se ajustará de acordo com base no URL. Você também pode desativar Autodetect e selecionar o formato de vídeo compatível correto.
Depois de adicionar o vídeo, você pode querer ajustar suas opções.
Definindo opções de vídeo
As opções de vídeo são definidas no painel Propriedades.
Clique em Auto play se quiser que o vídeo seja iniciado automaticamente quando visualizado no modo analisador. Auto play está desativado por padrão. Quando Auto play é selecionado, o vídeo é iniciado, mas é silenciado. O usuário do aplicativo precisa selecionar Unmute para ativar o som.
Clique em Ocultar controles para desativar controles de vídeo no modo analisador. Por padrão, os controles de vídeo estão visíveis.
Você pode adicionar uma Poster image. Por padrão, a imagem do pôster está desativada. Em Source, selecione um URL externo que direcione para uma imagem ou adicione uma imagem da sua biblioteca de mídia.
Se uma imagem de pôster for selecionada, ela será exibida antes da reprodução do vídeo. Poster alignment especifica como a imagem do pôster se alinhará dentro do player de vídeo.
Não é possível reproduzir o vídeo no modo de edição. O vídeo será reiniciado quando você alternar entre o modo analisador e o modo de edição.
No modo analisador, você inicia o vídeo com o botão de reprodução. É possível pausar, alternar entre silenciar e ativar o som e visualizar o vídeo em tela cheia. Você também pode compartilhar o objeto de player de vídeo e Take snapshot.
No modo de edição, o menu de contexto do botão direito fornece opções para o Qlik Sense. No modo analisador, o menu de contexto fornece opções para YouTube.
O desenvolvedor de aplicativos (modo de edição) ou o consumidor de aplicativos (modo analisador) deve permitir que vídeos YouTube sejam reproduzidos no Qlik Sense.
Personalizando o estilo
Com as Opções avançadas ativadas, você tem várias opções de estilo disponíveis em Aparência no painel de propriedades.
Clique em Estilo em Aparência > Apresentação para personalizar ainda mais o estilo do gráfico. Você pode redefinir seus estilos clicando em ao lado de cada seção. Clique em Redefinir tudo para redefinir os estilos de todas as guias disponíveis no painel de guias.
Para obter informações gerais sobre o estilo de uma visualização individual, consulte Aplicando estilo personalizado a uma visualização.
Personalizando o texto
Você pode definir o texto do título, subtítulo e nota de rodapé em Aparência > Geral. Para ocultar esses elementos, desative Mostrar títulos.
A visibilidade dos diferentes rótulos no gráfico depende das configurações específicas do gráfico e das opções de exibição do rótulo. Esses podem ser configurados no painel de propriedades.
Você pode estilizar o texto que aparece no gráfico.
Faça o seguinte:
-
Clique em Opções avançadas.
-
No painel propriedades, expanda a seção Aparência.
-
Em Aparência > Apresentação, clique em Estilo.
-
Na guia Geral, defina a fonte, o estilo de ênfase, o tamanho da fonte e a cor dos seguintes elementos de texto:
-
Título
-
Subtítulo
-
Nota de rodapé
-
Personalizando o plano de fundo
Você pode personalizar o plano de fundo do gráfico. O plano de fundo pode ser definido por cor e imagem.
Faça o seguinte:
-
Clique em Opções avançadas.
-
No painel propriedades, expanda a seção Aparência.
-
Em Aparência > Apresentação, clique em Estilo.
Na guia Geral do painel de estilo, você pode selecionar uma cor de fundo (cor única ou expressão). Você também pode definir o plano de fundo como uma imagem da sua biblioteca de mídia ou de uma URL.
Nota informativaPara adicionar uma imagem de fundo de uma URL, a origem da URL precisa ser adicionada à lista de permissões na Content Security Policy de seu locatário. A origem deve ser adicionada com a seguinte diretriz: img-src. Isso é feito por um administrador de locatários.
Para obter mais informações, consulte Criando uma entrada de CSP.
Ao usar uma cor de fundo, use o controle deslizante para ajustar a opacidade do fundo.
Ao usar uma imagem de fundo, você pode ajustar o tamanho e a posição da imagem.
Personalizando a borda e a sombra
Você pode personalizar a borda e a sombra do gráfico.
Faça o seguinte:
-
Clique em Opções avançadas.
-
No painel propriedades, expanda a seção Aparência.
-
Em Aparência > Apresentação, clique em Estilo.
-
Na guia Geral do painel de estilo, em Borda, ajuste o tamanho do Contorno para aumentar ou diminuir as linhas da borda ao redor do gráfico.
-
Selecione uma cor para a borda.
-
Ajuste o Raio do canto para controlar o arredondamento da borda.
-
Em Sobra na guia Geral, selecione um tamanho e uma cor para a sombra. Selecione Nenhum para remover a sombra.
Limitações
O player de vídeo tem as seguintes limitações:
- O Safari não oferece suporte aos formatos OGG e WEBM.
- O iPhone adiciona controles de vídeo nativos. Ele não usa controles do player de vídeo, portanto, Hide Controls não desativará os controles.
- O Android não oferece suporte ao formato OGG.
- Ao exportar ou imprimir uma pasta que contém um objeto de player de vídeo, o objeto de player de vídeo não será incluído.
Exemplos de lista de permissões de player de vídeo
A tabela a seguir fornece exemplos de lista de permissão para o player de vídeo. Para obter mais informações, consulte Gerenciando o Content Security Policy.
Nome | Origem | Diretiva |
---|---|---|
video-play-test-mp4 | file-examples-com.github.io | media-src |
wiki img src | upload.wikimedia.org | img-src, media-src |
YouTube - No cookies | www.youtube-nocookie.com | child-src, font-src, frame-ancestors, frame-src, img-src, media-src, script-src, worker-src |
YouTube | www.youtube.com | child-src, font-src, frame-ancestors, frame-src, img-src, media-src, script-src, worker-src |
YouTube - img | img.youtube.com | img-src |
webm | dl5.webmfiles.org | img-src, media-src |