API de Monitorização de Serviços de Multimédia

  • Artigo

Logótipo dos Serviços de Multimédia v3

Aviso

Os Serviços de Multimédia do Azure serão descontinuados a 30 de junho de 2024. Para obter mais informações, consulte o Guia de Descontinuação do AMS.

Um recurso dos Serviços de Multimédia contém ficheiros de multimédia na conta de armazenamento do Azure associada. Estes ficheiros contêm os dados para faixas de áudio, vídeo e texto. A API de Faixas permite-lhe compreender e gerir as faixas que estão no recurso. As faixas são utilizadas por um leitor de vídeo DASH ou HLS para apresentar o áudio, vídeo e legendas ou legendas (texto) à audiência. Um ponto final de transmissão em fluxo dos Serviços de Multimédia comunica informações sobre as faixas a um leitor através de manifestos DASH ou listas de reprodução do HLS quando solicitado.

Com a API de Faixas, pode:

  • Obtenha a lista de faixas de áudio, vídeo e texto num recurso.
  • Adicionar ou remover faixas de texto.
  • Adicionar ou remover faixas de áudio.
  • Especifique atributos de acessibilidade das faixas de texto ou áudio.
  • Edite a faixa no portal do Azure ou transfira-a e, em seguida, carregue-a novamente para o recurso.
  • Mostrar ou ocultar uma faixa de texto num leitor de vídeo.

Nota

Só pode adicionar ou atualizar uma faixa de texto num recurso VOD (video-on-demand). Além disso, o enlace de áudio atrasado não é suportado para recursos de transmissão em fluxo em direto.

Faixas de texto

Utilizar faixas de texto com suportes de dados produzidos localmente

Depois de produzir um vídeo localmente e exportar legendas, pode carregar essas legendas para o elemento que contém o suporte de dados a pedido.

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

  1. Crie um vídeo e exporte legendas para um ficheiro que esteja no formato VTT ou TTML.
  2. Traduza ou edite o ficheiro VTT ou TTML e guarde cópias para:
    1. Uma faixa para um idioma adicional com texto descritivo para cumprir os requisitos de acessibilidade.
    2. Uma faixa para texto adicional para comentários do realizador.
  3. IMPORTANTE: tem de adicionar o designador de idioma ao cabeçalho VTT para que o idioma correto seja apresentado no leitor de cliente. Por exemplo:
    WEBVTT
Language: en-us
  4. Carregue o vídeo para os Serviços de Multimédia.
  5. Crie uma transformação e uma tarefa para codificar o vídeo.
  6. Carregue as faixas de texto adicionais.

Utilizar faixas de texto com transcrição em direto

Quando a transcrição em direto é ativada para um evento em direto, é criada uma faixa de texto WebVTT adicional para além da faixa de transcrição em tempo real que os visualizadores veem no leitor de vídeo em direto. Este ficheiro WebVTT contém a melhor versão da transcrição em direto que contém frases completas em vez dos resultados parciais e em tempo real. Pode transferir o ficheiro .vtt depois de toda a transcrição estar disponível e a saída em direto ser eliminada.

Aviso

Os ficheiros VTT de transcrição em direto gerados automaticamente estão atrasados para processamento. A menos que aguarde alguns minutos antes de eliminar uma saída em direto, o conteúdo no ficheiro será truncado. Além disso, a transcrição em direto não está disponível para utilização com vários fluxos de entrada para um evento em direto.

Fluxo de trabalho geral para utilizar faixas de texto de transcrição em direto:

  1. Crie um evento em direto com a transcrição em direto ativada e com o idioma de origem selecionado.
  2. Quando o evento em direto terminar, aguarde vários minutos e, em seguida, elimine a saída em direto. O recurso arquivado estará disponível para transmissão em fluxo a pedido. Os URLs de transmissão em fluxo válidos continuarão acessíveis aos seus visualizadores.
  3. Liste as faixas no recurso arquivado ou veja-as no portal. Haverá um ficheiro WebVTT que contém a transcrição NBest. Terá uma extensão .vtt. O ficheiro tem o nome auto-generated-best_XXX.vtt.
  4. Edite o ficheiro VTT no portal do Azure ou transfira-o e edite-o.
  5. Para apresentar a faixa de texto em vários idiomas, traduza o registo de texto de origem para esses idiomas e guarde-os como ficheiros separados para cada idioma com a extensão .vtt.
  6. Carregue a faixa de idioma de origem e as faixas de texto para cada idioma.
  7. Se não utilizar o portal do Azure para carregar o ficheiro, edite (ou atualize) o ficheiro .ism para indicar ao leitor quais as faixas de texto a utilizar, bem como a etiquetagem e visibilidade por:
    1. Utilizar a API Tracks para atualizar o manifesto programaticamente com um dos SDKs ou a CLI:
      1. Node.JS
      2. Python
      3. .Net
      4. CLI

Importante

Ao atualizar o ficheiro .ism, certifique-se de que oculta a faixa de texto de transcrição em direto e mostra a faixa de texto no idioma adequado para o visualizador.

Faixas de áudio

Pode adicionar faixas de áudio adicionais a um elemento para fornecer áudio aos seus visualizadores em diferentes idiomas, adicionar áudio descritivo para acessibilidade ou adicionar comentários de diretor.

Fluxo de trabalho geral para faixas de áudio

  1. Crie faixas de áudio adicionais para o evento em direto. Podem ser áudio em diferentes idiomas ou áudio descritivo que é utilizado para acessibilidade. Também pode utilizar uma faixa de áudio para comentários do realizador.
  2. Carregue as faixas de áudio para o elemento arquivado.
  3. Atualize os dados de registo ao editar o ficheiro de manifesto no portal ou ao atualizar os dados de registo com REST ou um SDK.

Nota

Quando uma faixa de áudio ou texto é removida, o ficheiro subjacente não é removido do contentor de armazenamento. Os Serviços de Multimédia definem o packager dinâmico (ponto final de transmissão em fluxo) para não mostrar as informações sobre a faixa no manifesto ou lista de reprodução pedido pelo leitor de vídeo.

Para obter os passos detalhados da API de Monitorização, veja os Exemplos abaixo.

Amostras

Procedimentos, tutoriais e inícios rápidos

Obter ajuda e suporte

Pode contactar os Serviços de Multimédia com perguntas ou seguir as nossas atualizações através de um dos seguintes métodos: