Esta página contém um resumo das práticas recomendadas para a API Video Stitcher. Se você estiver começando a usar a API Video Stitcher, consulte a 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 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 VMAP 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.
Evitar o desalinhamento do intervalo de anúncio para HLS
Para agrupamento de VOD, pré-condicione o manifesto do vídeo de origem para Intervalos de anúncios intermediários e configurar a tag de 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. O A API Video Stitcher usa o resultado da saída transcodificada e insere os anúncios como o mais próximo possível de onde você especificar. Usar entradas pré-condicionadas para anúncios intermediários os intervalos de anúncio para tornar o comportamento do agrupamento de anúncios consistente e preciso.
Por exemplo, a lista de reprodução de vídeos a seguir mostra uma oportunidade de posicionamento do anúncio em 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 posicionamento de anúncios nos sete segunda marca:
#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 listas de reprodução de áudio e vídeo contêm intervalos de anúncio exatamente 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 a Condicionamento de VOD, a API Video Stitcher não vai dividir os períodos. para agrupar intervalos de anúncio. Assim, um manifesto DASH com vários pontos terá mais oportunidades de agrupar intervalos de anúncio 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 a origem para usar taxas de bits constantes na saída de manifestos de stream. 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 sobre marcadores de anúncio para entender quais marcadores de anúncio são compatíveis e como os codificadores ou os transcodificadores devem gerar marcadores de anúncio para garantir que os intervalos de anúncio sejam unidos com sucesso.
Verificar reprodução original
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:
- dash.js
- Shaka Player (link em inglês)
- video.js
Gerenciar chaves 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.
Configurar rotas separadas com TTLs apropriados para seus manifestos e mídia segmentos. Para 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.
Mais especificamente, defina o modo de cache para essas rotas como FORCE_CACHE_ALL
.
Para instruções sobre como configurar 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 fazer o seguintes:
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 LiveSession recurso não expira, a menos que 5 minutos tenham se passado sem nenhuma playlist solicitações. 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.