Mudanças de terminologia e de entidade entre os Serviços de Mídia V2 e V3

  • Artigo

logotipo do guia de migração

etapas da migração 2

Importante

Não é mais necessário migrar do Serviço de Mídia do Azure v2 para v3, pois a substituição da API V2 se alinhará à desativação dos Serviços de Mídia do Azure. Consulte o guia de desativação dos Serviços de Mídia do Azure para obter mais informações.

Este artigo descreve as diferenças de terminologia entre os Serviços de Mídia do Azure v2 a v3.

Alterações de terminologia

  • Um Localizador agora é chamado de Localizador de streaming.
  • Um Canal agora é chamado de Evento ao vivo.
  • Um Programa agora é chamado de Saída Dinâmica.
  • Uma Tarefa agora é chamada de JobOutput, que faz parte de um trabalho.

Alterações de entidade

Entidade V2 Entidade V3 Diretrizes Acessível para V3 Atualizado pelo V3
AccessPolicy A entidade AccessPolicies não existe no V3. Não No
Asset Asset Yes Yes
AssetDeliveryPolicy StreamingPolicy Yes Não
AssetFile A entidade AssetFiles não existe no V3. Embora arquivos (blobs de armazenamento) que você carregar ainda sejam considerados arquivos.

Como alternativa, use as APIs de Armazenamento do Microsoft Azure para enumerar os blobs em um contêiner. Há duas maneiras de aplicar uma transformação aos arquivos com um trabalho:

Arquivos já carregados no armazenamento: o URI inclui a ID do ativo para que os trabalhos sejam feitos nos ativos em uma conta de armazenamento.

Os arquivos a serem carregados durante o processo de transformação e trabalho: o ativo é criado no armazenamento, uma URL de SAS é retornada, os arquivos são carregados no armazenamento e, em seguida, a transformação é aplicada aos arquivos.		 Não Não
Channel LiveEvent Eventos ao vivo substituem os canais da API v2. Eles mantêm a maioria dos recursos e têm mais novos recursos, como transcrições ao vivo, modo de espera e suporte para ingestão de RTMPS.

Confira evento ao vivo na transmissão ao vivo baseada em cenário		 Não Não
ContentKey ContentKeys não é mais uma entidade, agora é uma propriedade de um localizador de streaming.

No v3, os dados de chave de conteúdo são associados ao StreamingLocator (para a criptografia de saída) ou ao próprio ativo (para criptografia de armazenamento do lado do cliente).		 Sim No
ContentKeyAuthorizationPolicy ContentKeyPolicy Yes Não
ContentKeyAuthorizationPolicyOption ContentKeyPolicyOptions são incluídos no ContentKeyPolicy. Sim Não
IngestManifest A entidade IngestManifests não existe no V3. O carregamento de arquivos no V3 envolve a API de armazenamento do Azure. Primeiro, os ativos são criados e, em seguida, os arquivos são carregados no contêiner de armazenamento associado. Há várias outras maneiras de obter dados em um contêiner do Armazenamento do Microsoft Azure que pode ser usado. JobInputHttp também fornece uma maneira de baixar uma entrada de trabalho de uma determinada URL, se desejado. Não Não
IngestManifestAsset Há várias outras maneiras de obter dados em um contêiner do Armazenamento do Microsoft Azure que pode ser usado. JobInputHttp também fornece uma maneira de baixar uma entrada de trabalho de uma determinada URL, se desejado. Não Não
IngestManifestFile Há várias outras maneiras de obter dados em um contêiner do Armazenamento do Microsoft Azure que pode ser usado. JobInputHttp também fornece uma maneira de baixar uma entrada de trabalho de uma determinada URL, se desejado. Não Não
Job Job Crie um Transform antes de criar um Job. Não Não
JobTemplate Transform Use um Transform em seu lugar. Uma transformação é uma entidade separada de um trabalho e é reutilizável. Não No
Locator StreamingLocator Yes Não
MediaProcessor Em vez de procurar o MediaProcessor para usar por nome, use a predefinição desejada ao definir uma transformação. A predefinição usada determinará o processador de mídia usado pelo sistema de trabalho. Confira tópicos de codificação em codificação baseada em cenário. Não NA (somente leitura no V2)
NotificationEndPoint As notificações no v3 são manipuladas por meio da Grade de Eventos do Azure. O NotificationEndpoint é substituído pelo registro de assinatura da Grade de Eventos que também encapsula a configuração dos tipos de notificações a receber (que, em v2, foi tratado pelo JobNotificationSubscription do trabalho, da TaskNotificationSubscription tarefa e da telemetria ComponentMonitoringSetting ). A telemetria v2 foi dividida entre a Grade de Eventos do Azure e o Azure Monitor para se ajustar aos aprimoramentos do ecossistema maior do Azure. Não Não
Program LiveOutput As saídas ao vivo agora substituem os programas na API v3. Não Não
StreamingEndpoint StreamingEndpoint Os pontos de extremidade de streaming permanecem essencialmente os mesmos. Eles são usados para empacotamento dinâmico, criptografia e entrega de conteúdo de HLS e DASH para streaming ao vivo e sob demanda, seja direto da, seja através da CDN. Os novos recursos incluem o suporte para melhor integração e criação de gráficos do Azure Monitor. Sim Sim
Task JobOutput Substituído por JobOutput (que não é mais uma entidade separada na API). Confira tópicos de codificação em codificação baseada em cenário. Não Não
TaskTemplate TransformOutput Substituído por TransformOutput (que não é mais uma entidade separada na API). Confira tópicos de codificação em codificação baseada em cenário. Não Não
Inputs Inputs As entradas e saídas agora estão no nível do trabalho. Confira os tópicos de codificação em codificação baseada em cenário Não Não
Outputs Outputs As entradas e saídas agora estão no nível do trabalho. No V3, o formato de metadados mudou de XML para JSON. As Saídas ao Vivo começam na criação e terminam quando são excluídas. Confira os tópicos de codificação em codificação baseada em cenário Não Não
Outras alterações V2 V3
Armazenamento
Armazenamento Os V3 SDKs agora são desacoplados do Storage SDK, o que lhe dá mais controle sobre a versão do Storage SDK que você deseja usar e evita problemas de controle de versão.
Codificação
Taxas de bits de codificação taxas de bits medidas em kbps, por exemplo, 128 (kbps) bits por segundo, por exemplo, 128000 (bits/segundo)
Codificação do FairPlay de gerenciamento de direitos digitais Nos Serviços de Mídia V2, o vetor de inicialização (IV) pode ser especificado. Nos Serviços de Mídia V3, não é possível especificar FairPlay IV.
Codificador premium Codificador Premium e indexador herdado O Codificador Premium e os processadores analíticos de mídia herdados (visualização dos Serviços de Mídia do Azure Indexer 2, Editor de rosto, etc.) não podem ser acessados pelo V3. Foi adicionado o suporte ao mapeamento de canal de áudio para o codificador Standard. Confira a documentação Áudio no Swagger de codificação dos Serviços de Mídia.
Confira os tópicos de codificação em codificação baseada em cenário
Transformações e trabalhos
HTTPS de processamento baseado em trabalho Para processamento de trabalho baseado em arquivo, você pode usar um URL HTTPS como entrada. Você não precisa ter conteúdo já armazenado no Azure, nem precisa criar Ativos.
Modelos do ARM para trabalhos Os modelos do ARM não existiam na V2. Uma transformação pode ser usada para criar configurações reutilizáveis, criar modelos do Azure Resource Manager e isolar configurações de processamento entre vários clientes ou locatários.
Eventos ao vivo
Ponto de extremidade de streaming Um ponto de extremidade de streaming representa um serviço de streaming que pode distribuir conteúdo diretamente a um aplicativo player do cliente ou a uma CDN (Rede de Distribuição de Conteúdo) para distribuição posterior. Os pontos de extremidade de streaming permanecem essencialmente os mesmos. Eles são usados para empacotamento dinâmico, criptografia e entrega de conteúdo de HLS e DASH para streaming ao vivo e sob demanda, seja direto da, seja através da CDN. Os novos recursos incluem o suporte para melhor integração e criação de gráficos do Azure Monitor.
Canais de eventos ao vivo Os canais são responsáveis pelo processamento de conteúdo de transmissão ao vivo. Um Canal fornece um ponto de extremidade de entrada (URL de ingestão) que você então fornece a um transcodificador ao vivo. O canal recebe transmissões ao vivo de entrada do transcodificador ao vivo e o torna disponível para streaming por meio de um ou mais pontos de extremidade de streaming. Canais também fornecem um ponto de extremidade de visualização prévia (URL de visualização prévia) que você usa para visualizar e validar seu fluxo antes de processamento e da entrega. Eventos ao vivo substituem os canais da API v2. Eles mantêm a maioria dos recursos e têm mais novos recursos, como transcrições ao vivo, modo de espera e suporte para ingestão de RTMPS.
Programas de eventos ao vivo Um Programa permite que você controle a publicação e o armazenamento de segmentos em uma transmissão ao vivo. Os canais gerenciam os programas. A relação entre Canal e Programa é semelhante à mídia tradicional, em que um canal tem um fluxo constante de conteúdo e um programa tem como escopo algum evento regulado naquele canal. Para especificar o número de horas durante o qual manter o conteúdo registrado para o programa, configure a propriedade ArchiveWindowLength. Esse valor pode ser definido entre o mínimo de 5 minutos e o máximo de 25 horas. As saídas ao vivo agora substituem os programas na API v3.
Comprimento do evento ao vivo Você pode transmitir Eventos ao Vivo 24/7 ao usar os Serviços de Mídia para transcodificação de um feed de contribuição de taxa de bits única em um fluxo de saída que tem várias taxas de bits.
Latência de evento ao vivo Novo suporte de transmissão ao vivo de baixa latência em eventos ao vivo.
Versão prévia do evento ao vivo A Versão Prévia do Evento ao Vivo dá suporte ao empacotamento dinâmico e à criptografia dinâmica. Isso permite proteção de conteúdo na Versão Prévia, bem como empacotamento HLS e DASH.
RTMPS de evento ao vivo Suporte aprimorado do RTMPS com maior estabilidade e mais suporte de codificador de código-fonte.
Ingestão segura de RTMPS de eventos ao vivo Ao criar um evento ao vivo, você obtém 4 URLs de ingestão. As 4 URLs de ingestão são quase idênticas, têm o mesmo token de streaming AppId, e apenas a parte do número da porta é diferente. Duas das URLs são primárias e de backup para RTMPS.
Transcrição de evento ao vivo O Serviços de Mídia do Azure fornece vídeo, áudio e texto em diferentes protocolos. Quando você publica sua transmissão ao vivo usando MPEG-DASH ou HLS/CMAF, juntamente com vídeo e áudio, nosso serviço entrega o texto transcrito no TTML compatível com IMSC 1.1.
Modo de espera do evento ao vivo Não havia modo de espera para V2. O modo de espera é um novo recurso v3 que ajuda a gerenciar pools ativos de Eventos ao Vivo. Agora, os clientes podem iniciar um evento ao vivo no modo de espera por um custo menor antes de fazer a transição para o estado de execução. Isso melhora os horários de início do canal e reduz os custos de operação dos pools ativos para inicializações mais rápidas.
Cobrança de evento ao vivo A cobrança dos eventos ao vivo baseia-se em medidores do Canal ao Vivo.
Saídas ao vivo Os programas precisaram ser iniciados após a criação. As Saídas ao Vivo começam na criação e terminam quando são excluídas.

Obter ajuda e suporte

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