Compartilhar via

API de Faixas dos Serviços de Mídia

  • Artigo

Logotipo dos Serviços de Mídia v3

Aviso

Os Serviços de Mídia do Azure serão desativados em 30 de junho de 2024. Para obter mais informações, consulte o Guia de desativação do AMS.

Um ativo dos Serviços de Mídia contém arquivos de mídia na conta de armazenamento do Azure associada. Esses arquivos contêm os dados para faixas de áudio, vídeo e texto. A API de Faixas permite que você entenda e gerencie as faixas que estão no ativo. As faixas são usadas por um player de vídeo DASH ou HLS para apresentar o áudio, vídeo e legendas ou legendas (texto) ao público. Um ponto de extremidade de streaming dos Serviços de Mídia comunica informações sobre as faixas para um player por meio de manifestos DASH ou playlists HLS quando solicitado.

Com a API de Faixas, você pode:

  • Obter a lista de faixas de áudio, de vídeo e de texto em um ativo.
  • Adicionar ou remover faixas de texto.
  • Adicionar ou remover faixas de áudio.
  • Especifique os atributos de acessibilidade das faixas de texto ou áudio.
  • Edite a faixa no portal do Azure ou baixe-a e carregue-a novamente no ativo.
  • Mostrar ou ocultar uma faixa de texto em um player de vídeo.

Observação

Você só pode adicionar ou atualizar uma faixa de texto em um ativo VOD (vídeo sob demanda). Além disso, não há suporte para associação tardia de áudio para ativos de transmissão ao vivo.

Faixas de texto

Usando faixas de texto com mídia produzida localmente

Depois de produzir um vídeo localmente e exportar legendas, você pode carregar essas legendas no ativo que contém sua mídia sob demanda.

Fluxo de trabalho geral para usar faixas de texto com texto produzido localmente:

  1. Crie um vídeo e exporte legendas para um arquivo que esteja no formato VTT ou TTML.
  2. Traduza ou edite o arquivo VTT ou TTML e salve cópias para:
    1. Uma faixa para um idioma adicional com texto descritivo para atender aos requisitos de acessibilidade.
    2. Uma faixa para texto adicional para o comentário do diretor.
  3. IMPORTANTE: você deve adicionar o designador de idioma ao cabeçalho VTT para que o idioma correto seja exibido no player cliente. Por exemplo:
    WEBVTT
Language: en-us
  4. Carregue o vídeo nos Serviços de Mídia.
  5. Crie uma transformação e um trabalho para codificar o vídeo.
  6. Carregue as faixas de texto adicionais.

Usando faixas de texto com transcrição ao vivo

Quando a transcrição ao vivo é ativada para um evento ao vivo, uma faixa de texto WebVTT adicional é criada além da faixa de transcrição ao vivo em tempo real que os espectadores veem no player de vídeo ao vivo. Esse arquivo WebVTT contém a melhor versão da transcrição ao vivo que contém frases completas em vez dos resultados parciais em tempo real. Você pode baixar o arquivo .vtt depois que toda a transcrição estiver disponível e a saída ao vivo for excluída.

Aviso

Os arquivos VTT de transcrição ao vivo gerados automaticamente finais têm um atraso para o processamento. A menos que você aguarde alguns minutos para excluir uma saída ao vivo, o conteúdo no arquivo ficará truncado. Além disso, a transcrição ao vivo não está disponível para uso com vários fluxos de entrada em um evento ao vivo.

Fluxo de trabalho geral para usar faixas de texto de transcrição ao vivo:

  1. Crie um evento ao vivo com transcrição ao vivo habilitada e com o idioma de origem selecionado.
  2. Quando o evento ao vivo terminar, aguarde vários minutos e exclua a saída ao vivo. O ativo arquivado estará disponível para streaming sob demanda. As URLs de streaming válidas ainda estarão acessíveis para seus visualizadores.
  3. Liste as faixas no ativo arquivado ou exiba-as no portal. Haverá um arquivo WebVTT que contém a transcrição NBest. Ele terá uma extensão .vtt. O arquivo é denominado auto-generated-best_XXX.vtt.
  4. Edite o arquivo VTT no portal do Azure ou baixe-o e edite-o.
  5. Para apresentar a faixa de texto em vários idiomas, traduza a faixa de texto de origem para esses idiomas e salve-os como arquivos separados para cada idioma usando a extensão .vtt.
  6. Carregue a faixa de idioma de origem e as faixas de texto para cada idioma.
  7. Se você não usar o portal do Azure para carregar o arquivo, edite (ou atualize) o arquivo .ism para informar ao jogador quais faixas de texto usar, bem como sua rotulagem e visibilidade por:
    1. Usando a API tracks para atualizar o manifesto programaticamente usando um dos SDKs ou a CLI:
      1. Node.JS
      2. Python
      3. .Net
      4. CLI

Importante

Ao atualizar o arquivo .ism, oculte a faixa de texto de transcrição ao vivo e mostre a faixa de texto no idioma apropriado para o visualizador.

Faixas de áudio

Você pode adicionar faixas de áudio adicionais a um ativo para fornecer aos visualizadores áudio em idiomas diferentes, adicionar áudio descritivo para acessibilidade ou adicionar comentários do diretor.

Fluxo de trabalho geral para faixas de áudio

  1. Crie faixas de áudio adicionais para o evento ao vivo. Eles podem ser áudio em idiomas diferentes ou áudio descritivo que é usado para acessibilidade. Você também pode usar uma faixa de áudio para comentários do diretor.
  2. Carregue as faixas de áudio no ativo arquivado.
  3. Atualize os dados de acompanhamento editando o arquivo de manifesto no portal ou atualizando os dados de acompanhamento usando REST ou um SDK.

Observação

Quando uma faixa de áudio ou texto é removida, o arquivo subjacente não é removido do contêiner de armazenamento. Os Serviços de Mídia definem o empacotador dinâmico (ponto de extremidade de streaming) para não mostrar as informações sobre a faixa no manifesto ou na playlist solicitadas pelo player de vídeo.

Para ver etapas detalhadas da API de Faixas, confira Exemplos abaixo.

Exemplos

Guias de instruções, tutoriais e guias de início rápido

Obter ajuda e suporte

Você pode entrar em contato com os Serviços de Mídia com dúvidas ou seguir nossas atualizações por um dos seguintes métodos: