Como codificar com uma transformação personalizada - .NETHow to encode with a custom transform - .NET

logotipo de serviços de mídia v3media services logo v3


Ao codificar com o Azure Media Services, pode começar rapidamente com uma das predefinições recomendadas com base nas melhores práticas da indústria, como demonstra o tutorial de ficheiros streaming.When encoding with Azure Media Services, you can get started quickly with one of the recommended built-in presets based on industry best practices as demonstrated in the Streaming files tutorial. Também pode construir uma predefinição personalizada para direcionar o seu cenário específico ou requisitos do dispositivo.You can also build a custom preset to target your specific scenario or device requirements.

ConsideraçõesConsiderations

Ao criar predefinições personalizadas, aplicam-se as seguintes considerações:When creating custom presets, the following considerations apply:

  • Todos os valores para altura e largura no conteúdo AVC devem ser múltiplos de 4.All values for height and width on AVC content must be a multiple of 4.
  • No Azure Media Services v3, todos os bitrates codificadores estão em bits por segundo.In Azure Media Services v3, all of the encoding bitrates are in bits per second. Isto é diferente das predefinições com as nossas APIs v2, que usavam quilobits/segundo como unidade.This is different from the presets with our v2 APIs, which used kilobits/second as the unit. Por exemplo, se o bitrate em v2 fosse especificado como 128 (quilobits/segundo), em v3 seria definido para 128000 (bits/segundo).For example, if the bitrate in v2 was specified as 128 (kilobits/second), in v3 it would be set to 128000 (bits/second).

Pré-requisitosPrerequisites

Criar uma conta dos Media ServicesCreate a Media Services account

Transferir o exemploDownload the sample

Clone um repositório GitHub que contenha a amostra completa do núcleo .NET à sua máquina utilizando o seguinte comando:Clone a GitHub repository that contains the full .NET Core sample to your machine using the following command:

git clone https://github.com/Azure-Samples/media-services-v3-dotnet.git

A amostra predefinida personalizada encontra-se na codificação com uma predefinição personalizada utilizando a pasta .NET.The custom preset sample is located in the Encoding with a custom preset using .NET folder.

Criar uma transformação com uma predefinição personalizadaCreate a transform with a custom preset

Ao criar uma nova Transform,tem de especificar o que pretende que produza como saída.When creating a new Transform, you need to specify what you want it to produce as an output. O parâmetro necessário é um objeto TransformOutput, conforme apresentado no código abaixo.The required parameter is a TransformOutput object, as shown in the code below. Cada TransformOutput contém uma Predefinição.Each TransformOutput contains a Preset. O Predefinição descreve as instruções passo a passo das operações de processamento de vídeo e/ou áudio que devem ser utilizadas para gerar o TransformOutput desejado .The Preset describes the step-by-step instructions of video and/or audio processing operations that are to be used to generate the desired TransformOutput. O seguinte TransformOutput cria definições personalizadas de saída de codec e camada.The following TransformOutput creates custom codec and layer output settings.

Ao criar uma Transformação, primeiro deve verificar se já existe uma com o método Get, conforme apresentado no código que se segue.When creating a Transform, you should first check if one already exists using the Get method, as shown in the code that follows. Nos Serviços de Comunicação Social v3, Obtenha métodos sobre entidades que retornem nulos se a entidade não existir (uma verificação caso-insensível no nome).In Media Services v3, Get methods on entities return null if the entity doesn't exist (a case-insensitive check on the name).

Passos seguintesNext steps

Transmitir ficheiros em fluxoStreaming files