Vídeo no Dynamic Media video

Esta seção descreve como trabalhar com vídeo no Dynamic Media.

Início rápido: vídeos quick-start-videos

A descrição do fluxo de trabalho passo a passo a seguir foi projetada para ajudar você a começar a usar rapidamente os conjuntos de vídeos adaptáveis no Dynamic Media. Após cada etapa, há referências cruzadas para cabeçalhos de tópicos onde você pode encontrar mais informações.

IMPORTANT
Antes de trabalhar com vídeo no Dynamic Media, verifique se o administrador do Adobe Experience Manager já ativou e configurou o Dynamic Media Cloud Service no modo Dynamic Media - Scene7 ou Dynamic Media - Híbrido.
Problema atual conhecido de reprodução de vídeo no Dynamic Media somente no Experience Manager 6.5.9.0:
  • Se um vídeo publicado for atualizado, ele deverá ser publicado novamente para refletir as alterações no delivery.
  1. Carregue seus vídeos do Dynamic Media fazendo o seguinte:

  2. Gerencie seus vídeos do Dynamic Media seguindo um destes procedimentos:

  3. Publish seus vídeos do Dynamic Media seguindo um destes procedimentos:

Trabalhar com vídeo no Dynamic Media working-with-video-in-dynamic-media

O Vídeo no Dynamic Media é uma solução completa que facilita a publicação de vídeo adaptável de alta qualidade para transmissão em várias telas, incluindo desktop, iOS, Android™, BlackBerry® e dispositivos móveis Windows. Um Conjunto de vídeos adaptados agrupa versões do mesmo vídeo codificadas em taxas de bits e formatos diferentes, como 400 kbps, 800 kbps e 1000 kbps. O computador desktop ou dispositivo móvel detecta a largura de banda disponível.

Por exemplo, em um dispositivo móvel iOS, ele detecta uma largura de banda como 3G, 4G ou Wi-Fi. Em seguida, ele seleciona automaticamente o vídeo codificado correto entre as várias taxas de bits de vídeo no Conjunto de vídeos adaptados. O vídeo é transmitido para desktops, dispositivos móveis ou tablets.

Além disso, a qualidade do vídeo é comutada automaticamente de forma dinâmica se as condições da rede forem alteradas no desktop ou no dispositivo móvel. Além disso, se um cliente entrar no modo de tela cheia em um desktop, o Conjunto de vídeos adaptados responderá usando uma resolução melhor, melhorando a experiência de visualização do cliente. O uso dos Conjuntos de vídeos adaptados oferece a melhor reprodução possível para clientes que reproduzem vídeos do Dynamic Media em várias telas e dispositivos.

A lógica que um reprodutor de vídeo usa para determinar qual vídeo codificado reproduzir ou selecionar durante a reprodução se baseia no seguinte algoritmo:

  1. O reprodutor de vídeo carrega o fragmento de vídeo inicial com base na taxa de bits mais próxima do valor definido como "taxa de bits inicial" no próprio reprodutor.

  2. O reprodutor de vídeo muda com base nas alterações na velocidade da largura de banda, usando os seguintes critérios:

    1. O player escolhe o fluxo de largura de banda mais alto abaixo ou igual à largura de banda estimada.
    2. O player considera apenas 80% da largura de banda disponível. No entanto, se estiver mudando, é mais conservador em apenas 70% para evitar superestimar e voltar imediatamente.

Para obter informações técnicas detalhadas sobre o algoritmo, consulte https://android.googlesource.com/platform/frameworks/av/+/master/media/libstagefright/httplive/LiveSession.cpp

Para gerenciar vídeos únicos e Conjuntos de vídeos adaptados, o seguinte é suportado:

  • Fazer upload de vídeo de vários formatos de vídeo e formatos de áudio suportados e codificar vídeo para o formato MP4 H.264 para reprodução em várias telas. Você pode usar predefinições predefinidas de vídeos adaptáveis, predefinições de codificação de vídeos únicos ou personalizar sua própria codificação para controlar a qualidade e o tamanho do vídeo.

    • Quando um conjunto de vídeos adaptáveis é gerado, ele inclui vídeos MP4.
    • Observação: vídeos principais/de origem não são adicionados a um Conjunto de Vídeos Adaptáveis.
  • Legendagem de vídeo em todos os visualizadores de vídeo HTML5.

  • Organize, navegue e pesquise vídeos com suporte completo a metadados para obter um gerenciamento eficiente dos ativos de vídeo.

  • Forneça Conjuntos de vídeos adaptados para a Web e para desktops e dispositivos móveis, incluindo iPhone, iPad, Android™, BlackBerry® e Windows phone.

O streaming de vídeo adaptável é suportado em várias plataformas iOS. Consulte o Guia de Referência de Visualizadores do Dynamic Media.

O Dynamic Media oferece suporte à reprodução de vídeo móvel para vídeo MP4 H.264.

Você pode encontrar dispositivos Windows compatíveis com este formato de vídeo em: Codecs de mídia compatíveis para Windows Phone 8

  • Reproduza o vídeo usando as Predefinições do visualizador de vídeo do Dynamic Media, incluindo o seguinte:

    • Visualizadores de vídeo únicos.
    • Visualizadores de mídia mista que combinam conteúdo de vídeo e imagem.
  • Configure players de vídeo para atender às suas necessidades de marca.

  • Integre vídeo ao seu site, site móvel ou aplicativo móvel com um URL simples ou código integrado.

Consulte também Visualizadores para Experience Manager Assets e Dynamic Media Classic e Visualizadores somente para ativos Experience Manager.

Prática recomendada: uso do visualizador de vídeo HTML5 best-practice-using-the-html-video-viewer

As predefinições do visualizador de vídeo Dynamic Media HTML5 são players de vídeo robustos. Você pode usá-los para evitar muitos problemas comuns associados à reprodução de vídeo HTML5. E, problemas associados a dispositivos móveis, como falta de entrega de transmissão adaptável da taxa de bits e alcance limitado do navegador do desktop.

No lado do design do reprodutor, é possível projetar a funcionalidade dele usando as ferramentas padrão de desenvolvimento na Web. Por exemplo, você pode projetar os botões, os controles e o plano de fundo personalizado da imagem de pôster usando o HTML5 e o CSS para ajudar você a alcançar seus clientes com uma aparência personalizada.

No lado da reprodução do visualizador, ele detecta automaticamente o recurso de vídeo do navegador. Em seguida, ele serve o vídeo usando HLS (HTTP Live Streaming) ou DASH (Dynamic Adaptive Streaming over HTTP) , também conhecido como transmissão adaptável de taxa de bits. Ou, se esses métodos de delivery não estiverem presentes, será usado o HTML5 progressive.

Ao combinar em um único player o seguinte:

  • A capacidade de projetar os componentes de reprodução usando HTML5 e CSS
  • Ter reprodução integrada
  • Usar transmissão adaptável e progressiva dependendo da capacidade do navegador

Estenda o alcance do seu conteúdo de mídia avançada para usuários de desktop e dispositivos móveis e garanta uma experiência em vídeo simplificada.

Consulte também Sobre visualizadores HTML5.

Reprodução de vídeo em computadores desktop e dispositivos móveis usando o visualizador de vídeo HTML5 playback-of-video-on-desktop-computers-and-mobile-devices-using-the-html-video-viewer

Para streaming de vídeo adaptável de desktop e móvel, os vídeos usados para a alternância da taxa de bits são baseados em todos os vídeos MP4 no Conjunto de vídeos adaptados.

A reprodução de vídeo ocorre usando DASH ou HLS ou download progressivo de vídeo. Em versões anteriores do Experience Manager, como 6.0, 6.1 e 6.2, os vídeos eram transmitidos via HTTP.

No Experience Manager 6.3 e posterior, os vídeos agora são transmitidos em HTTPS (ou seja, DASH ou HLS), pois o URL do serviço de gateway do DM também usa HTTPS. Não há impacto para o cliente nesse comportamento padrão. Ou seja, o streaming de vídeo sempre ocorre por HTTPS, a menos que não seja suportado pelo navegador. (Consulte a tabela a seguir). Por conseguinte,

  • Se você tiver um site HTTPS com transmissão de vídeo HTTPS, a transmissão está boa.
  • Se você tiver um site HTTP com transmissão de vídeo HTTPS, a transmissão está boa e não há problemas de conteúdo misto no navegador da Web.

DASH é o padrão internacional e HLS é um padrão da Apple. Ambos são usados para transmissão de vídeo adaptável. E ambas as tecnologias ajustam automaticamente a reprodução com base na capacidade de largura de banda da rede. Ele também permite que o cliente "procure" qualquer ponto do vídeo, sem a necessidade de aguardar o download do restante do vídeo.

O vídeo progressivo é fornecido ao baixar e armazenar o vídeo localmente no sistema de desktop de um usuário ou dispositivo móvel.

A tabela a seguir descreve o dispositivo, o navegador e o método de reprodução de vídeos em computadores desktop e dispositivos móveis que usam o Dynamic Media Video Viewer.

Device
Navegador
Modo de reprodução de vídeo
Desktop
Internet Explorer 9 e 10
Download progressivo.
Desktop
Internet Explorer 11+
No Windows 8 e Windows 10 - Forçar o uso de HTTPS sempre que DASH* ou HLS for solicitado. Limitação conhecida: HTTP no DASH* ou HLS não funciona nesta combinação de navegador/sistema operacional

No Windows 7 - Download progressivo. Usa lógica padrão para selecionar protocolo HTTP versus HTTPS.
Desktop
Firefox 23-44
Download progressivo.
Desktop
Firefox 45 ou posterior
Transmissão da taxa de bits adaptável DASH* ou HLS.
Desktop
Chrome
Transmissão da taxa de bits adaptável DASH* ou HLS.
Desktop
Safari (Mac)
Transmissão da taxa de bits adaptável HLS.
Mobile
Chrome (Android™ 6 ou anterior)
Download progressivo.
Mobile
Chrome (Android™ 7 ou posterior)
Transmissão da taxa de bits adaptável DASH* ou HLS.
Mobile
Android™ (navegador padrão)
Download progressivo.
Mobile
Safari (iOS)
Transmissão da taxa de bits adaptável HLS.
Mobile
Chrome (iOS)
Transmissão da taxa de bits adaptável HLS.
Mobile
BlackBerry®
Transmissão da taxa de bits adaptável DASH* ou HLS./td>
IMPORTANT
*Para usar o DASH para seus vídeos, primeiro ele deve ser habilitado pelo Suporte Técnico Adobe em sua conta. Consulte Habilitar DASH na sua conta do Dynamic Media.

Arquitetura da solução de vídeo da Dynamic Media architecture-of-dynamic-media-video-solution

O gráfico a seguir mostra o fluxo de trabalho geral de criação de vídeos que são carregados e codificados por meio do DMGateway (no modo híbrido do Dynamic Media) e disponibilizados para consumo público.

Arquitetura da solução de vídeo do Dynamic Media.

Arquitetura de publicação híbrida para vídeos hybrid-publishing-architecture-for-videos

Arquitetura de publicação híbrida para vídeos.

Práticas recomendadas para codificação de vídeos best-practices-for-encoding-videos

O fluxo de trabalho Codificação de vídeo do Dynamic Media codifica o vídeo se você tiver habilitado o Dynamic Media e configurado os serviços da nuvem de vídeo. Esse fluxo de trabalho captura o histórico do processo de fluxo de trabalho e as informações de falha. Se você habilitou o Dynamic Media e configurou os serviços da nuvem de vídeo, o fluxo de trabalho Codificação de vídeo do Dynamic Media será aplicado automaticamente quando você carregar um vídeo. (Se você não estiver usando o Dynamic Media, o fluxo de trabalho Ativo de atualização do DAM entrará em vigor.)

Arquivos de vídeo do Source source-video-files

Ao codificar um arquivo de vídeo, use um arquivo de vídeo de origem com a mais alta qualidade possível. Evite usar arquivos de vídeo codificados anteriormente, pois esses arquivos já estão compactados, e codificações adicionais criam um vídeo de qualidade inferior.

  • O Dynamic Media suporta principalmente vídeos de formato curto com duração máxima de 30 minutos e resolução mínima superior a 25 x 25.
  • Você pode fazer upload de arquivos de vídeo de origem principal de até 15 GB cada.

A tabela a seguir descreve o tamanho recomendado, a taxa de proporção e a taxa de bits mínima que seus arquivos de vídeo de origem devem ter antes de serem codificados:

Tamanho
Taxa de proporção
Taxa de bits mínima
1024 X 768
4:3
4500 kbps para a maioria dos vídeos.
1280 X 720
16:9
3000 - 6000 kbps, dependendo da quantidade de movimento no vídeo.
1920 X 1080
16:9
6000 - 8000 kbps, dependendo da quantidade de movimento no vídeo.

Obter os metadados de um arquivo obtaining-a-file-s-metadata

Você pode obter os metadados de um arquivo visualizando os metadados usando uma ferramenta de edição de vídeo ou um aplicativo projetado para obter metadados. A seguir estão as instruções para usar o MediaInfo, um aplicativo de terceiros, para obter os metadados de um arquivo de vídeo:

  1. Vá para Download de MediaInfo.
  2. Selecione e baixe o instalador para a versão da GUI e siga as instruções de instalação.
  3. Após a instalação, clique com o botão direito no arquivo de vídeo (somente Windows) e selecione MediaInfo, ou abra MediaInfo e arraste o arquivo de vídeo para o aplicativo. Você verá todos os metadados associados ao arquivo de vídeo, incluindo largura, altura e fps.

Taxa de proporção aspect-ratio

Ao escolher ou criar uma predefinição de codificação de vídeo para o arquivo de vídeo de origem principal, verifique se a predefinição tem a mesma proporção do arquivo de vídeo de origem principal. A taxa de proporção é a relação entre a largura e a altura do vídeo.

Para determinar a proporção de um arquivo de vídeo, obtenha os metadados do arquivo e observe a largura e a altura do arquivo (consulte Obtenção de metadados de um arquivo acima). Em seguida, use esta fórmula para determinar a proporção:

largura/altura = taxa de proporção

A tabela a seguir descreve como os resultados da fórmula são convertidos em opções comuns de taxa de proporção:

Resultado da fórmula
Taxa de proporção
1,33
4:3
0,75
3:4
1,78
16:9
0,56
9:16

Por exemplo, um vídeo com largura de 1440 x altura de 1080 tem uma taxa de proporção de 1440/1080 ou 1,33. Nesse caso, você escolhe uma predefinição de codificação de vídeo com uma proporção 4:3 para codificar o arquivo de vídeo.

Taxa de bits bitrate

Taxa de bits é a quantidade de dados codificados para compor um segundo da reprodução de vídeo. A taxa de bits é medida em kilobits por segundo (Kbps).

NOTE
Como todos os codecs usam compactação com perdas, a taxa de bits é o fator mais importante na qualidade do vídeo. Com a compactação com perdas, quanto mais você compacta um arquivo de vídeo, mais a qualidade é degradada. Por isso, todas as outras características são iguais (resolução, taxa de quadros e codec), quanto menor a taxa de bits, menor a qualidade do arquivo compactado.

Ao selecionar uma codificação de taxa de bits, há dois tipos que você pode escolher:

  • Codificação de taxa de bits constante (CBR) - Durante a codificação do CBR, a taxa de bits ou o número de bits por segundo é mantido o mesmo durante todo o processo de codificação. A codificação CBR persiste na taxa de definição de dados para sua configuração ao longo de todo o vídeo. Além disso, a codificação CBR não otimiza os arquivos de mídia para melhorar a qualidade, mas economiza espaço de armazenamento.
    Use o CBR se o vídeo tiver um nível de movimento semelhante em todo o vídeo. O CBR é usado com mais frequência para streaming de conteúdo de vídeo. Consulte também Usar parâmetros de codificação de vídeo personalizados.

  • Codificação de taxa de bits variável (VBR) - A codificação de VBR ajusta a taxa de dados para baixo e para o limite superior definido, com base nos dados exigidos pelo compactador. Essa funcionalidade significa que, durante um processo de codificação de VBR, a taxa de bits do arquivo de mídia aumenta ou diminui dinamicamente, dependendo das necessidades de taxa de bits dos arquivos de mídia.
    O VBR demora mais para codificar, mas produz os resultados mais favoráveis; a qualidade do arquivo de mídia é superior. O VBR é usado com mais frequência para entrega progressiva de conteúdo de vídeo http.

Quando você usa VBR versus CRB?
Ao selecionar VBR versus CBR, é quase sempre recomendável usar VBR para seus arquivos de mídia. O VBR fornece arquivos de maior qualidade a taxas de bits competitivas. Ao usar o VBR, certifique-se de usar o com codificação em dois passos e defina a taxa de bits máxima para 1,5 vez a taxa de bits do vídeo de destino.

Ao escolher uma predefinição de codificação de vídeo, lembre-se da velocidade de conexão do usuário final de destino. Escolha uma predefinição com uma taxa de dados que seja 80% dessa velocidade. Por exemplo, se a velocidade de conexão do usuário final de destino for 1000 Kbps, a melhor predefinição é aquela com uma taxa de dados de vídeo de 800 Kbps.

Esta tabela descreve a taxa de dados de velocidades de conexão típicas.

Velocidade (Kbps)
Tipo de conexão
256
Conexão dial-up.
800
Conexão móvel típica. Para essa conexão, direcione uma taxa de dados na faixa de 400 a no máximo 800 para experiências 3G.
2000
Conexão típica de desktop de banda larga. Para essa conexão, direcione uma taxa de dados na faixa de 800-2000 Kbps, com a média da maioria dos targets de 1200-1500 Kbps.
5000
Conexão típica de alta banda larga. A codificação nesse intervalo superior não é recomendada porque a entrega de vídeo nessa velocidade não está disponível para a maioria dos consumidores.

Resolução resolution

Resolução descreve a altura e a largura de um arquivo de vídeo em pixels. A maioria dos vídeos de origem é armazenada em alta resolução (por exemplo, 1920 x 1080). Para fins de transmissão, o vídeo de origem é compactado em uma resolução menor (640 x 480 ou menor).

Resolução e taxa de dados são dois fatores vinculados integralmente que determinam a qualidade do vídeo. Para manter a mesma qualidade de vídeo, quanto maior o número de pixels em um arquivo de vídeo (quanto maior a resolução), maior deverá ser a taxa de dados. Por exemplo, considere o número de pixels por quadro em uma resolução de 320 x 240 e um arquivo de vídeo de resolução de 640 x 480:

Resolução
Pixels por quadro
320 x 240
76.800
640 x 480
307.200

O arquivo de 640 x 480 tem quatro vezes mais pixels por quadro. Para obter a mesma taxa de dados para essas duas resoluções de exemplo, aplique quatro vezes a compactação ao arquivo 640 x 480, o que pode reduzir a qualidade do vídeo. Portanto, uma taxa de dados de vídeo de 250 Kbps produz uma visualização de alta qualidade com resolução de 320 x 240, mas não com resolução de 640 x 480.

Em geral, quanto maior a taxa de dados usada, melhor a aparência do vídeo e maior a resolução usada, maior a taxa de dados que você deve manter a qualidade da visualização (em comparação com resoluções mais baixas).

Como a resolução e a taxa de dados são vinculadas, você tem duas opções ao codificar vídeos:

  • Escolha uma taxa de dados e, em seguida, codifique na resolução mais alta que tenha uma boa aparência com a taxa de dados escolhida.
  • Escolha uma resolução e codifique na taxa de dados necessária para obter um vídeo de alta qualidade na resolução escolhida.

Ao escolher (ou criar) uma predefinição de codificação de vídeo para o arquivo de vídeo de origem principal, use essa tabela para definir a resolução correta:

Resolução
Altura (pixels)
Tamanho da tela
240p
240
Tela pequena
300p
300
Tela pequena normalmente para dispositivos móveis
360p
360
Tela pequena
480p
480
Tela do Medium
720p
720
Tela grande
1080p
1080
Tela grande de alta definição

Fps (Quadros por segundo) fps-frames-per-second

Nos Estados Unidos e no Japão, a maior parte do vídeo é filmado a 29,97 quadros por segundo (fps); na Europa, a maior parte do vídeo é filmado a 25 fps. O filme é filmado a 24 fps.

Escolha uma predefinição de codificação de vídeo que corresponda à taxa de fps do arquivo de vídeo de origem principal. Por exemplo, se o vídeo de origem principal tiver 25 qps, escolha uma predefinição de codificação com 25 qps. Por padrão, toda codificação personalizada usa o fps do arquivo de vídeo de origem principal. Por isso, não é necessário especificar explicitamente a configuração fps ao criar uma predefinição de codificação de vídeo.

Dimensões de codificação de vídeo video-encoding-dimensions

Para obter resultados ideais, selecione dimensões de codificação de forma que o vídeo de origem seja um múltiplo inteiro de todos os vídeos codificados.

Para calcular essa proporção, divida a largura da origem pela largura codificada para obter a proporção da largura. Em seguida, divida a altura da origem pela altura codificada para obter a proporção da altura.

Se a proporção resultante for um inteiro, significa que o vídeo está dimensionado de maneira ideal. Se a proporção resultante não for um número inteiro, ela afetará a qualidade do vídeo, deixando artefatos de pixel restantes na exibição. Esse efeito é mais perceptível quando o vídeo tem texto.

Por exemplo, suponha que a origem de vídeo seja 1920 x 1080. Na tabela a seguir, os três vídeos codificados fornecem as configurações de codificação ideais para usar.

Tipo de vídeo
Largura x altura
Proporção de largura
Taxa de altura
Origem
1920 x 1080
1
1
Codificado
960 x 540
2
2
Codificado
640 x 360
3
3
Codificado
480 x 270
4
4

Formato de arquivo de vídeo codificado encoded-video-file-format

A Dynamic Media recomenda usar predefinições de codificação de vídeo MP4 H.264. Como os arquivos MP4 usam o codec de vídeo H.264, ele fornece vídeo de alta qualidade, mas em um tamanho de arquivo compactado.

Habilite o suporte a DASH, várias legendas e trilha de áudio em sua conta do Dynamic Media enable-dash

Sobre a habilitação de DASH na sua conta
DASH (Digital Adaptive Streaming over HTTP) é o padrão internacional para streaming de vídeo e é amplamente adotado em diferentes visualizadores de vídeo. Quando o DASH está ativado em sua conta, você tem a opção de escolher entre DASH ou HLS para o streaming de vídeo adaptável. Ou você pode optar por ambos com a alternância automática entre players quando auto estiver selecionado como o tipo de reprodução na predefinição do Visualizador.

Alguns dos principais benefícios da ativação do DASH em sua conta incluem:

  • Vídeo de fluxo DASH do pacote para transmissão adaptável da taxa de bits. Esse método leva a uma maior eficiência do delivery. A transmissão adaptável garante a melhor experiência de visualização para seus clientes.
  • A transmissão otimizada do navegador com players do Dynamic Media alterna entre a transmissão HLS e DASH para garantir a melhor qualidade do serviço. O reprodutor de vídeo alterna automaticamente para HLS quando um navegador Safari é usado.
  • Você pode configurar seu método de transmissão preferido (HLS ou DASH) editando a predefinição do visualizador de vídeo.
  • A codificação otimizada de vídeo garante que nenhum armazenamento adicional seja usado ao ativar o recurso DASH. Um único conjunto de códigos de vídeo é criado para HLS e DASH para otimizar os custos de armazenamento de vídeo.
  • Ajuda a tornar a entrega de vídeo mais acessível para os clientes.
  • Obtenha o URL de transmissão por meio de APIs também.

A ativação do DASH na sua conta do requer duas etapas:

  • Configurar o Dynamic Media para usar o DASH, o que você mesmo pode fazer facilmente.
  • Configuração do Experience Manager 6.5 para usar o DASH, que é feito por meio de um caso de Suporte ao cliente do Adobe que você cria e envia.

Sobre a habilitação do suporte a legendas múltiplas e faixas de áudio em sua conta

Ao mesmo tempo que cria um caso de suporte para Adobe para ter o DASH ativado em sua conta, você também se beneficia de ter o suporte para múltiplas legendas e faixas de áudio ativado automaticamente. Após a ativação, todos os vídeos subsequentes carregados serão processados com uma nova arquitetura de back-end que inclui suporte para adicionar várias legendas e faixas de áudio aos vídeos.

IMPORTANT
Qualquer vídeo que você tenha carregado antes de habilitar o suporte a várias legendas e faixas de áudio na sua conta da Dynamic Media, deverá ser reprocessado. Essa etapa de reprocessamento de vídeo é necessária para que o recurso de várias legendas e faixas de áudio esteja disponível para eles. Os URLs do vídeo continuam funcionando e sendo reproduzidos como de costume, após o reprocessamento.

Para habilitar DASH, várias legendas e suporte a faixas de áudio na sua conta da Dynamic Media:

  1. Comece com configurando o Dynamic Media para DASH - No Experience Manager, navegue até Ferramentas > Operações > Console da Web.

  2. Na página Configuração do Console da Web do Adobe Experience Manager, role até o nome Sinalizador do Recurso de Streaming Avançado de Vídeo do AEM Assets Dynamic Media.

  3. À esquerda do nome, marque a caixa de seleção para ativar (ativar) DASH.

  4. Selecione Salvar.

  5. Agora use o Admin Console para iniciar a criação de um novo caso de suporte.

  6. Para criar um caso de suporte, siga as instruções enquanto garante que você forneça as seguintes informações:

    • Nome do contato principal, email, telefone.
    • Nome da sua conta do Dynamic Media.
    • Especifique se deseja que o DASH, várias legendas e suporte para faixas de áudio múltiplas seja habilitado na sua conta Dynamic Media, no Experience Manager 6.5.
  7. O Suporte ao cliente do Adobe adiciona você à Lista de espera do cliente com base na ordem em que as solicitações são enviadas.

  8. Quando o Adobe estiver pronto para lidar com sua solicitação, o Suporte ao cliente entrará em contato com você para coordenar e definir uma data limite para ativação.

  9. Você será notificado após a conclusão pelo Suporte ao cliente.

  10. Agora é possível executar um dos seguintes procedimentos:

Exibir relatórios de vídeo viewing-video-reports

NOTE
Os relatórios de vídeo só estão disponíveis quando você executa o Dynamic Media - Modo híbrido.

Os Relatórios de vídeo exibem várias métricas agregadas em um período especificado para ajudar você a monitorar se os vídeos individuais e agregados publicados estão apresentando o desempenho esperado. Os dados das principais métricas a seguir são agregados para todos os vídeos publicados em todo o site:

  • Vídeos iniciados
  • Taxa de Conclusão
  • Tempo médio em vídeo
  • Tempo total em vídeo
  • Vídeos por visita

Uma tabela de todos os vídeos publicados também está listada para que você possa acompanhar os vídeos mais vistos no seu site com base no total de vídeos iniciados.

Ao selecionar um nome de vídeo na lista, ele mostra o relatório de retenção de público-alvo (drop-off) do vídeo no formato de um gráfico de linhas. O gráfico exibe o número de visualizações em um determinado momento durante a reprodução do vídeo. Ao reproduzir o vídeo, a barra vertical é rastreada em sincronização com o indicador de tempo no reprodutor. Quedas nos dados do gráfico de linhas indicam onde o público-alvo cai de desinteresse.

Se o vídeo foi codificado fora do Adobe Experience Manager Dynamic Media, o gráfico de retenção de público-alvo (drop-off) e os dados de Porcentagem de reprodução na tabela não estarão disponíveis.

Consulte também Configurar o Dynamic Media Cloud Service.

NOTE
Os dados de rastreamento e relatórios são baseados exclusivamente no uso do próprio player de vídeo do Dynamic Media e da predefinição do player de vídeo associada. Dessa forma, você não pode rastrear e relatar vídeos que são reproduzidos por meio de outros players de vídeo.

Por padrão, na primeira vez que você insere Relatórios de vídeo, o relatório exibe os dados de vídeo começando no primeiro dia do mês atual e termina com a data do mês atual. No entanto, é possível substituir o intervalo de datas padrão especificando seu próprio intervalo de datas. Na próxima vez que você inserir Relatórios de vídeo, o intervalo de datas especificado será usado.

Para que os relatórios de vídeo funcionem corretamente, uma ID do conjunto de relatórios é criada automaticamente quando o Dynamic Media Cloud Service é configurado. Ao mesmo tempo, a ID do conjunto de relatórios é enviada para o servidor do Publish para que fique disponível para o recurso Copiar URL ao visualizar ativos. No entanto, essa funcionalidade exige que o servidor do Publish já esteja configurado. Se o servidor do Publish não estiver configurado, ainda será possível publicar para ver o relatório de vídeo. No entanto, você deve retornar à Configuração na Nuvem do Dynamic Media e selecionar OK.

Para exibir relatórios de vídeo:

  1. No canto superior esquerdo do Experience Manager, selecione o logotipo Experience Manager e, no painel à esquerda, selecione Ferramentas (ícone de martelo) > Assets > Relatórios de vídeo.

  2. Na página Relatórios de vídeo, siga um destes procedimentos:

    • Próximo ao canto superior direito, selecione o ícone Atualizar relatório de vídeo.
      Use Atualizar somente se a data final do relatório for o dia atual. Isso garante que você veja o rastreamento de vídeo que ocorreu desde a última vez que executou o relatório.

    • Próximo ao canto superior direito, selecione o ícone Seletor de datas.
      Especifique o intervalo de datas inicial e final para o qual deseja dados de vídeo e selecione Executar Relatório.

    A caixa de grupo Métricas principais identifica várias medidas agregadas para todos os vídeos publicados do site.

  3. Na tabela que lista os principais vídeos publicados, selecione um nome de vídeo para reproduzir o vídeo e também veja o relatório de retenção de público-alvo (drop-off) do vídeo.

Visualize relatórios de vídeo com base em um visualizador de vídeo criado usando o SDK do visualizador do Dynamic Media HTML5 viewing-video-reports-based-on-a-video-viewer-that-you-created-using-the-scene-hmtl-viewer-sdk

Se você usar um visualizador de vídeo pronto para uso fornecido pelo Dynamic Media ou se criar uma predefinição do visualizador personalizado com base em um visualizador de vídeo pronto para uso, nenhuma etapa adicional será necessária para exibir relatórios de vídeo. No entanto, se você tiver criado seu próprio visualizador de vídeo com base na API do SDK do visualizador do HTML5, use as seguintes etapas para garantir que seu visualizador de vídeo esteja enviando eventos de rastreamento para o Dynamic Media Video Reports.

Use o Guia de Referência do Adobe Dynamic Media Viewers e a API do SDK do HTML5 Viewer para criar seus próprios visualizadores de vídeo.

Para exibir relatórios de vídeo com base em um visualizador de vídeo criado por você usando o SDK do Visualizador do Dynamic Media HTML5:

  1. Navegue até qualquer ativo de vídeo publicado.

  2. Próximo ao canto superior esquerdo da página do ativo, na lista suspensa, selecione Visualizadores.

  3. Selecione qualquer predefinição do visualizador de vídeo e copie o código incorporado.

  4. No código incorporado, localize a linha com o seguinte:

    videoViewer.setParam("config2", "<value>");

    O parâmetro config2 permite o rastreamento em Visualizadores HTML5. Também é uma predefinição específica da empresa que contém as informações de configuração para relatórios de vídeo e configurações do Adobe Analytics para clientes específicos.

    O valor correto do parâmetro config2 foi encontrado tanto no Código Incorporado quanto na função de cópia URL. Na URL do comando de cópia URL, procure pelo parâmetro &config2=<value>. O valor é quase sempre companypreset, mas em algumas instâncias também pode ser companypreset-1, companypreset-2 e assim por diante.

  5. Em seu código de visualizador de vídeo personalizado, adicione o AppMeasurementBridge .jsp à página do visualizador fazendo o seguinte:

    • Primeiro, determine se você precisa do parâmetro &preset.

      Se o parâmetro config2 for companypreset, você não precisará de &preset=parameter.

      Se config2 for qualquer outra coisa, defina o parâmetro predefinido como igual ao parâmetro config2. Por exemplo, se config2=companypreset-2, adicione &param2=companypreset-2 ao URL AppMeasurementBridge.jsp.

    • Em seguida, adicione o script AppMeasurementBridge.jsp:

      <script language="javascript" type="text/javascript" src="https://s7d1.scene7.com/s7viewers/AppMeasurementBridge.jsp?company=robindallas&preset=companypreset-2"></script>

  6. Crie o componente TrackingManager fazendo o seguinte:

    • Depois de chamar s7sdk.Util.init();, crie uma instância de TrackingManager para rastrear eventos adicionando o seguinte:

      var trackingManager = new s7sdk.TrackingManager();

    • Conecte os componentes ao TrackingManager fazendo o seguinte:

      No manipulador de eventos s7sdk.Event.SDK_READY, anexe o componente que você deseja rastrear ao TrackingManager.

      Por exemplo, se o componente for videoPlayer, adicione

      trackingManager.attach(videoPlayer);

      para anexar o componente ao trackingManager. Para rastrear vários visualizadores em uma página, use vários componentes do gerenciador de rastreamento.

    • Crie o objeto AppMeasurementBridge adicionando o seguinte:

      code language-none
      var appMeasurementBridge = new AppMeasurementBridge(); appMeasurementBridge.setVideoPlayer(videoPlayer);
      
    • Adicione a função de rastreamento ao adicionar o seguinte:

      code language-none
      trackingManager.setCallback(appMeasurementBridge.track,
       appMeasurementBridge);
      

    O objeto appMeasurementBridge tem uma função de rastreamento integrada. No entanto, você pode fornecer o seu próprio para oferecer suporte a vários sistemas de rastreamento ou outras funcionalidades.

Sobre o suporte a várias legendas e faixas de áudio para vídeos no Dynamic Media about-msma

Com o recurso de várias legendas e faixas de áudio no Dynamic Media, é possível adicionar facilmente várias legendas e faixas de áudio a um vídeo principal. Esse recurso significa que os vídeos estão acessíveis em um público-alvo global. Você pode personalizar um único vídeo principal publicado para um público-alvo global em vários idiomas e seguir as diretrizes de acessibilidade para diferentes regiões geográficas. Os autores também podem gerenciar as legendas e faixas de áudio em uma única guia na interface do usuário do.

Guia Legendas e faixas de áudio no Dynamic Media, juntamente com uma tabela que mostra arquivos de legenda .VTT carregados e arquivos de faixa de áudio .MP3 carregados para um vídeo.

Alguns casos de uso a serem considerados para adicionar várias legendas e faixas de áudio ao vídeo principal incluem:

Tipo
Caso de uso
Legendas
Suporte a vários idiomas
Texto descritivo para acessibilidade
Faixas de áudio
Suporte a vários idiomas
Faixas de comentários
Áudio descritivo

Todos os formatos de vídeo com suporte no Dynamic Media e todos os visualizadores de vídeo do Dynamic Media, exceto o visualizador do Video_360 do Dynamic Media, têm suporte para uso com várias legendas e faixas de áudio.

O recurso de múltiplas legendas e faixas de áudio está disponível para sua conta Dynamic Media por meio de um botão de alternância de recurso que deve ser ativado pelo Suporte ao cliente do Adobe.

Adicionar várias legendas e faixas de áudio ao seu vídeo add-msma

Antes de adicionar várias legendas e faixas de áudio ao vídeo, verifique se você já tem o seguinte no local:

Legendas e legendas adicionadas são compatíveis com os formatos WebVTT e Adobe VTT. E os arquivos de trilha de áudio adicionados são suportados com o formato MP3.

IMPORTANT
Qualquer vídeo que você tenha carregado antes de habilitar o suporte a várias legendas e faixas de áudio na sua conta da Dynamic Media, deverá ser reprocessado. Essa etapa de reprocessamento de vídeo é necessária para que o recurso de várias legendas e faixas de áudio esteja disponível para eles. Os URLs do vídeo continuam funcionando e sendo reproduzidos como de costume, após o reprocessamento.

Para adicionar várias legendas e faixas de áudio ao seu vídeo:

  1. Carregue seu vídeo principal em uma pasta que já tenha um perfil de vídeo atribuído a ela.

  2. Navegue até o ativo de vídeo carregado que você deseja adicionar várias legendas e faixas de áudio.

  3. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  4. Na barra de ferramentas, selecione o ícone Propriedades (um círculo com um "i").
    Ativo de vídeo selecionado com marca de seleção sobre a imagem em miniatura do vídeo e as Propriedades de exibição realçadas na barra de ferramentas. Ativo de vídeo selecionado no modo de exibição Cartão.

  5. Na página Propriedades do vídeo, selecione a guia Legendas e faixas de áudio.

    note tip
    TIP
    Se você não vir a guia Legendas e faixas de áudio, isso significa uma destas duas coisas:
    Quando tiver concluído uma das tarefas acima, retorne a essas etapas.

    Guia Legendas e Faixas de Áudio na página Propriedades. Guia Legendas e Faixas de Áudio na página Propriedades do vídeo.

  6. (Opcional) Para adicionar um ou mais arquivos de legenda a um vídeo, faça o seguinte:

    • Selecione Carregar Legendas.

    • Navegue até um ou mais arquivos .vtt (Video Text Tracks) e selecione-os.

    • Para que as legendas fiquem visíveis no reprodutor de mídia, você deve adicionar os detalhes necessários (metadados) sobre cada arquivo de legenda que você carregou. Selecione o ícone de lápis à direita de um nome de arquivo de legenda. Na caixa de diálogo Editar Legenda, insira os seguintes detalhes necessários sobre o arquivo e selecione Salvar. Repita esse processo para cada arquivo de legenda que você carregou:

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
      Metadados da legenda Descrição
      Nome de arquivo O nome de arquivo padrão é derivado do nome de arquivo original. O nome do arquivo só pode ser alterado durante o carregamento e não pode ser alterado posteriormente. Os requisitos de caracteres de nome de arquivo são iguais para o AEM Assets.
      O mesmo nome de arquivo não pode ser usado para arquivos de legenda e de faixa de áudio adicionais.
      Idioma Selecione o idioma da legenda.
      Tipo Selecione o tipo de legenda que você está usando.
      Subtítulo - O texto da legenda exibido com o vídeo que traduz ou transcreve a caixa de diálogo.
      Legenda - O texto da legenda também inclui ruídos de fundo, diferenciação do alto-falante e outras informações relevantes, juntamente com a tradução ou transcrição da caixa de diálogo, tornando o conteúdo mais acessível para indivíduos surdos ou com deficiência auditiva.
      Rótulo O texto exibido para o nome da legenda na lista pop-up Selecionar áudio ou subtítulo no reprodutor de mídia. O rótulo é o que um cliente vê que corresponde a uma faixa de legenda ou subtítulo. Por exemplo, English (CC).

      É possível alterar ou editar os metadados da legenda posteriormente, se necessário. Quando o vídeo é publicado, esses detalhes são refletidos nos URLs públicos em vídeos publicados.

  7. (Opcional) Para adicionar uma ou mais faixas de áudio a um vídeo, faça o seguinte:

    • Selecione Carregar Faixas De Áudio.

    • Navegue até um ou mais arquivos .mp3, selecione-os e abra-os.

    • Para que as faixas de áudio fiquem visíveis na lista pop-up Selecionar áudio ou legenda no reprodutor de mídia, você deve adicionar os detalhes necessários sobre cada arquivo de faixa de áudio adicionado. Selecione o ícone de lápis à direita de um nome de arquivo de faixa de áudio. Na caixa de diálogo Editar Faixa de Áudio, insira os seguintes detalhes necessários e selecione Salvar. Repita esse processo para cada arquivo de trilha de áudio que você carregou.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
      Metadados da faixa de áudio Descrição
      Nome de arquivo O nome de arquivo padrão é derivado do nome de arquivo original. O nome do arquivo só pode ser alterado durante o carregamento e não pode ser alterado posteriormente. Os requisitos de caracteres de nome de arquivo são iguais para o AEM Assets.
      O mesmo nome de arquivo não pode ser usado para arquivos adicionais de faixa de áudio ou de legenda.
      Idioma Selecione o idioma da faixa de áudio.
      Tipo Selecione o tipo de faixa de áudio que você está usando.
      Original - A faixa de áudio originalmente anexada ao vídeo e representada como [Original] no rótulo com o idioma English selecionado por padrão. Embora seja possível alterar o Rótulo e o Idioma na caixa de diálogo Editar Faixa de Áudio, o padrão serão os valores originais se o vídeo principal for reprocessado.
      Padrão - Uma faixa de áudio complementar para um idioma diferente do original.
      Descrição de áudio - Uma faixa de áudio que também inclui uma narração descritiva de ações e gestos não verbais no vídeo, tornando o conteúdo mais acessível para indivíduos com deficiências visuais.
      Rótulo O texto que é exibido como o nome da faixa de áudio na lista pop-up Selecionar áudio ou subtítulo no reprodutor de mídia. O rótulo é o que um cliente vê que corresponde a uma faixa de áudio. Por exemplo, English [Original]. O rótulo do áudio anexado a um vídeo é definido como [Original] por padrão.

      Você pode alterar ou editar esses metadados de trilha de áudio posteriormente, se necessário. Quando o vídeo é publicado, esses detalhes são refletidos nos URLs públicos em vídeos publicados.

  8. No canto superior direito da página, na lista suspensa Salvar e fechar, selecione Salvar. Os arquivos são carregados e o processamento de metadados é iniciado, como visto na coluna Status da interface.

    note note
    NOTE
    Com base nas configurações de cache da sua instância, o processamento de metadados pode levar vários minutos antes de ser refletido na pré-visualização e nos URLs publicados.
  9. (Opcional) Se você selecionou Salvar e fechar na etapa anterior, em vez de selecionar Salvar, ainda poderá ver o status de processamento dos arquivos carregados. Consulte Exibir o status do ciclo de vida dos arquivos de legenda e trilha de áudio carregados.

  10. (Opcional) Visualize o vídeo antes da publicação para garantir que as legendas e o áudio funcionem conforme esperado. Consulte Visualizar um vídeo com várias legendas e faixas de áudio

  11. Publish o vídeo. Consulte ativos do Publish.

Sobre a adição de arquivos de legenda e trilha de áudio a um vídeo já publicado

Ao carregar arquivos de legenda adicionais ou arquivos de rastreamento de áudio para um vídeo já publicado, significa que esses arquivos terão um status Processed após serem preparados, após o upload. Nesse ponto, é possível visualizar o vídeo no Dynamic Media para ver ou ouvir os arquivos recém-carregados.

Após a visualização, no entanto, você deve publicar o vídeo novamente para que os arquivos de legenda ou trilha de áudio recém-adicionados também sejam publicados. Após a publicação, as legendas ou o áudio ficam disponíveis com o URL público do Dynamic Media.

NOTE
Com base nas configurações de armazenamento em cache da sua instância, as atualizações de metadados podem levar vários minutos antes de serem refletidas na pré-visualização e em URLs publicados.

No cenário em que você configurou o Dynamic Media para publicação imediata, o upload de arquivos de legenda ou áudio adicionais aciona imediatamente uma publicação do vídeo após o upload de arquivos de legenda ou áudio.

CAUTION
Ao carregar arquivos de legenda ou de áudio para um vídeo publicado ou não, os arquivos serão excluídos se você reprocessar o vídeo. Somente o áudio original do vídeo permanece intacto. Nesses casos, você deve fazer upload novamente dos arquivos de legenda e de trilha de áudio para o vídeo.

Adicione várias legendas a um vídeo que tenha um URL existente com modificador de legenda

O Dynamic Media permite a adição de uma única legenda com vídeo por meio de um modificador de URL. Consulte Adicionar legendas ao vídeo.

Várias alterações de legenda têm precedência sobre uma legenda adicionada por meio de um modificador de URL para vídeos publicados.

Para adicionar várias legendas a um vídeo que tenha uma URL existente com o modificador de legenda:

  1. Faça upload do arquivo de legenda que já foi adicionado como um modificador ao vídeo para que você possa gerenciar o arquivo explicitamente.
  2. Carregue quaisquer arquivos de legenda adicionais, conforme necessário.
  3. Publish o vídeo como de costume.
    O URL existente com o modificador de legenda agora pode carregar várias legendas.

Exibir o status do ciclo de vida dos arquivos de legenda e trilha de áudio carregados lifecycle-status-video

Você pode observar o status do ciclo de vida de qualquer legenda ou arquivo de trilha de áudio carregado no vídeo principal na guia Legendas e faixas de áudio das Propriedades.

Para exibir o status do ciclo de vida de um vídeo:

  1. Navegue até o ativo de vídeo cujo status do ciclo de vida você deseja exibir.
  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.
  3. Na barra de ferramentas, selecione o ícone Propriedades (um círculo com um "i").
  4. Na página Propriedades, selecione a guia Legendas e faixas de áudio. Na coluna Status, observe o estado de cada legenda ou arquivo de áudio.
Status da legenda ou da faixa de áudio
Descrição
Processamento
Quando um novo arquivo de legenda ou trilha de áudio é adicionado e salvo, ele entra em um estado de "Processamento". O Dynamic Media processa o arquivo anexando o manifesto de transmissão ao vídeo principal.
Processado
Após a conclusão do processamento, o arquivo de legenda ou trilha de áudio, ou a faixa de áudio original associada ao vídeo principal, é exibido no estado "Processado". Você pode visualizar os arquivos de legenda e faixa de áudio que aparecem como "Processados" antes de publicar o vídeo ao vivo.
Publicado
Um estado "Publicado" representa um estado semelhante a "Publicado" para um vídeo principal. Os Assets são publicados quando o vídeo principal é publicado e ficam disponíveis no URL público do Dynamic Media.
Falhou
Um estado "Com falha" significa que o processamento de uma legenda ou faixa de áudio não foi concluído. Exclua a legenda ou o arquivo de trilha de áudio e carregue novamente.
A página não publicada
Quando a publicação de um vídeo principal é cancelada explicitamente, qualquer legenda ou arquivo de trilha de áudio adicionado ao vídeo também tem sua publicação cancelada.

Coluna de status realçada para os campos Legendas e Faixas de Áudio. Status do ciclo de vida de cada legenda e arquivo de trilha de áudio carregados.

Definir o áudio padrão de um vídeo com várias faixas de áudio

Por padrão, o áudio original de um vídeo é definido como o áudio padrão a ser reproduzido.

No entanto, todos os arquivos de trilha de áudio carregados podem ser definidos como o áudio padrão a ser reproduzido depois que um vídeo é carregado no visualizador. Na interface do usuário Propriedades, na guia Legendas e faixas de áudio, o rótulo Default é aplicado à direita do arquivo de faixa de áudio para reprodução de vídeo.

NOTE
A reprodução do áudio padrão também pode depender do que está definido nos seguintes navegadores:
  • Chrome — O áudio padrão definido no vídeo é reproduzido.
  • Safari — Se o idioma padrão estiver definido no Safari, o áudio será reproduzido com o idioma padrão definido, se disponível com o manifesto do vídeo. Caso contrário, o áudio padrão definido como parte das propriedades de um vídeo será reproduzido.

Para definir o áudio padrão de um vídeo que tenha várias faixas de áudio:

  1. Navegue até o ativo de vídeo cuja faixa de áudio padrão você deseja definir.

  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  3. Na barra de ferramentas, selecione o ícone Propriedades (um círculo com um "i").

  4. Na página Propriedades, selecione a guia Legendas e faixas de áudio.

  5. No cabeçalho Faixas de áudio, selecione o arquivo de faixa de áudio que deseja definir como padrão do vídeo.

  6. Selecione Definir como padrão.
    Na caixa de diálogo Definir como padrão, selecione Substituir.

    O cabeçalho Faixas de Áudio com um nome de arquivo de faixa de áudio selecionado e o botão Definir como padrão realçado. Definindo a faixa de áudio padrão para um vídeo.

  7. No canto superior direito, selecione Salvar e fechar.

  8. Publish o vídeo. Consulte ativos do Publish.

Visualizar um vídeo com várias legendas e faixas de áudio preview-video-audio-subtitle

Depois que os arquivos de legenda e de trilha de áudio são carregados em um vídeo e processados, é possível usar o visualizador de vídeo do Dynamic Media (ou outros tipos de visualizador, se desejado) para visualizar todas as faixas diferentes. A visualização ajuda você a ver a aparência e o som do seu vídeo para os clientes e garante que ele esteja se comportando conforme esperado.

Quando estiver satisfeito com o vídeo, você poderá publicá-lo usando qualquer um dos métodos a seguir.

Consulte Incorporar o Visualizador de Vídeo ou Imagem a uma Página da Web.
Consulte Vincular URLs ao aplicativo Web. O método de vinculação baseado em URL não é possível se o conteúdo interativo tiver links com URLs relativos, principalmente links para páginas do Experience Manager Sites.
Consulte Adicionar o Dynamic Media Assets às páginas.

NOTE
A guia de visualização de Experience Manager padrão não mostra várias legendas e faixas de áudio. Isso ocorre porque essas faixas estão associadas ao Dynamic Media e só podem ser vistas usando a pré-visualização do Dynamic Media Viewer.

Para visualizar um vídeo com várias legendas e faixas de áudio:

  1. No Assets, navegue até um vídeo existente no qual você tenha adicionado várias legendas e faixas de áudio.

  2. Clique no ativo de vídeo para abri-lo no modo de visualização.

  3. Na página de visualização, próximo ao canto superior esquerdo da página, selecione a lista suspensa e, em seguida, selecione Visualizadores.

    Lista suspensa mostrando a opção Visualizadores.

  4. Na lista Visualizadores, selecione um visualizador que deseja usar para a pré-visualização do vídeo. Como exemplo, a seguinte captura de tela mostra o visualizador de Vídeo que está sendo selecionado.

    Seleção do visualizador de vídeo a partir da lista suspensa Visualizadores.

  5. Próximo ao canto inferior direito, à esquerda do ícone do volume, selecione o ícone de balão de fala e selecione o áudio ou a legenda que deseja ouvir ou ver, ou ambos. Se desejar, em Legendas, você pode selecionar Desativado para não exibir nenhuma legenda.

    A lista pop-up Áudio e Legendas no visualizador de Vídeo. Simulação de um usuário selecionando o áudio e a legenda para reprodução de vídeo.

  6. Para iniciar a reprodução, selecione o botão Reproduzir do vídeo.
    Anote os botões URL e Incorporar no canto inferior esquerdo. Use esses botões para vincular a URL do vídeo ao seu aplicativo Web ou para incorporar o vídeo em uma Página da Web, respectivamente.

  7. Próximo ao canto superior direito da página de visualização, selecione Fechar.

Excluir arquivos de legenda ou de trilha de áudio de um vídeo

É possível excluir arquivos de legenda ou de trilha de áudio de um vídeo. A exclusão de arquivos de legenda ou trilha de áudio publicados é refletida automaticamente no URL publicado do vídeo.

A faixa de áudio original extraída de um vídeo principal não pode ser excluída.

Para excluir arquivos de legenda ou de trilha de áudio de um vídeo:

  1. Navegue até o ativo de vídeo cuja faixa de áudio padrão você deseja definir.

  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  3. Na barra de ferramentas, selecione o ícone Propriedades (um círculo com um "i").

  4. Na página Propriedades, selecione a guia Legendas e faixas de áudio.

  5. Siga um destes procedimentos:

    • Legendas — No cabeçalho Legendas, selecione um ou mais arquivos de legenda que deseja excluir do vídeo e selecione Excluir.
    • Faixas de Áudio — No cabeçalho Faixas de Áudio, selecione um ou mais arquivos de faixas de áudio que deseja excluir do vídeo e selecione Excluir.
  6. Na caixa de diálogo Excluir, selecione OK.

  7. Publish o vídeo.

Baixar arquivos de legenda ou de trilha de áudio que foram carregados em um vídeo

É possível baixar um ou mais arquivos de legenda ou de trilha de áudio carregados para uso com um vídeo. Você tem a opção de baixar todos os arquivos selecionados como um .zip ou criar uma pasta de download separada para cada arquivo.

A faixa de áudio original extraída de um arquivo primário não pode ser baixada.

Para baixar arquivos de legenda ou de trilha de áudio de um vídeo:

  1. Navegue até o ativo de vídeo cuja faixa de áudio padrão você deseja definir.

  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  3. Na barra de ferramentas, selecione o ícone Propriedades (um círculo com um "i").

  4. Na página Propriedades, selecione a guia Legendas e faixas de áudio.

  5. Siga um destes procedimentos:

    • Legendas — No cabeçalho Legendas, selecione um ou mais arquivos de legenda que deseja baixar do vídeo e selecione Baixar.
    • Faixas de Áudio — No cabeçalho Faixas de Áudio, selecione um ou mais arquivos de faixas de áudio que você deseja baixar do vídeo e selecione Baixar.
  6. Na caixa de diálogo Download, defina as seguintes opções:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Opção Descrição
    Salvar como Use o nome de arquivo padrão especificado no campo de texto Salvar como ou especifique seu próprio nome.
    Criar uma pasta separada para cada ativo Crie uma pasta para cada arquivo de legenda ou de trilha de áudio selecionado para download.
    Email Use o programa de email padrão para enviar o arquivo .zip para um endereço de email especificado.
    Ativos Especifica o número de arquivos que você está baixando e o tamanho total combinado de todos os arquivos selecionados. Desmarcar esta opção esmaece (desativa) o botão Baixar, impedindo que você baixe qualquer arquivo.
  7. Selecione Baixar.

  8. Publish o vídeo. Consulte ativos do Publish.

Adicionar legendas ocultas a um vídeo adding-captions-to-video

IMPORTANT
A Adobe recomenda que você habilite o recurso de várias legendas e faixas de áudio na sua conta da Dynamic Media. Isso permite que você aproveite a arquitetura de back-end mais recente do Dynamic Media e um fluxo de trabalho simplificado para adicionar legendas, legendas e faixas de áudio aos seus vídeos.

Você pode estender o alcance de seus vídeos para mercados globais adicionando legendas ocultas a vídeos únicos ou a Conjuntos de vídeos adaptados. Ao adicionar legendas ocultas, você evita a necessidade de dublar o áudio ou a necessidade de usar alto-falantes nativos para regravar o áudio para cada idioma diferente. O vídeo é reproduzido no idioma em que foi gravado. Legendas em idiomas estrangeiros aparecem para que pessoas de diferentes idiomas ainda possam entender a parte de áudio.

As legendas ocultas também permitem maior acessibilidade para pessoas surdas ou com deficiência auditiva.

NOTE
O reprodutor de vídeo usado deve oferecer suporte à exibição de legendas.

Consulte também Acessibilidade no Dynamic Media.

O Dynamic Media converte arquivos de legenda para o formato JSON (JavaScript Object Notation). Essa conversão significa que você pode incorporar o texto JSON em uma página da Web como uma transcrição oculta, mas completa, do vídeo. Os mecanismos de pesquisa podem rastrear e indexar o conteúdo para facilitar a descoberta dos vídeos e fornecer aos clientes detalhes adicionais sobre o conteúdo do vídeo.

Consulte Conteúdo estático (não relacionado à imagem) na Ajuda da API de Disponibilização e Renderização de Imagens do Dynamic Media para obter mais informações sobre como usar a função JSON em uma URL.

Para adicionar legendas ocultas a um vídeo:

  1. Use um aplicativo ou serviço de terceiros para criar o arquivo de legenda de vídeo.

    Certifique-se de que o arquivo criado segue o padrão WebVTT (Web Video Text Tracks, Rastreamentos de texto de vídeo na Web). A extensão do nome de arquivo das legendas é .vtt. Você pode obter mais informações sobre o padrão de legendagem WebVTT.

    Consulte WebVTT: o formato de faixas de texto de vídeo da Web.

    Há muitos sites que oferecem ferramentas e serviços gratuitos e premium que você pode usar para criar arquivos de legenda/legenda WebVTT fora do Dynamic Media.

    Siga as instruções na tela de um site para criar e salvar o arquivo WebVTT. Quando terminar, copie o conteúdo do arquivo de legenda e cole-o em um editor de texto sem formatação e salve-o com uma extensão de nome de arquivo .vtt.

    note note
    NOTE
    Para o suporte global de legendas de vídeo em vários idiomas, o padrão WebVTT exige a criação de arquivos .vtt separados e chamadas para cada idioma ao qual você deseja oferecer suporte.

    Geralmente, você deseja nomear o arquivo de legenda VTT com o mesmo nome do arquivo de vídeo e anexá-lo ao idioma local, como -EN, -FR ou -DE. Ao fazer isso, ele pode ajudar você a automatizar a geração dos URLs de vídeo usando seu sistema existente de gerenciamento de conteúdo na Web.

  2. No Experience Manager, carregue seu arquivo de legenda WebVTT no DAM.

  3. Navegue até o ativo de vídeo publicado que você deseja associar ao arquivo de legenda carregado.

    Lembre-se de que os URLs só estão disponíveis para cópia depois que você publicou os ativos pela primeira vez.

    Consulte ativos do Publish.

  4. Siga uma das seguintes opções:

    • Para uma experiência de visualizador de vídeo pop-up, selecione URL. Na caixa de diálogo URL, selecione e copie o URL para a Área de transferência e, em seguida, cole o URL em um editor de texto simples. Anexe o URL copiado do vídeo com a seguinte sintaxe:

      &caption=<server_path>/is/content/<path_to_caption.vtt_file,1>

      Observe o ,1 no final do caminho da legenda. Imediatamente após a extensão de nome de arquivo .vtt no caminho, você pode ativar (ativar) ou desativar (desativar) o botão de legendas ocultas na barra do reprodutor de vídeo definindo como ,1 ou ,0, respectivamente.

    • Para uma experiência de visualizador de vídeo incorporado, selecione Código incorporado. Na caixa de diálogo Incorporar código, selecione e copie o código incorporado na Área de transferência e, em seguida, cole o código em um editor de texto simples. Anexe o código incorporado copiado com a seguinte sintaxe:

      videoViewer.setParam("caption","<path_to_caption.vtt_file,1>");

      Observe o ,1 no final do caminho da legenda. Imediatamente após a extensão de nome de arquivo .vtt no caminho, você pode ativar (ativar) ou desativar (desativar) o botão de legendas ocultas na barra do reprodutor de vídeo definindo como ,1 ou ,0, respectivamente.

Adicionar marcadores de capítulo ao vídeo adding-chapter-markers-to-video

Você pode facilitar a visualização e a navegação dos vídeos de formulário longo adicionando marcadores de capítulo a vídeos únicos ou aos Conjuntos de vídeos adaptados. Quando um usuário reproduz o vídeo, ele pode clicar nos marcadores de capítulo na linha do tempo do vídeo (também conhecido como depurador do vídeo) para navegar facilmente até o ponto de interesse. Ou eles podem acessar imediatamente novos conteúdos, demonstrações e tutoriais.

NOTE
O reprodutor de vídeo usado deve aceitar o uso de marcadores de capítulo. Os players de vídeo do Dynamic Media são compatíveis com marcadores de capítulo, mas o uso de players de vídeo de terceiros não pode.

Se desejar, você pode criar e marcar seu próprio visualizador de vídeo personalizado com capítulos em vez de usar uma predefinição do visualizador de vídeo. Para obter instruções sobre como criar seu próprio visualizador de HTML5 com navegação de capítulo, na API do SDK do Visualizador de HTML5 do Adobe, consulte o cabeçalho "Personalizando comportamentos usando modificadores" nas classes s7sdk.video.VideoPlayer e s7sdk.video.VideoScrubber. Consulte a documentação da API do SDK do Visualizador do HTML5.

Uma lista de capítulos é criada para o vídeo da mesma maneira que as legendas. Ou seja, você cria um arquivo WebVTT. Observe, no entanto, que esse arquivo deve ser separado de qualquer arquivo de legenda WebVTT que você também esteja usando; não é possível combinar legendas e capítulos em um arquivo WebVTT.

Você pode usar a seguinte amostra como exemplo do formato usado para criar um arquivo WebVTT com navegação de capítulo:

Arquivo WebVTT com navegação de capítulo de vídeo webvtt-file-with-video-chapter-navigation

WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.

No exemplo acima, Chapter 1 é o identificador de sinalização e é opcional. A hora de sinalização de 00:00:000 --> 01:04:364 especifica a hora inicial e final do capítulo, no formato 00:00:000. Os últimos três dígitos são milissegundos e podem ser deixados como 000, se preferir. O título do capítulo de The bicycle store behind it all é a descrição real do conteúdo do capítulo. O identificador de sinalização, o tempo de sinalização inicial e o título do capítulo são exibidos em um pop-up do player de vídeo quando um usuário passa o ponteiro do mouse sobre um ponto de sinalização visual na linha do tempo do vídeo.

Como você está usando um visualizador de vídeo HTML5, certifique-se de que o arquivo de capítulo criado segue o padrão WebVTT (Rastreamento de texto de vídeo da Web). A extensão de nome de arquivo do capítulo é .vtt. Você pode obter mais informações sobre o padrão de legendagem WebVTT.

Consulte WebVTT: o formato de faixas de texto de vídeo da Web

Para adicionar navegação de capítulo de vídeo:

  1. Salve o arquivo .vtt em codificação UTF8 para evitar problemas com a representação de caracteres no texto do título do capítulo.

    Geralmente, você deseja nomear o arquivo de VTT do capítulo com o mesmo nome do arquivo de vídeo e anexá-lo com capítulos. Ao fazer isso, ele pode ajudar você a automatizar a geração dos URLs de vídeo usando seu sistema existente de gerenciamento de conteúdo na Web.

  2. No Experience Manager, carregue o arquivo de capítulo WebVTT.

    Consulte Carregando Assets.

  3. Siga uma das seguintes opções:

    table 0-row-2 1-row-2 html-authored no-header
    Para uma experiência de visualizador de vídeo pop-up
    1. Navegue até o ativo de vídeo publicado que você deseja associar ao arquivo de capítulo que você carregou. Lembre-se de que os URLs só estão disponíveis para cópia depois que você publicou os ativos pela primeira vez. Consulte Publicação de Assets.
    2. No menu suspenso, clique em Visualizadores.
    3. No painel à esquerda, clique no nome da predefinição do visualizador de vídeo. Uma visualização do vídeo é aberta em uma página separada.
    4. No painel esquerdo, na parte inferior, clique em URL.
    5. Na caixa de diálogo URL, selecione e copie o URL para a Área de transferência e, em seguida, cole o URL em um editor de texto simples.
    6. Anexe a URL copiada do vídeo com a seguinte sintaxe para que você possa associá-la à URL copiada para o seu arquivo de capítulo:

      &navigation=<full_copied_URL_path_to_chapter_file.vtt>
    Para uma experiência de visualizador de vídeo inserido
    1. Navegue até o ativo de vídeo publicado que você deseja associar ao arquivo de capítulo que você carregou. Lembre-se de que os URLs só estão disponíveis para cópia depois que você publicou os ativos pela primeira vez. Consulte Publicação de Assets.
    2. No menu suspenso, clique em Visualizadores.
    3. No painel à esquerda, clique no nome da predefinição do visualizador de vídeo. Uma visualização do vídeo é aberta em uma página separada.
    4. No painel à esquerda, na parte inferior, clique em Incorporar.
    5. Na caixa de diálogo Incorporar código, selecione e copie o código inteiro para a Área de transferência e, em seguida, cole-o em um editor de texto simples.
    6. Anexe o código incorporado do vídeo com a seguinte sintaxe para que você possa associá-lo ao URL copiado para o arquivo de capítulo:

      videoViewer.setParam("navigation","<full_copied_URL_path_to_chapter_file.vtt>"

Sobre miniaturas de vídeo no modo Dynamic Media - Scene7 about-video-thumbnails-in-dynamic-media-scene-mode

Uma miniatura de vídeo é uma versão em tamanho reduzido de um quadro de vídeo ou um ativo de imagem que representa o vídeo para o cliente. A miniatura serve para incentivar o cliente a selecionar o vídeo.

Todos os vídeos no Experience Manager devem ter uma miniatura associada; não é possível excluir uma miniatura sem substituí-la. Por padrão, ao carregar um vídeo no Experience Manager, o primeiro quadro é usado como miniatura. Entretanto, é possível personalizar a miniatura para fins de marca ou pesquisa visual, por exemplo. Ao personalizar uma miniatura do vídeo, você pode reproduzi-lo e pausá-lo no quadro que deseja usar. Ou você pode selecionar um ativo de imagem que já tenha carregado e publicado no gerenciador de ativos digitais.

Uma imagem em miniatura de vídeo personalizada selecionada em um vídeo não é extraída e salva no DAM como um ativo separado e distinto. No entanto, uma miniatura de vídeo personalizada selecionada de um ativo de imagem existente é salva no JCR. O caminho do ativo selecionado é armazenado no nó do ativo de vídeo como no seguinte caminho de exemplo:

/content/dam/*<folder_name*>/<*video_name*>/jcr:content/manualThumbnail

A capacidade de personalizar uma miniatura de vídeo só estará disponível após você ter aplicado um perfil de vídeo à pasta em que o vídeo está localizado.

Consulte também Sobre miniaturas de vídeo no Dynamic Media - Modo híbrido.

Adicionar uma miniatura de vídeo personalizada adding-a-custom-video-thumbnail

Essas etapas se aplicam apenas ao Dynamic Media executado no modo "Dynamicmedia_Scene7".

Para adicionar uma miniatura de vídeo personalizada:

  1. Certifique-se de já ter feito o seguinte:

  2. Navegue até um ativo de vídeo carregado cuja imagem em miniatura você deseja alterar.

  3. No modo de seleção de ativos, em Exibição em lista ou Exibição de cartão, selecione o ativo de vídeo.

  4. Na barra de ferramentas, selecione o ícone Propriedades (um círculo contendo um "i").

  5. Na página Propriedades do vídeo, selecione Alterar miniatura.

  6. Na página Alterar miniatura, siga um destes procedimentos:

    • Para usar um quadro do vídeo como a nova miniatura:

      • Na barra de ferramentas, selecione Selecionar quadro do vídeo.
      • Selecione o botão Reproduzir e, em seguida, o botão Pausar no quadro que você deseja capturar como a nova miniatura do vídeo.
    • Para usar um ativo de imagem como a nova miniatura:

      • Na barra de ferramentas, selecione Selecionar miniatura do Assets.
      • Selecione Selecionar miniatura.
      • Navegue até um ativo de imagem carregado e publicado anteriormente que você deseja usar. O ativo é redimensionado automaticamente para servir como uma imagem em miniatura do vídeo.
      • Selecione o ativo de imagem e selecione Selecionar.
  7. Na página Alterar miniatura, selecione Salvar alteração.

  8. Na página Propriedades do vídeo, no canto superior direito, selecione Salvar e fechar.

Sobre miniaturas de vídeo no Dynamic Media - Modo híbrido about-video-thumbnails-in-dynamic-media-hybrid-mode

Você pode escolher uma das dez imagens em miniatura geradas automaticamente pelo Dynamic Media para adicionar ao seu vídeo. O reprodutor de vídeo exibe a miniatura selecionada quando um ativo de vídeo é usado com o componente Dynamic Media no ambiente de criação do Experience Manager Sites, Experience Manager Mobile ou Experience Manager Screens. A miniatura serve como uma imagem estática que melhor representa o conteúdo de todo o vídeo e incentiva os usuários a clicar no botão Reproduzir.

Com base no tempo total do vídeo, o Dynamic Media captura dez imagens em miniatura (padrão). As imagens são capturadas em 1%, 11%, 21%, 31%, 41%, 51%, 61%, 71%, 81% e 91% no vídeo. As dez miniaturas persistem, o que significa que, se você decidir escolher uma miniatura diferente posteriormente, não será necessário gerar a série novamente. Você visualiza as dez imagens em miniatura e seleciona aquela que deseja usar com o vídeo. Se quiser alterar para o padrão, use o CRXDE Lite para configurar o intervalo de tempo em que as imagens em miniatura são geradas. Por exemplo, se você deseja gerar apenas uma série de quatro imagens em miniatura espaçadas uniformemente a partir do vídeo, é possível configurar o tempo de intervalo em 24%, 49%, 74% e 99%.

O ideal é que você possa adicionar uma miniatura de vídeo a qualquer momento depois de fazer upload do vídeo, mas antes de publicá-lo no seu site.

Se preferir, é possível optar por fazer upload de uma miniatura personalizada para representar o vídeo, em vez de usar uma miniatura gerada pelo Dynamic Media. Por exemplo, você pode criar uma imagem em miniatura personalizada que tenha o título do seu vídeo, uma imagem de abertura atraente ou uma imagem específica capturada do seu vídeo. A imagem em miniatura de vídeo personalizada que você carregar deve ter uma resolução máxima de 1280 x 720 pixels (largura mínima de 640 pixels) e não ser maior que 2 MB.

Consulte também Sobre miniaturas de vídeo no modo Dynamic Media - Scene7.

Adicionar uma miniatura de vídeo adding-a-video-thumbnail

Essas etapas se aplicam apenas ao Dynamic Media executado no modo Híbrido.

Para adicionar uma miniatura de vídeo:

  1. Navegue até um ativo de vídeo carregado ao qual deseja adicionar uma miniatura de vídeo.

  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  3. Na barra de ferramentas, selecione o ícone Propriedades da Exibição (um círculo contendo um "i").

  4. Na página Propriedades do vídeo, selecione Alterar miniatura.

  5. Na página Alterar Miniatura, na barra de ferramentas, selecione Selecionar Quadro.

    O Dynamic Media gera uma série de imagens em miniatura do vídeo com base no intervalo de tempo padrão ou no intervalo de tempo personalizado.

  6. Visualize as imagens em miniatura geradas e selecione aquela que deseja adicionar ao vídeo.

  7. Selecione Salvar alteração.

    A imagem em miniatura do vídeo é atualizada para usar a miniatura selecionada. Posteriormente, se você decidir alterar a imagem da miniatura, poderá retornar à página Alterar miniatura e selecionar uma nova.

    Se você tiver configurado novos intervalos de tempo padrão ou tiver carregado um novo vídeo para substituir o vídeo existente, peça à Dynamic Media para regenerar as miniaturas.

    Consulte Configurar o intervalo de tempo padrão no qual as miniaturas de vídeo são geradas.

Configurar o intervalo de tempo padrão no qual as miniaturas de vídeo são geradas configuring-the-default-time-interval-that-video-thumbnails-are-generated

Ao configurar e salvar o novo intervalo de tempo padrão, sua alteração se aplica automaticamente somente aos vídeos que você fizer upload no futuro. Isso não aplica automaticamente o novo padrão aos vídeos carregados anteriormente. Para vídeos existentes, você deve regenerar as miniaturas.

Consulte Adicionar uma miniatura de vídeo.

Para configurar o intervalo de tempo padrão durante o qual as miniaturas de vídeo são geradas:

  1. No Experience Manager, selecione Ferramentas > Geral > CRXDE Lite.

  2. Na página CRXDE Lite, no painel de diretórios à esquerda, navegue até o etc/dam/imageserver/configuration/jcr:content/settings.

    se o painel diretório não estiver visível, selecione o ícone >> à esquerda da guia Início.

  3. No painel inferior direito, na guia Propriedades, selecione thumbnailtime.

  4. Na caixa de diálogo Editar tempo de miniatura, use os campos de texto para inserir valores de intervalo como porcentagens.

    • Selecione o ícone de sinal de mais (+) se desejar adicionar um ou mais campos de valor de intervalo. Se necessário, role até a parte inferior da caixa de diálogo para ver o ícone.
    • Selecione o ícone de sinal de menos (-) à direita de um campo de valor de intervalo se desejar excluí-lo da lista.
    • Selecione o ícone de seta para cima e o ícone de seta para baixo se desejar reordenar os valores do intervalo.
  5. Selecione OK e retorne à guia Propriedades.

  6. Próximo ao canto superior esquerdo da página de CRXDE Lite, selecione Salvar tudo e, em seguida, selecione o ícone Voltar à página inicial no canto superior esquerdo para retornar ao Experience Manager.

    Consulte Adicionar uma miniatura de vídeo.

Adicionar uma miniatura de vídeo personalizada adding-a-custom-video-thumbnail-1

Essas etapas se aplicam apenas ao Dynamic Media executado no modo Híbrido.

Para adicionar uma miniatura de vídeo personalizada:

  1. Navegue até um ativo de vídeo carregado ao qual deseja adicionar uma miniatura de vídeo personalizada.

  2. No modo de seleção de ativos, na Exibição em lista ou na Exibição de cartão, selecione o ativo de vídeo.

  3. Na barra de ferramentas, selecione o ícone Propriedades da Exibição (um círculo contendo um "i").

  4. Na página Propriedades do vídeo, selecione Alterar miniatura.

  5. Na página Alterar miniatura, na barra de ferramentas, selecione Carregar nova miniatura.

  6. Navegue até uma imagem em miniatura que você deseja usar, selecione-a e, em seguida, selecione Abrir para começar a carregar a imagem no Experience Manager. Após o upload, publique a imagem.

  7. Depois de carregar e publicar a imagem com êxito, na página Alterar miniatura, selecione Salvar alterações.

    A miniatura personalizada é adicionada ao vídeo.

Alterar o URL do Dynamic Media para ativos do Dynamic Media manifest-urls

Os vídeos processados no Dynamic Media podem ser usados por meio de visualizadores prontos para uso e também acessando diretamente os URLs de manifesto e reproduzindo-os por meio de seus próprios visualizadores personalizados. Veja a seguir a API para buscar URLs de manifesto para um vídeo.

Sobre a API getVideoManifestURI

A API getVideoManifestURIé exposta por meio de cq-scene7-api:com.day.cq.dam.scene7.api e pode ser usada para gerar as seguintes URLs de manifesto:

/**
* Returns the manifest url for videos
* @param resource video resource
* @param manifestType type of video streaming manifest being requested
* @param onlyIfPublished return a manifest only if the video is published
* @return the manifest url for videos
*
* @throws Exception
*/
@Nullable
String getVideoManifestURI(Resource resource, ManifestType manifestType, boolean onlyIfPublished) throws Exception;

Parâmetros da API getVideoManifestURI

Essa API inclui os três parâmetros a seguir:

Parâmetro
Descrição
resource
O recurso correspondente ao vídeo que o Dynamic Media assimilou.
manifestType
Pode ser ManifestType.DASH ou ManifestType.HLS
onlyIfPublished
Definido como verdadeiro caso o uri de manifesto seja gerado somente se for publicado e estiver disponível no nível de entrega.

Para buscar as URLs de manifesto para vídeos usando o método acima, adicione um perfil de codificação de vídeo a uma pasta "carregar vídeos". O Dynamic Media processa esses vídeos com base nas codificações encontradas no arquivo de codificação de vídeo atribuído à pasta. Agora é possível invocar a API acima para buscar URLs de manifesto para os vídeos carregados.

Cenários de erro

A API retorna nulo se houver erros. As exceções são registradas em logs de erro de Experience Manager. Todos esses erros registrados começam com Could not generate Video Manifest URI. Os seguintes cenários podem fazer com que esses erros ocorram:

  • Um IllegalArgumentException é registrado para qualquer um dos seguintes:

    • O parâmetro resource passado é nulo.
    • O parâmetro resource passado não é um vídeo.
    • O parâmetro manifestType passado é nulo.
    • O parâmetro onlyIfPublished é passado como true, mas o vídeo não foi publicado.
    • O vídeo não foi assimilado usando um conjunto de vídeos adaptáveis do Dynamic Media.
  • O IOException é registrado quando há um problema de conexão com o Dynamic Media.

  • UnsupportedOperationException é registrado quando um parâmetro manifestType passado é ManifestType.DASH, enquanto o vídeo não foi processado usando o formato DASH.

Este é um exemplo da API acima usando servlets escritos na especificação HTTPWhiteBoard. Selecione cada guia para a sintaxe de código.

Adicionar dependência em pom.xml
accordion
Adicionar dependência em pom.xml
code language-java
dependency>
     <groupId>com.day.cq.dam</groupId>
     <artifactId>cq-scene7-api</artifactId>
     <version>5.12.64</version>
     <scope>provided</scope>
</dependency>
Servlet de exemplo
accordion
Servlet de exemplo
code language-java
@Component
        service = Servlet.class
)
@HttpWhiteboardServletPattern(value = ManifestServlet.SERVLET_PATTERN)
@HttpWhiteboardContextSelect(value = Constants.SERVLET_CONTEXT_SELECTOR)
public class ManifestServlet extends HttpServlet {

   private static final Logger LOGGER = LoggerFactory.getLogger(ManifestServlet.class);

   private final ObjectMapper objectMapper;

    @Reference
    private Scene7Service scene7Service;

   public static final String SERVLET_PATTERN = Constants.VIDEO_API_PREFIX + "/manifestUrl";

   public ManifestServlet() {
         this.objectMapper = new ObjectMapper();
         objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
   }

   @Override

   protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        final ResourceResolver resolver = getResourceResolver(request);
        String assetPath = request.getParameter("assetPath");
        String manifest = request.getParameter("manifestType");
        String onlyIfPublished = request.getParameter("onlyIfPublished");
        Resource resource = resolver.getResource(assetPath);
        response.setCharacterEncoding(StandardCharsets.UTF_8.toString());
        response.setContentType("application/json");
        if(resource == null) {
            LOGGER.info("could not retrieve the resource from JCR");
            error("could not retrieve the resource from JCR", response);
            return;
        }

        String manifestUri = null;

        try{
            ManifestType manifestType =  ManifestType.DASH;
            if(manifest != null) {
                manifestType = ManifestType.valueOf(manifest);
            }
            manifestUri = scene7Service.getVideoManifestURI(resource, manifestType, onlyIfPublished != null);
            objectMapper.writeValue(response.getWriter(), new ManifestUrl(manifestUri));
            response.setContentType("application/json");
        } catch (Exception e) {
            LOGGER.error(e.getMessage(), e);
            error(String.format("Unable to get the manifest url for %s. %s", assetPath, e.getMessage()), response);
        }
    }

    private ResourceResolver getResourceResolver(HttpServletRequest request) {
        Object rr = request.getAttribute(AuthenticationSupport.REQUEST_ATTRIBUTE_RESOLVER);
        if (!(rr instanceof ResourceResolver)) {
            throw new IllegalStateException(
                    "The request does not seem to have been created via Apache Sling's authentication mechanism.");
        } else {
            return (ResourceResolver) rr;
        }
    }

    private void error(String errorMessage, HttpServletResponse response) throws IOException {
        ManifestUrl errorManifest = new ManifestUrl(null);
        errorManifest.setErrorMessage(errorMessage);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        objectMapper.writeValue(response.getWriter(), errorManifest);
    }
}
Classe de resposta para servlet
accordion
Classe de resposta para servlet
code language-java
public class ManifestUrl extends VideoResponse {
     String manifestUrl;
     public ManifestUrl(String manifestUrl) {
         this.manifestUrl = manifestUrl;
     }
     public String getManifestUrl() {
         return manifestUrl;
     }
}

public abstract class VideoResponse {
     String errorString;

     public String getErrorString() {
         return errorString;
     }

     public void setErrorMessage(String errorString) {
         this.errorString = errorString;
     }
}
Arquivo de constantes referenciado no servlet
accordion
Arquivo de constantes referenciado no servlet
code language-java
public final class Constants {

     private Constants() {
     }

     public static final String VIDEO_API_PREFIX = "/dynamicmedia/video";
     public static final String SERVLET_CONTEXT_SELECTOR = "(" + HttpWhiteboardConstants.HTTP_WHITEBOARD_CONTEXT_NAME + "=" +
             DMSampleApiHttpContext.CONTEXT_NAME + ")";

 }
ServletContext
accordion
ServletContext

Monte o servlet acima usando um servletContext. Este é um exemplo de servletContext.

code language-java
public class DMSampleApiHttpContext extends ServletContextHelper {

 public static final String CONTEXT_NAME = "com.adobe.dmSample";
 public static final String CONTEXT_PATH = "/dmSample";

 private final MimeTypeService mimeTypeService;

 private final AuthenticationSupport authenticationSupport;

 /**
  * Constructs a new context that will use the given dependencies.
  *
  * @param mimeTypeService Used when providing mime type of requests.
  * @param authenticationSupport Used to authenticate requests with sling.
  */
 @Activate
 public DMSampleApiHttpContext(@Reference final MimeTypeService mimeTypeService,
                               @Reference final AuthenticationSupport authenticationSupport) {
     this.mimeTypeService = mimeTypeService;
     this.authenticationSupport = authenticationSupport;
 }

 // ---------- HttpContext interface ----------------------------------------
 /**
  * Returns the MIME type as resolved by the <code>MimeTypeService</code> or
  * <code>null</code> if the service is not available.
  */
 @Override
 public String getMimeType(String name) {
     MimeTypeService mtservice = mimeTypeService;
     if (mtservice != null) {
         return mtservice.getMimeType(name);
     }
     return null;
 }

 /**
  * Returns the real context path that is used to mount this context.
  * @param req servlet request
  * @return the context path
  */
 public static String getRealContextPath(HttpServletRequest req) {
     final String path = req.getContextPath();
     if (path.equals(CONTEXT_PATH)) {
         return "";
     }
     return path.substring(CONTEXT_PATH.length());
 }

 /**
  * Returns a request wrapper that transforms the context path back to the original one
  * @param req request
  * @return the request wrapper
  */
 public static HttpServletRequest createContextPathAdapterRequest(HttpServletRequest req) {
     return new HttpServletRequestWrapper(req) {

         @Override
         public String getContextPath() {
             return getRealContextPath((HttpServletRequest) getRequest());
         }

     };

 }

 /**
  * Always returns <code>null</code> because resources are all provided
  * through individual endpoint implementations.
  */
 @Override
 public URL getResource(String name) {
     return null;
 }

 /**
  * Tries to authenticate the request using the
  * <code>SlingAuthenticator</code>. If the authenticator or the Repository
  * is missing this method returns <code>false</code> and sends a 503/SERVICE
  * UNAVAILABLE status back to the client.
  */
 @Override
 public boolean handleSecurity(HttpServletRequest request,
                               HttpServletResponse response) throws IOException {

     final AuthenticationSupport authenticator = this.authenticationSupport;
     if (authenticator != null) {
         return authenticator.handleSecurity(createContextPathAdapterRequest(request), response);
     }

     // send 503/SERVICE UNAVAILABLE, flush to ensure delivery
     response.sendError(HttpServletResponse.SC_SERVICE_UNAVAILABLE,
             "AuthenticationSupport service missing. Cannot authenticate request.");
     response.flushBuffer();

     // terminate this request now
     return false;
 }
}

Usar o servlet de amostra

Você invoca o servlet executando uma operação GET em /dmSample/dynamicmedia/video/manifestUrl. Os seguintes parâmetros de consulta são transmitidos:

Parâmetro de consulta
Descrição
assetPath
Obrigatório. O caminho para o vídeo para o qual manifestUrl é gerado.
manifestType
Opcional. O parâmetro pode ser DASH ou HLS. Se não for transmitido, o padrão será DASH.
onlyIfPublished
Opcional. Se aprovado, o manifestUrl será retornado somente se o vídeo for publicado.

Neste exemplo, vamos supor a seguinte configuração:

  • A empresa é samplecompany.
  • A instância de criação é http://sample-aem-author.com.
  • A pasta /content/dam/video-example tem um perfil de codificação de vídeo aplicado a ela.
  • O vídeo scenery.mp4 foi carregado para a pasta /content/dam/video-example.

Você pode chamar o servlet das seguintes maneiras:

Tipo
Descrição
HLS
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=HLS&assetPath=/content/dam/video-example/scenery.mp4

Caso a entrega DASH esteja habilitada:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8?packagedStreaming=true"}

Caso a entrega DASH esteja desabilitada:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8"}
TRAÇO
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scenery.mp4

Caso a entrega DASH esteja habilitada:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.mpd"}

Caso a entrega DASH esteja desabilitada:
{}
Erro: o caminho do ativo está errado
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scennnnnnery.mp4

{"errorString":"could not retrieve the resource from JCR"}
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2