Resolver problemas

Esta página mostra como resolver problemas com a API Video Stitcher. Os erros apresentados nesta página são específicos da API Video Stitcher. Para obter informações sobre erros genéricos nas APIs Google, consulte a página Erros das APIs Cloud.

Apenas é devolvido o primeiro erro. Se um pedido encontrar vários erros, tem de corrigir o erro devolvido e tentar novamente o pedido para ver o erro seguinte.

Não é possível obter a playlist ao criar uma sessão

O seguinte problema ocorre quando a API Video Stitcher não consegue obter o manifesto de vídeo do sourceUri especificado.

{
  "error": {
    "code": 404,
    "message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
    "status": "NOT_FOUND",
  }
}

Para resolver este problema, siga os passos abaixo:

  1. Verifique se o sourceUri fornecido tem um link para um manifesto de vídeo válido.

    • Use curl com o sourceUri. Se o manifesto se destinar a ser acessível publicamente, certifique-se de que o URL pode ser alcançado publicamente.
    • Se o sourceUri estiver correto e o manifesto do vídeo exigir a assinatura do URL, avance para o passo seguinte.
  2. Certifique-se de que a chave de CDN foi registada na API Video Stitcher na mesma região que o pedido.

  3. Se suspeitar que a chave privada usada para assinar o URL está incorreta, é recomendável atualizar a chave de RFC registada com a chave privada correta.

A chave da RFC está desatualizada

Se registou ou atualizou recentemente uma chave de RFC e a API Video Stitcher não tiver começado a assinar URLs com a nova configuração, siga os passos abaixo para diagnosticar o problema:

  1. Se a chave de RFC tiver sido registada recentemente na API Video Stitcher, aguarde, pelo menos, 5 minutos para permitir que a atualização seja propagada. Se o problema persistir, avance para o passo seguinte.

  2. Verifique se apenas uma chave de RFC está registada para um nome de anfitrião para a região. Se tiverem sido registadas várias chaves de RFC com o mesmo nome de anfitrião, a API Video Stitcher seleciona uma das chaves de RFC para assinar o URL.

    • Certifique-se de que apenas uma chave de RFC foi registada com um nome de anfitrião especificado para uma determinada região. Elimine a chave de RFC obsoleta.

Não foram inseridos anúncios numa sessão em direto

Se não foram inseridos anúncios numa sessão em direto, siga estes passos para diagnosticar o problema:

  1. Verifique se as streams em direto de origem inseriram pausas para anúncios no manifesto. Os seguintes marcadores de anúncios têm de existir no manifesto do vídeo de stream em direto para indicar à API Video Stitcher que substitua os segmentos de vídeo de origem por segmentos de anúncios.

    • Se o manifesto do vídeo de origem não tiver marcadores de anúncios, significa que o seu codificador não acionou uma pausa para anúncios ou tem de ser alterado para inserir os marcadores de anúncios suportados.

    • Se os marcadores de anúncios estiverem claramente visíveis no manifesto de origem, avance para o passo seguinte.

  2. Verifique se a etiqueta de anúncio fornecida devolve uma resposta VAST não vazia.

    • Copie a etiqueta de anúncio para a barra de endereço de um navegador de Internet (por exemplo, o Chrome) e verifica se devolve uma resposta VAST não vazia. Segue-se uma resposta VAST vazia:

      <VAST version="3.0"/>
      
    • Se for devolvida uma resposta VAST vazia, o problema está na etiqueta de anúncio. Verifique se a etiqueta de anúncio está configurada corretamente com os servidores de anúncios.

    • Se a resposta VAST estiver preenchida, use curl para pedir a etiqueta do anúncio. Alguns servidores de anúncios requerem o fornecimento do User-Agent cabeçalho. Experimente o seguinte comando curl:

      curl AD_TAG_URI
      
    • Se o comando curl devolver uma resposta VAST vazia, adicione o cabeçalho User-Agent ao comando curl:

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
          AD_TAG_URI
      
    • Se for devolvida uma resposta VAST preenchida, o problema é que o cabeçalho User-Agent tem de ser transmitido à API Video Stitcher quando cria a sessão em direto. A API Video Stitcher usa esse cabeçalho quando executa a etiqueta do anúncio para obter anúncios.

    • Se continuar a ser devolvida uma resposta vazia, o problema está na etiqueta de anúncio fornecida. Confirme com o cliente se a etiqueta de anúncio está correta e se os valores das macros de etiquetas de anúncios também estão corretos.

    • Se os problemas com a etiqueta de anúncio do cliente tiverem sido resolvidos, mas os anúncios não tiverem sido inseridos, avance para o passo seguinte.

  3. Inspeção da sessão em direto. Se a sessão afetada estiver a mostrar que os anúncios são devolvidos pelos servidores de anúncios, avance para o passo seguinte.

  4. A causa potencial seguinte para anúncios em falta deve-se à recodificação de anúncios. A API volta a codificar os anúncios durante o primeiro encontro para codificar o anúncio de forma a corresponder ao vídeo de origem. Normalmente, os anúncios demoram alguns minutos a ser codificados. Tente criar uma nova sessão após alguns minutos para ver se os anúncios são inseridos.

    Se não foram inseridos anúncios, o problema pode dever-se a uma falha na codificação de um anúncio. Pode não ser possível aceder aos URLs dos suportes de anúncios. Neste caso, o cliente tem de trabalhar com o fornecedor de anúncios para determinar o que está errado com o respetivo conteúdo multimédia de anúncios.

Não foram inseridos anúncios numa sessão de VOD

  1. Verifique se a etiqueta de anúncio fornecida devolve uma resposta VAST ou VMAP não vazia. Use a etiqueta do anúncio fornecida com as seguintes instruções:

    • Copie a etiqueta de anúncio para a barra de endereço de um navegador de Internet (por exemplo, o Chrome) e verifica se devolve uma resposta VAST, VMAP ou SmartXML não vazia. Segue-se um exemplo de uma resposta VAST vazia:
    • Coloque a etiqueta do anúncio num navegador de Internet (ou seja, Chrome, Firefox, etc.) e verifica se devolve uma resposta VAST, VMAP ou SmartXML não vazia. Uma resposta VAST vazia tem o seguinte aspeto:

      <VAST version="3.0"/>
      

      Segue-se uma resposta de VMAP vazia:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>
      
    • Se for devolvida uma resposta VAST vazia, o problema está na etiqueta de anúncio. Verifique se a etiqueta de anúncio está configurada corretamente com os servidores de anúncios.

    • Se a resposta VAST estiver preenchida, use curl para pedir a etiqueta do anúncio. Alguns servidores de anúncios requerem o fornecimento do User-Agent cabeçalho. Experimente o seguinte comando curl:

      curl AD_TAG_URI
      
    • Se o comando curl devolver uma resposta VAST vazia, adicione o cabeçalho User-Agent ao comando curl:

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
          AD_TAG_URI
      
    • Se for devolvida uma resposta VAST ou VMAP preenchida, o problema é que o cabeçalho User-Agent tem de ser transmitido à API Video Stitcher quando criar a sessão de VOD. A API Video Stitcher usa esse cabeçalho quando executa a etiqueta do anúncio para obter anúncios.

    • Se continuar a ser devolvida uma resposta vazia, o problema está na etiqueta de anúncio fornecida. Confirme com o cliente se a etiqueta de anúncio está correta e se os valores das macros de etiquetas de anúncios também estão corretos.

    • Se os problemas com a etiqueta de anúncio do cliente tiverem sido resolvidos, mas os anúncios não tiverem sido inseridos, avance para o passo seguinte.

  2. Inspecione a sessão de VOD. Se a sessão afetada estiver a mostrar que os anúncios são devolvidos pelos servidores de anúncios, avance para o passo seguinte.

  3. A causa potencial seguinte para anúncios em falta deve-se à recodificação de anúncios. A API volta a codificar os anúncios durante o primeiro encontro para codificar o anúncio de forma a corresponder ao vídeo de origem. Normalmente, os anúncios demoram alguns minutos a ser codificados. Tente criar uma nova sessão após alguns minutos para ver se os anúncios são inseridos.

    Se não foram inseridos anúncios, o problema pode dever-se a uma falha na codificação de um anúncio. Pode não ser possível aceder aos URLs dos suportes de anúncios. Neste caso, o cliente tem de trabalhar com o fornecedor de anúncios para determinar o que está errado com o respetivo conteúdo multimédia de anúncios.