Esta página contém um resumo das práticas recomendadas para a API Video Stitcher. Se você está começando a usar a API Video Stitcher, consulte o guia de início rápido para transmissões ao vivo ou o guia de início rápido para recursos de VOD.
Recursos de VOD de condição
Configurar os codificadores e transcodificadores de origem para gerar manifestos compatíveis com a intervalos entre os períodos DASH e os segmentos HLS. A API Video Stitcher não vai dividir pontos finais ou segmentos para unir intervalos de anúncios, de modo que os intervalos sejam agrupados apenas limites de período e segmento.
Para tags de anúncio que retornam respostas VMAP, cada intervalo de anúncio especificado no arquivo deve corresponder a um limite de período ou segmento. Caso contrário, os intervalos de anúncio serão costurado no limite mais próximo.
Evite o desalinhamento do intervalo de anúncio para HLS
Para a junção de VOD, você precisa pré-condicionar o manifesto de vídeo de origem para intervalos de anúncios intermediários e configurar a tag de anúncio da playlist de vários anúncios em vídeo (VMAP) para retornar intervalos de anúncios intermediários nas posições de deslocamento pré-condicionadas. A API Video Stitcher usa o resultado da saída transcodificada e insere anúncios o mais próximo possível do local especificado. Usar entradas pré-condicionadas para anúncios intermediários intervalos de anúncio para tornar o comportamento do agrupamento de anúncios consistente e preciso.
Por exemplo, a playlist de vídeo a seguir mostra uma oportunidade de veiculação de anúncios na marca de sete segundos:
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4
#EXTINF:2.0
../video/180_250000/hls/segment_0.ts
#EXTINF:2.0
../video/180_250000/hls/segment_1.ts
#EXTINF:2.0
../video/180_250000/hls/segment_2.ts
#EXTINF:1.0
../video/180_250000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:2.0
../video/180_250000/hls/segment_4.ts
A playlist de áudio a seguir mostra uma oportunidade de veiculação de anúncios na marca de sete segundos:
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_0.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_1.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_2.ts
#EXTINF:1.03
../audio/1_stereo_128000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_4.ts
A seguinte configuração do VMAP especifica uma intervalo de anúncio que ocorrerá nos sete a segunda marca. As playlists de vídeo e áudio vão conter intervalos de anúncios exatamente na marca de sete segundos:
<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
<vmap:AdBreak timeOffset="00:00:07.000" breakType="linear" breakId="midroll‑1">
<vmap:AdSource id="midroll-1‑ad‑1" allowMultipleAds="false" followRedirects="true">
<vmap:AdTagURI templateType="vast3">
<![CDATA[
https://securepubads.g.doubleclick.net/gampad/ads?...
]]>
</vmap:AdTagURI>
</vmap:AdSource>
</vmap:AdBreak>
</vmap:VMAP>
Usar manifestos DASH de vários períodos para recursos ao vivo e VOD
Configure os codificadores e transcodificadores de origem para gerar manifestos DASH com vários e não em um único período. Por motivos semelhantes ao condicionamento de VOD, a API Video Stitcher não vai dividir períodos para unir intervalos de anúncios. Portanto, um manifesto DASH com vários períodos terá mais oportunidades de unir intervalos de anúncios nas durações esperadas.
Encapsular legendas em ISOBMFF
As legendas dos manifestos DASH precisam ser encapsuladas no formato de arquivo de mídia ISO base. (ISOBMFF), como MP4, para compatibilidade com a maioria dos players de mídia.
Usar taxas de bits constantes
Para garantir uma experiência de reprodução estável para transmissões ao vivo, configure o codificador de origem ou o transcodificador para usar taxas de bits constantes ao gerar manifestos de transmissão. Isso permite que a API Video Stitcher agrupe anúncios de maneira mais consistente para que correspondam ao de codificação personalizados especificados nos manifestos.
Usar marcadores de anúncio compatíveis
Consulte a documentação de marcadores de anúncio para entender quais marcadores de anúncio são aceitos e como os codificadores de origem ou os transcodificadores precisam gerar marcadores de anúncio para garantir que os intervalos de anúncio sejam unidos com sucesso.
Verificar a reprodução da fonte
Para garantir uma experiência de reprodução estável para transmissões ao vivo e VOD, considere o uso players clientes amplamente disponíveis para verificar se os streams de origem podem ser reproduzidos; antes de agrupar com a API Video Stitcher.
HLS:
- hls.js
- Safari
- Shaka Player (link em inglês)
- video.js
DASH:
Gerenciar chaves da CDN
Se a mídia de origem estiver protegida pela assinatura de URL, será necessário registrar chaves CDN com a API Video Stitcher. Isso permite que a API:
- Buscar os manifestos do vídeo de origem para agrupamento
- assinar os segmentos do vídeo de origem para que os jogadores possam buscar os segmentos de vídeo; para reprodução
Veja informações sobre como gerenciar chaves CDN.
Configurar CDN de mídia
Se quiser configurar o Media CDN para distribuir os recursos de mídia, siga as Guia de início rápido do Media CDN.
Configure rotas separadas com TTLs apropriados para seus manifestos e segmentos de mídia. Para mais detalhes e exemplos, consulte a Guia de roteamento avançado do Media CDN.
Se alguma das suas rotas usar origens particulares do Cloud Storage, consulte
Como usar buckets particulares do Cloud Storage.
Especifique o modo de cache para essas rotas como FORCE_CACHE_ALL.
Para saber como configurar o HTTPS, consulte Configurar certificados SSL (TLS).
Solicitações assinadas do Media CDN
Para usar o Media CDN com solicitações assinadas ativadas, consulte Usar solicitações assinadas e siga estas instruções:
Crie um par de chaves assimétricas. Para mais informações sobre como criar uma chave privada compatível com o a API Video Stitcher, consulte Crie uma chave privada para o Media CDN ,
Registrar a chave privada do Media CDN com a API Video Stitcher.
Limite de duração para sessões ao vivo de longa duração
Um recurso LiveSession não expirará a menos que 5 minutos tenham se passado sem solicitações de playlist. No entanto, um ciclo de vida máximo de 180 dias é aplicado a toda reprodução URIs. Para continuar a reprodução após 180 dias, você precisará criar uma nova sessão ao vivo. Para maior confiabilidade, você deve criar uma nova sessão ao vivo em no mínimo a cada 30 dias.