Compartilhar via

Diretrizes de migração baseadas em cenário de codificação

  • 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 fornece diretrizes baseadas em cenário de codificação que ajudarão você a migrar dos Serviços de Mídia do Azure v2 para v3.

Pré-requisitos

Antes de começar a alterar o fluxo de trabalho de codificação, você deve entender as diferenças na maneira como o armazenamento é gerenciado. No AMS V3, a API de Armazenamento do Azure é usada para gerenciar a(s) conta(s) de armazenamento associada(s) à sua conta dos Serviços de Mídia.

Observação

Trabalhos e tarefas criados na v2 não aparecem na v3 porque não estão associados a uma transformação. A recomendação é mudar para transformações e trabalhos v3.

Comparação de fluxo de trabalho de codificação

Reserve um tempo para ver os fluxogramas abaixo que comparam visual dos fluxos de trabalho de codificação para V2 e V3.

Fluxo de trabalho de codificação V2

Clique na imagem abaixo para ampliar a versão.

Fluxo de trabalho da codificação ativa para V2

  1. Instalação
    1. Criar um ativo ou use um ativo existente. Se estiver usando um ativo novo, carregue o conteúdo para esse ativo. Se estiver usando um ativo existente, você deverá codificar arquivos que já existem nesse ativo.
    2. Obtenha os valores dos seguintes itens:
      • ID ou objeto do processador de mídia
      • Cadeia de caracteres do codificador (nome) do codificador que você deseja usar
      • ID de ativo do novo ativo OU a ID de ativo do ativo existente
    3. Para monitoramento, crie uma assinatura de notificação de nível de tarefa ou trabalho ou um manipulador de eventos do SDK
  2. Criar o trabalho que contém a tarefa ou as tarefas. Cada tarefa deve incluir os itens acima e:
    • Uma diretiva que um ativo de saída precisa ser criada. O ativo de saída é criado pelo sistema.
    • Nome opcional para o ativo de saída
  3. Enviar o trabalho.
  4. Monitorar trabalho.

Fluxo de trabalho de codificação V3

Fluxo de trabalho da codificação para V3

  1. Configuração
    1. Criar um ativo ou use um ativo existente. Se estiver usando um ativo novo, carregue o conteúdo para esse ativo. Se estiver usando um ativo existente, você deverá codificar arquivos que já existem nesse ativo. Você não deve carregar mais conteúdo para esse ativo.
    2. Criar um ativo de saída. O ativo de saída é onde os arquivos codificados e os metadados de entrada e saída serão armazenados.
    3. Obter valores para a transformação:
      • Predefinição de Codificador Padrão
      • Grupo de recursos AMS
      • O nome da conta AMS
    4. Criar a transformação ou use uma transformação existente. As transformações são reutilizáveis. Não é necessário criar uma nova transformação cada vez que você quiser enviar um trabalho.
  2. Criar um trabalho
    1. Para o trabalho, obtenha os valores para os seguintes itens:
      • Nome da transformação
      • O URI de base para a URL de SAS para seu ativo, o caminho de origem HTTPs do seu compartilhamento de arquivos ou o caminho local dos arquivos. O JobInputAsset também pode usar um nome de ativo como uma entrada.
      • Nome(s) do(s) arquivo(s)
      • Ativo(s) de saída
      • Um grupo de recursos
      • O nome da conta AMS
  3. Use a Grade de Eventos para monitorar seu trabalho.
  4. Enviar o trabalho.

Predefinições personalizadas de codificação V2 a V3

Se o código V2 chamou o Codificador Standard com uma predefinição personalizada, em primeiro lugar você precisa criar uma nova transformação com a predefinição personalizada do Codificador Padrão antes de enviar um trabalho.

Predefinições personalizadas agora são JSON e não são mais baseadas em XML. Recrie sua predefinição em JSON seguindo o esquema predefinido personalizado, conforme definido na documentaçãoTransformar API Aberta (Swagger).

Arquivos de metadados de entrada e saída de um trabalho de codificação

Na v2, os arquivos de metadados de entrada e saída XML são gerados como resultado de um trabalho de codificação. No v3, o formato de metadados mudou de XML para JSON. Para obter mais informações, veja Metadados de entrada e Metadados de saída.

Codificador Premium para o codificador Standard v3 ou soluções baseadas em parceiros

A API v2 não dá mais suporte ao Codificador Premium. Se você usou anteriormente o Codificador Premium baseado em fluxo de trabalho para codificação HEVC, é necessário migrar para o novo Codificador Standard v3 com suporte à codificação HEVC.

Se você precisar dos recursos avançados de fluxo de trabalho do Codificador Premium, será incentivado a começar a usar uma solução de parceiro de codificação avançada do Azure, oriunda deImagine Communications, Telestreamou Bitmovin.

Trabalhos com entradas que estão em URLs hospedadas HTTPS

Agora você pode enviar trabalhos na V3 de arquivos armazenados no armazenamento do Azure, armazenados localmente ou em servidores Web externos usando o suporte de entrada de trabalho HTTP(S).

Se você utilizou fluxos de trabalho anteriormente para copiar arquivos de arquivos de blob do Azure em ativos vazios antes de enviar os trabalhos, poderá simplificar seu fluxo de trabalho passando uma URL de SAS para o arquivo no armazenamento de blob do Azure diretamente para o trabalho.

Transcrição de áudio de indexador v1 para o novo "modo básico" do AudioAnalyzer

Para clientes que utilizam o processador Indexador v1 na API v2, você precisa criar uma transformação que invoca o novo AudioAnalyzer no modo básico antes de enviar um trabalho.

Conceitos de codificação, transformação e trabalhos, tutoriais e guias de como fazer

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: