Partilhar via


Transforms - Create Or Update

Criar ou Atualizar Transformação
Cria ou atualiza uma nova Transformação.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01

Parâmetros do URI

Name Em Necessário Tipo Description
accountName
path True

string

O nome da conta dos Serviços de Multimédia.

resourceGroupName
path True

string

O nome do grupo de recursos na subscrição do Azure.

subscriptionId
path True

string

O identificador exclusivo de uma subscrição do Microsoft Azure.

transformName
path True

string

O Nome da transformação.

api-version
query True

string

A versão da API a utilizar com o pedido de cliente.

Corpo do Pedido

Name Necessário Tipo Description
properties.outputs True

TransformOutput[]

Uma matriz de um ou mais TransformOutputs que a Transformação deve gerar.

properties.description

string

Uma descrição verbosa opcional da Transformação.

Respostas

Name Tipo Description
200 OK

Transform

OK

201 Created

Transform

Criado

Other Status Codes

ErrorResponse

Informações de erro detalhadas.

Exemplos

Create or update a Transform

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2022-07-01

{
  "properties": {
    "description": "Example Transform to illustrate create and update.",
    "outputs": [
      {
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  }
}

Resposta da amostra

{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:31.7664818Z",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2022-10-17T23:14:31.7664818Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:31.7664818Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
  }
}
{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:31.7664818Z",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2022-10-17T23:14:31.7664818Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:31.7664818Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
  }
}

Definições

Name Description
AacAudio

Descreve as definições de codificação de áudio do Advanced Audio Codec (AAC).

AacAudioProfile

O perfil de codificação a utilizar ao codificar áudio com o AAC.

AnalysisResolution

Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a proporção adequada. Só será redimensionada se o vídeo tiver uma resolução mais alta. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeo de alta resolução. Também pode reduzir o custo de utilização deste componente (veja https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados.

Audio

Define as propriedades comuns para todos os codecs de áudio.

AudioAnalysisMode

Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão.

AudioAnalyzerPreset

A predefinição do Analisador de Áudio aplica um conjunto predefinido de operações de análise baseadas em IA, incluindo transcrição de voz. Atualmente, a predefinição suporta o processamento de conteúdos com uma única faixa de áudio.

AudioOverlay

Descreve as propriedades de uma sobreposição de áudio.

BlurType

Tipo de desfocagem

BuiltInStandardEncoderPreset

Descreve uma predefinição incorporada para codificar o vídeo de entrada com o Codificador Standard.

Complexity

Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão.

CopyAudio

Um sinalizador codec, que indica ao codificador para copiar o bitstream de áudio de entrada.

CopyVideo

Um sinalizador codec, que indica ao codificador para copiar o bitstream de vídeo de entrada sem voltar a codificar.

createdByType

O tipo de identidade que criou o recurso.

DDAudio

Descreve as definições de codificação de áudio do Dolby Digital Audio Codec (AC3). A implementação atual do suporte do Dolby Digital Audio é: números de canais de áudio em 1((mono), 2(estéreo), 6(5.1side); Taxas de frequência de amostragem de áudio em: 32K/44,1K/48K Hz; Os valores de velocidade de transmissão de áudio como especificação AC3 suportam: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Deinterlace

Descreve as definições de eliminação de intercalação.

DeinterlaceMode

O modo de desinterlacagem. A predefinição é AutoPixelAdaptive.

DeinterlaceParity

A paridade do campo para descodificador, é predefinida como Auto.

EncoderNamedPreset

A predefinição incorporada a ser utilizada para codificar vídeos.

EntropyMode

O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

FaceDetectorPreset

Descreve todas as definições a utilizar ao analisar um vídeo para detetar (e, opcionalmente, redigir) todos os rostos presentes.

FaceRedactorMode

Este modo permite escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca as aparências dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado – Foram detetados também rostos de redação (desfocagem). 3) Redação - Isto permite um processo de 2 passagens, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem, e um subconjunto de IDs selecionado pelo utilizador que requerem redação.

Fade

Descreve as propriedades de um efeito Fade aplicado ao suporte de dados de entrada.

Filters

Descreve todas as operações de filtragem, como a eliminação de intercalação, a rotação, etc., que devem ser aplicadas ao suporte de dados de entrada antes da codificação.

H264Complexity

Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado.

H264Layer

Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.264.

H264RateControlMode

O modo de controlo de taxa de vídeo

H264Video

Descreve todas as propriedades para codificar um vídeo com o codec H.264.

H264VideoProfile

Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática.

H265Complexity

Diz ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Equilibrado.

H265Layer

Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.265.

H265Video

Descreve todas as propriedades para codificar um vídeo com o codec H.265.

H265VideoProfile

Atualmente, suportamos o Main. A predefinição é Automática.

Image

Descreve as propriedades básicas para gerar miniaturas a partir do vídeo de entrada

ImageFormat

Descreve as propriedades de um ficheiro de imagem de saída.

InsightsType

Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo.

InterleaveOutput

Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados.

JpgFormat

Descreve as definições para produzir miniaturas JPEG.

JpgImage

Descreve as propriedades para produzir uma série de imagens JPEG a partir do vídeo de entrada.

JpgLayer

Descreve as definições para produzir uma imagem JPEG a partir do vídeo de entrada.

Mp4Format

Descreve as propriedades de um ficheiro ISO MP4 de saída.

MultiBitrateFormat

Descreve as propriedades para produzir uma coleção de ficheiros de velocidade de transmissão múltipla alinhados com GOP. O comportamento predefinido é produzir um ficheiro de saída para cada camada de vídeo, que é codificada juntamente com todos os áudios. Os ficheiros de saída exatos produzidos podem ser controlados ao especificar a coleção outputFiles.

OnErrorType

Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob".

OutputFile

Representa um ficheiro de saída produzido.

PngFormat

Descreve as definições para a produção de miniaturas PNG.

PngImage

Descreve as propriedades para produzir uma série de imagens PNG a partir do vídeo de entrada.

PngLayer

Descreve as definições para produzir uma imagem PNG a partir do vídeo de entrada.

PresetConfigurations

Um objeto de definições de configuração opcionais para codificador.

Priority

Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal.

Rectangle

Descreve as propriedades de uma janela retangular aplicada ao suporte de dados de entrada antes de a processar.

Rotation

A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática

StandardEncoderPreset

Descreve todas as definições a utilizar ao codificar o vídeo de entrada com o Codificador Standard.

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é o Dimensionamento Automático

systemData

Metadados relativos à criação e última modificação do recurso.

Transform

Uma Transformação encapsula as regras ou instruções para gerar as saídas pretendidas a partir de suportes de dados de entrada, como transcodificação ou extração de informações. Após a criação da Transformação, pode ser aplicada ao suporte de dados de entrada ao criar Tarefas.

TransformOutput

Descreve as propriedades de um TransformOutput, que são as regras a aplicar ao gerar o resultado pretendido.

TransportStreamFormat

Descreve as propriedades para gerar um(s) MPEG-2 Transport Stream (ISO/IEC 13818-1) ficheiro(s) de vídeo de saída.

Video

Descreve as propriedades básicas para codificar o vídeo de entrada.

VideoAnalyzerPreset

Uma predefinição do analisador de vídeo que extrai informações (metadados avançados) de áudio e vídeo e produz um ficheiro de formato JSON.

VideoOverlay

Descreve as propriedades de uma sobreposição de vídeo.

VideoSyncMode

Modo de Sincronização de Vídeo

AacAudio

Descreve as definições de codificação de áudio do Advanced Audio Codec (AAC).

Name Tipo Description
@odata.type string:

#Microsoft.Media.AacAudio

O discriminador para tipos derivados.

bitrate

integer

A velocidade de transmissão, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento do muxing.

profile

AacAudioProfile

O perfil de codificação a utilizar ao codificar áudio com o AAC.

samplingRate

integer

A taxa de amostragem a utilizar para codificação no hertz.

AacAudioProfile

O perfil de codificação a utilizar ao codificar áudio com o AAC.

Name Tipo Description
AacLc

string

Especifica que o áudio de saída deve ser codificado no perfil AAC Low Complexity (AAC-LC).

HeAacV1

string

Especifica que o áudio de saída deve ser codificado no perfil HE-AAC v1.

HeAacV2

string

Especifica que o áudio de saída deve ser codificado no perfil HE-AAC v2.

AnalysisResolution

Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a proporção adequada. Só será redimensionada se o vídeo tiver uma resolução mais alta. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeo de alta resolução. Também pode reduzir o custo de utilização deste componente (veja https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados.

Name Tipo Description
SourceResolution

string

StandardDefinition

string

Audio

Define as propriedades comuns para todos os codecs de áudio.

Name Tipo Description
@odata.type string:

#Microsoft.Media.Audio

O discriminador para tipos derivados.

bitrate

integer

A velocidade de transmissão, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

samplingRate

integer

A taxa de amostragem a utilizar para codificação no hertz.

AudioAnalysisMode

Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão.

Name Tipo Description
Basic

string

Este modo executa a transcrição de voz em texto e a geração de um ficheiro de subtítulo/legenda VTT. O resultado deste modo inclui um ficheiro JSON do Insights, incluindo apenas as palavras-chave, transcrição e informações de temporização. A deteção automática de idiomas e a diarização de orador não estão incluídas neste modo.

Standard

string

Efetua todas as operações incluídas no modo Básico, além de efetuar a deteção de idioma e a diarização de orador.

AudioAnalyzerPreset

A predefinição do Analisador de Áudio aplica um conjunto predefinido de operações de análise baseadas em IA, incluindo transcrição de voz. Atualmente, a predefinição suporta o processamento de conteúdos com uma única faixa de áudio.

Name Tipo Description
@odata.type string:

#Microsoft.Media.AudioAnalyzerPreset

O discriminador para tipos derivados.

audioLanguage

string

O idioma do payload de áudio na entrada com o formato BCP-47 de "language tag-region" (por exemplo, "en-US"). Se souber o idioma do seu conteúdo, recomenda-se que o especifique. O idioma tem de ser especificado explicitamente para AudioAnalysisMode::Basic, uma vez que a deteção automática de idiomas não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a deteção automática de idiomas escolherá o primeiro idioma detetado e processará com o idioma selecionado durante a duração do ficheiro. Atualmente, não suporta alternar dinamicamente entre idiomas após a deteção do primeiro idioma. A deteção automática funciona melhor com gravações de áudio com voz claramente perceptível. Se a deteção automática não encontrar o idioma, a transcrição reverterá para "en-US". A lista de idiomas suportados está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido

mode

AudioAnalysisMode

Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Standard.

AudioOverlay

Descreve as propriedades de uma sobreposição de áudio.

Name Tipo Description
@odata.type string:

#Microsoft.Media.AudioOverlay

O discriminador para tipos derivados.

audioGainLevel

number

O nível de ganho de áudio na sobreposição. O valor deve estar no intervalo [0, 1,0]. A predefinição é 1.0.

end

string

A posição final, com referência ao vídeo de entrada, no qual a sobreposição termina. O valor deve estar no formato ISO 8601. Por exemplo, PT30S para terminar a sobreposição a 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior do que a duração do vídeo de entrada, a sobreposição será aplicada até ao fim do vídeo de entrada se a duração do suporte de dados de sobreposição for maior do que a duração do vídeo de entrada, caso contrário, a sobreposição irá durar até à duração do suporte de dados de sobreposição.

fadeInDuration

string

A duração sobre a qual a sobreposição se desvanece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S).

fadeOutDuration

string

A duração sobre a qual a sobreposição desaparece do vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S).

inputLabel

string

A etiqueta da entrada da tarefa que deve ser utilizada como uma sobreposição. A Entrada tem de especificar exatamente um ficheiro. Pode especificar um ficheiro de imagem no formato JPG, PNG, GIF ou BMP ou um ficheiro de áudio (como um ficheiro WAV, MP3, WMA ou M4A) ou um ficheiro de vídeo. Veja https://aka.ms/mesformats para obter a lista completa dos formatos de ficheiro de áudio e vídeo suportados.

start

string

A posição de início, com referência ao vídeo de entrada, no qual a sobreposição é iniciada. O valor deve estar no formato ISO 8601. Por exemplo, PT05S para iniciar a sobreposição a 5 segundos no vídeo de entrada. Se não for especificada, a sobreposição começa a partir do início do vídeo de entrada.

BlurType

Tipo de desfocagem

Name Tipo Description
Black

string

Preto: Filtro de desa black out

Box

string

Caixa: filtro de depuração, apenas caixa delimitadora

High

string

Alto: confundir filtro de desfocagem

Low

string

Baixo: filtro de desfocagem de carro de caixa

Med

string

Med: Filtro de desfocagem gaussiano

BuiltInStandardEncoderPreset

Descreve uma predefinição incorporada para codificar o vídeo de entrada com o Codificador Standard.

Name Tipo Description
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

O discriminador para tipos derivados.

configurations

PresetConfigurations

Definições de configuração opcionais para codificador. As configurações só são suportadas para ContentAwareEncoding e H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

A predefinição incorporada a ser utilizada para codificar vídeos.

Complexity

Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão.

Name Tipo Description
Balanced

string

Configura o codificador para utilizar definições que conseguem um equilíbrio entre velocidade e qualidade.

Quality

string

Configura o codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento do tempo de codificação geral mais lento.

Speed

string

Configura o codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

CopyAudio

Um sinalizador codec, que indica ao codificador para copiar o bitstream de áudio de entrada.

Name Tipo Description
@odata.type string:

#Microsoft.Media.CopyAudio

O discriminador para tipos derivados.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

CopyVideo

Um sinalizador codec, que indica ao codificador para copiar o bitstream de vídeo de entrada sem voltar a codificar.

Name Tipo Description
@odata.type string:

#Microsoft.Media.CopyVideo

O discriminador para tipos derivados.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DDAudio

Descreve as definições de codificação de áudio do Dolby Digital Audio Codec (AC3). A implementação atual do suporte do Dolby Digital Audio é: números de canais de áudio em 1((mono), 2(estéreo), 6(5.1side); Taxas de frequência de amostragem de áudio em: 32K/44,1K/48K Hz; Os valores de velocidade de transmissão de áudio como especificação AC3 suportam: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Name Tipo Description
@odata.type string:

#Microsoft.Media.DDAudio

O discriminador para tipos derivados.

bitrate

integer

A velocidade de transmissão, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento do muxing.

samplingRate

integer

A taxa de amostragem a utilizar para codificação no hertz.

Deinterlace

Descreve as definições de eliminação de intercalação.

Name Tipo Description
mode

DeinterlaceMode

O modo de desinterlacagem. Predefinição para AutoPixelAdaptive.

parity

DeinterlaceParity

A paridade do campo para descodificador, é predefinida como Auto.

DeinterlaceMode

O modo de desinterlacagem. A predefinição é AutoPixelAdaptive.

Name Tipo Description
AutoPixelAdaptive

string

Aplique a descodificadora adaptável automática de píxeis em cada frame no vídeo de entrada.

Off

string

Desativa a eliminação de intercalação do vídeo de origem.

DeinterlaceParity

A paridade do campo para descodificador, é predefinida como Auto.

Name Tipo Description
Auto

string

Detetar automaticamente a ordem dos campos

BottomFieldFirst

string

Aplique o primeiro processamento do campo inferior do vídeo de entrada.

TopFieldFirst

string

Aplique o primeiro processamento do campo superior do vídeo de entrada.

EncoderNamedPreset

A predefinição incorporada a ser utilizada para codificar vídeos.

Name Tipo Description
AACGoodQualityAudio

string

Produz um único ficheiro MP4 que contém apenas áudio estéreo AAC codificado a 192 kbps.

AdaptiveStreaming

string

Produz um conjunto de ficheiros MP4 alinhados com GOP com vídeo H.264 e áudio AAC estéreo. Gera automaticamente uma escada de velocidade de transmissão com base na resolução de entrada, velocidade de transmissão e taxa de fotogramas. A predefinição gerada automaticamente nunca excederá a resolução de entrada. Por exemplo, se a entrada for de 720p, a saída permanecerá, na melhor das hipóteses, 720p.

ContentAwareEncoding

string

Produz um conjunto de MP4s alinhados com GOP através da codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço realiza uma análise simples inicial do conteúdo de entrada e utiliza os resultados para determinar o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega através da transmissão em fluxo adaptável. Esta predefinição é particularmente eficaz para vídeos de complexidade baixa e média, onde os ficheiros de saída estarão em velocidades de transmissão mais baixas, mas com uma qualidade que ainda proporciona uma boa experiência aos espectadores. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados.

ContentAwareEncodingExperimental

string

Expõe uma predefinição experimental para codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço tenta determinar automaticamente o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega por transmissão em fluxo adaptável. Os algoritmos subjacentes continuarão a evoluir ao longo do tempo. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados.

CopyAllBitrateNonInterleaved

string

Copie todos os fluxos de vídeo e áudio do elemento de entrada como ficheiros de saída de áudio e vídeo não intercalados. Esta predefinição pode ser utilizada para recortar um recurso existente ou converter um grupo de ficheiros MP4 alinhados com moldura de chave (GOP) como um recurso que pode ser transmitido em fluxo.

DDGoodQualityAudio

string

Produz um único ficheiro MP4 que contém apenas áudio estéreo DD (Digital Dolby) codificado a 192 kbps.

H264MultipleBitrate1080p

string

Produz um conjunto de 8 ficheiros MP4 alinhados com GOP, que variam entre 6000 kbps e 400 kbps e áudio AAC estéreo. A resolução começa a 1080p e desce para 180p.

H264MultipleBitrate720p

string

Produz um conjunto de 6 ficheiros MP4 alinhados com GOP, que variam entre 3400 kbps e 400 kbps e áudio AAC estéreo. A resolução começa nos 720p e desce para 180p.

H264MultipleBitrateSD

string

Produz um conjunto de 5 ficheiros MP4 alinhados com GOP, que variam entre 1900 kbps e 400 kbps e áudio AAC estéreo. A resolução começa nos 480p e desce para 240p.

H264SingleBitrate1080p

string

Produz um ficheiro MP4 onde o vídeo é codificado com codec H.264 a 6750 kbps e uma altura de imagem de 1080 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

H264SingleBitrate720p

string

Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.264 a 4500 kbps e uma altura de imagem de 720 píxeis e o áudio estéreo é codificado com o codec AAC-LC a 128 kbps.

H264SingleBitrateSD

string

Produz um ficheiro MP4 em que o vídeo é codificado com um codec H.264 a 2200 kbps e uma altura de imagem de 480 píxeis e o áudio estéreo é codificado com o codec AAC-LC a 128 kbps.

H265AdaptiveStreaming

string

Produz um conjunto de ficheiros MP4 alinhados com GOP com vídeo H.265 e áudio AAC estéreo. Gera automaticamente uma escada de velocidade de transmissão com base na resolução de entrada, velocidade de transmissão e taxa de fotogramas. A predefinição gerada automaticamente nunca excederá a resolução de entrada. Por exemplo, se a entrada for de 720p, a saída permanecerá, na melhor das hipóteses, 720p.

H265ContentAwareEncoding

string

Produz um conjunto de MP4s alinhados com GOP através da codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço realiza uma análise simples inicial do conteúdo de entrada e utiliza os resultados para determinar o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega através da transmissão em fluxo adaptável. Esta predefinição é particularmente eficaz para vídeos de complexidade baixa e média, onde os ficheiros de saída estarão em velocidades de transmissão mais baixas, mas com uma qualidade que ainda proporciona uma boa experiência aos espectadores. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados.

H265SingleBitrate1080p

string

Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 3500 kbps e uma altura de imagem de 1080 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

H265SingleBitrate4K

string

Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 9500 kbps e uma altura de imagem de 2160 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

H265SingleBitrate720p

string

Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 1800 kbps e uma altura de imagem de 720 píxeis e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

EntropyMode

O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível.

Name Tipo Description
Cabac

string

Codificação de entropia do Codificador Aritmético Binário de Contexto (CABAC).

Cavlc

string

Codificação de entropia do Codificador de Comprimento de Variável Adaptável de Contexto (CAVLC).

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

FaceDetectorPreset

Descreve todas as definições a utilizar ao analisar um vídeo para detetar (e, opcionalmente, redigir) todos os rostos presentes.

Name Tipo Description
@odata.type string:

#Microsoft.Media.FaceDetectorPreset

O discriminador para tipos derivados.

blurType

BlurType

Tipo de desfocagem

experimentalOptions

object

Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido

mode

FaceRedactorMode

Este modo fornece a capacidade de escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca os aspetos dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado - Também foram detetados rostos de redação(desfocados). 3) Redact - Isto permite um processo de 2 passes, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem e um subconjunto selecionado pelo utilizador de IDs que requerem redação.

resolution

AnalysisResolution

Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" irá redimensionar os vídeos de entrada para a definição padrão, preservando ao mesmo tempo a proporção adequada. Só será redimensionada se o vídeo for de resolução superior. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeos de alta resolução. Também pode reduzir o custo de utilização deste componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados.

FaceRedactorMode

Este modo permite escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca as aparências dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado – Foram detetados também rostos de redação (desfocagem). 3) Redação - Isto permite um processo de 2 passagens, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem, e um subconjunto de IDs selecionado pelo utilizador que requerem redação.

Name Tipo Description
Analyze

string

O modo de análise deteta rostos e produz um ficheiro de metadados com os resultados. Permite a edição do ficheiro de metadados antes de os rostos serem desfocados com o modo Redact.

Combined

string

O modo combinado faz com que os passos Analisar e Redigir num só passo ao editar os rostos analisados não são os pretendidos.

Redact

string

O modo de redação consome o ficheiro de metadados do modo Analisar e redigi os rostos encontrados.

Fade

Descreve as propriedades de um efeito Fade aplicado ao suporte de dados de entrada.

Name Tipo Description
duration

string

A Duração do efeito de desvanecimento no vídeo. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para desvanecer uma cor durante 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para desaparecer 10 fotogramas a partir da hora de início) ou um valor relativo à duração do fluxo (por exemplo, 10% para desaparecer 10% da duração do fluxo)

fadeColor

string

A Cor para a entrada/saída desvanecimento. pode estar nas cores https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords do Nível CSS1 ou num valor RGB/hexadecim: por exemplo: rgb(255,0,0), 0xFF0000 ou #FF0000

start

string

A posição no vídeo de entrada a partir de onde começar a desaparecer. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). A predefinição é 0

Filters

Descreve todas as operações de filtragem, como a eliminação de intercalação, a rotação, etc., que devem ser aplicadas ao suporte de dados de entrada antes da codificação.

Name Tipo Description
crop

Rectangle

Os parâmetros da janela retangular com a qual recortar o vídeo de entrada.

deinterlace

Deinterlace

As definições de eliminação de intercalação.

fadeIn

Fade

Descreve as propriedades de um efeito Desvanecer aplicado ao suporte de dados de entrada.

fadeOut

Fade

Descreve as propriedades de um efeito Desvanecer aplicado ao suporte de dados de entrada.

overlays Overlay[]:

As propriedades das sobreposições a aplicar ao vídeo de entrada. Podem ser sobreposições de áudio, imagem ou vídeo.

rotation

Rotation

A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática

H264Complexity

Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado.

Name Tipo Description
Balanced

string

Diz ao codificador para utilizar definições que conseguem um equilíbrio entre a velocidade e a qualidade.

Quality

string

Indica ao codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento do tempo de codificação geral mais lento.

Speed

string

Indica ao codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

H264Layer

Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.264.

Name Tipo Description
adaptiveBFrame

boolean

Se as molduras B adaptáveis devem ou não ser utilizadas ao codificar esta camada. Se não for especificado, o codificador irá ativá-lo sempre que o perfil de vídeo permitir a sua utilização.

bFrames

integer

O número de fotogramas B a utilizar ao codificar esta camada. Se não for especificado, o codificador escolhe um número adequado com base no perfil e nível de vídeo.

bitrate

integer

A velocidade de transmissão média em bits por segundo para codificar o vídeo de entrada ao gerar esta camada. Este é um campo obrigatório.

bufferWindow

string

O comprimento da janela da memória intermédia VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. A predefinição é de 5 segundos (por exemplo, PT5S).

crf

number

O valor de CRF a ser utilizado ao codificar esta camada. Esta definição entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor CRF é entre 0 e 51, em que os valores mais baixos resultariam numa melhor qualidade, em detrimento de tamanhos de ficheiro mais elevados. Os valores mais elevados significam mais compressão, mas em algum momento a degradação da qualidade será notada. O valor predefinido é 23.

entropyMode

EntropyMode

O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível.

frameRate

string

A taxa de fotogramas (em fotogramas por segundo) para codificar esta camada. O valor pode ser na forma de M/N em que M e N são números inteiros (por exemplo, 30000/1001) ou na forma de um número (por exemplo, 30 ou 29,97). O codificador impõe restrições às taxas de fotogramas permitidas com base no perfil e no nível. Se não for especificado, o codificador utilizará a mesma taxa de fotogramas que o vídeo de entrada.

height

string

A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada.

label

string

A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída.

level

string

Atualmente, suportamos o Nível até 6.2. O valor pode ser Automático ou um número que corresponda ao perfil H.264. Se não for especificado, a predefinição é Automático, o que permite ao codificador escolher o Nível adequado para esta camada.

maxBitrate

integer

A velocidade de transmissão máxima (em bits por segundo), na qual a memória intermédia VBV deve ser assumida como recarga. Se não for especificado, a predefinição é o mesmo valor que a velocidade de transmissão.

profile

H264VideoProfile

Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática.

referenceFrames

integer

O número de fotogramas de referência a utilizar ao codificar esta camada. Se não for especificado, o codificador determina um número adequado com base na definição de complexidade do codificador.

slices

integer

O número de setores a utilizar ao codificar esta camada. Se não for especificado, a predefinição é zero, o que significa que o codificador utilizará um único setor para cada moldura.

width

string

A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada.

H264RateControlMode

O modo de controlo de taxa de vídeo

Name Tipo Description
ABR

string

Modo de Velocidade de Transmissão Média (ABR) que atinge a velocidade de transmissão de destino: modo predefinido.

CBR

string

Modo de Velocidade de Transmissão Constante (CBR) que aperta as variações de velocidade de transmissão em torno da velocidade de transmissão de destino.

CRF

string

Modo De Fator de Taxa Constante (CRF) que visa a qualidade subjetiva constante.

H264Video

Descreve todas as propriedades para codificar um vídeo com o codec H.264.

Name Tipo Description
@odata.type string:

#Microsoft.Media.H264Video

O discriminador para tipos derivados.

complexity

H264Complexity

Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

layers

H264Layer[]

A coleção de camadas H.264 de saída a produzir pelo codificador.

rateControlMode

H264RateControlMode

O modo de controlo de taxa de vídeo

sceneChangeDetection

boolean

Se o codificador deve ou não inserir fotogramas de chave nas alterações de cena. Se não for especificado, a predefinição é falsa. Este sinalizador deve ser definido como verdadeiro apenas quando o codificador estiver a ser configurado para produzir um único vídeo de saída.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

H264VideoProfile

Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática.

Name Tipo Description
Auto

string

Indica ao codificador para determinar automaticamente o perfil H.264 adequado.

Baseline

string

Perfil de linha de base

High

string

Perfil elevado.

High422

string

Perfil alto 4:2:2.

High444

string

Perfil preditivo elevado de 4:4:4.

Main

string

Perfil principal

H265Complexity

Diz ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Equilibrado.

Name Tipo Description
Balanced

string

Diz ao codificador para utilizar definições que conseguem um equilíbrio entre velocidade e qualidade.

Quality

string

Diz ao codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento de um tempo de codificação geral mais lento.

Speed

string

Diz ao codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

H265Layer

Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.265.

Name Tipo Description
adaptiveBFrame

boolean

Especifica se os fotogramas B adaptáveis devem ou não ser utilizados ao codificar esta camada. Se não for especificado, o codificador irá ativá-lo sempre que o perfil de vídeo permitir a sua utilização.

bFrames

integer

O número de fotogramas B a utilizar ao codificar esta camada. Se não for especificado, o codificador escolhe um número adequado com base no perfil e nível de vídeo.

bitrate

integer

A velocidade de transmissão média em bits por segundo para codificar o vídeo de entrada ao gerar esta camada. Por exemplo: uma velocidade de bit de destino de 3000 Kbps ou 3 Mbps significa que este valor deve ser 3000000 Este é um campo obrigatório.

bufferWindow

string

O comprimento da janela da memória intermédia VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. A predefinição é de 5 segundos (por exemplo, PT5S).

crf

number

O valor de CRF a ser utilizado ao codificar esta camada. Esta definição entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor CRF é entre 0 e 51, em que os valores mais baixos resultariam numa melhor qualidade, em detrimento de tamanhos de ficheiro mais elevados. Os valores mais elevados significam mais compressão, mas em algum momento a degradação da qualidade será notada. O valor predefinido é 28.

frameRate

string

A taxa de fotogramas (em fotogramas por segundo) para codificar esta camada. O valor pode ser na forma de M/N em que M e N são números inteiros (por exemplo, 30000/1001) ou na forma de um número (por exemplo, 30 ou 29,97). O codificador impõe restrições às taxas de fotogramas permitidas com base no perfil e no nível. Se não for especificado, o codificador utilizará a mesma taxa de fotogramas que o vídeo de entrada.

height

string

A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada.

label

string

A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída.

level

string

Atualmente, suportamos o Nível até 6.2. O valor pode ser Automático ou um número que corresponda ao perfil H.265. Se não for especificado, a predefinição é Automático, o que permite ao codificador escolher o Nível adequado para esta camada.

maxBitrate

integer

A velocidade de transmissão máxima (em bits por segundo), na qual a memória intermédia VBV deve ser assumida como recarga. Se não for especificado, a predefinição é o mesmo valor que a velocidade de transmissão.

profile

H265VideoProfile

Atualmente, suportamos o Main. A predefinição é Automática.

referenceFrames

integer

O número de fotogramas de referência a utilizar ao codificar esta camada. Se não for especificado, o codificador determina um número adequado com base na definição de complexidade do codificador.

slices

integer

O número de setores a utilizar ao codificar esta camada. Se não for especificado, a predefinição é zero, o que significa que o codificador utilizará um único setor para cada moldura.

width

string

A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada.

H265Video

Descreve todas as propriedades para codificar um vídeo com o codec H.265.

Name Tipo Description
@odata.type string:

#Microsoft.Media.H265Video

O discriminador para tipos derivados.

complexity

H265Complexity

Indica ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Balanceado.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

layers

H265Layer[]

A coleção de camadas H.265 de saída a produzir pelo codificador.

sceneChangeDetection

boolean

Especifica se o codificador deve ou não inserir fotogramas de chave nas alterações de cena. Se não for especificado, a predefinição é falsa. Este sinalizador deve ser definido como verdadeiro apenas quando o codificador estiver a ser configurado para produzir um único vídeo de saída.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

H265VideoProfile

Atualmente, suportamos o Main. A predefinição é Automática.

Name Tipo Description
Auto

string

Indica ao codificador para determinar automaticamente o perfil H.265 adequado.

Main

string

Perfil principal (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)

Main10

string

Perfil principal 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Descreve as propriedades básicas para gerar miniaturas a partir do vídeo de entrada

Name Tipo Description
@odata.type string:

#Microsoft.Media.Image

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

range

string

A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo.

start

string

A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}.

step

string

Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

ImageFormat

Descreve as propriedades de um ficheiro de imagem de saída.

Name Tipo Description
@odata.type string:

#Microsoft.Media.ImageFormat

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

InsightsType

Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo.

Name Tipo Description
AllInsights

string

Gerar informações de áudio e vídeo. Falha se o Audio ou o Video Insights falharem.

AudioInsightsOnly

string

Gerar apenas informações de áudio. Ignore o vídeo mesmo que esteja presente. Falha se não existir áudio.

VideoInsightsOnly

string

Gerar apenas informações de vídeo. Ignore o áudio se estiver presente. Falha se não existir nenhum vídeo.

InterleaveOutput

Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados.

Name Tipo Description
InterleavedOutput

string

A saída inclui áudio e vídeo.

NonInterleavedOutput

string

A saída é apenas de vídeo ou apenas áudio.

JpgFormat

Descreve as definições para produzir miniaturas JPEG.

Name Tipo Description
@odata.type string:

#Microsoft.Media.JpgFormat

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

JpgImage

Descreve as propriedades para produzir uma série de imagens JPEG a partir do vídeo de entrada.

Name Tipo Description
@odata.type string:

#Microsoft.Media.JpgImage

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

layers

JpgLayer[]

Uma coleção de camadas de imagem JPEG de saída a serem produzidas pelo codificador.

range

string

A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo.

spriteColumn

integer

Define o número de colunas utilizadas na imagem de sprite de miniaturas. O número de linhas é calculado automaticamente e é gerado um ficheiro VTT com os mapeamentos de coordenadas para cada miniatura no sprite. Nota: este valor deve ser um número inteiro positivo e é recomendado um valor adequado para que a resolução da imagem de saída não ultrapasse o limite máximo de resolução de píxeis JPEG 65535x65535.

start

string

A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}.

step

string

Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

JpgLayer

Descreve as definições para produzir uma imagem JPEG a partir do vídeo de entrada.

Name Tipo Description
height

string

A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada.

label

string

A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída.

quality

integer

A qualidade de compressão da saída JPEG. O intervalo é de 0 a 100 e a predefinição é 70.

width

string

A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada.

Mp4Format

Descreve as propriedades de um ficheiro ISO MP4 de saída.

Name Tipo Description
@odata.type string:

#Microsoft.Media.Mp4Format

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

outputFiles

OutputFile[]

A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto.

MultiBitrateFormat

Descreve as propriedades para produzir uma coleção de ficheiros de velocidade de transmissão múltipla alinhados com GOP. O comportamento predefinido é produzir um ficheiro de saída para cada camada de vídeo, que é codificada juntamente com todos os áudios. Os ficheiros de saída exatos produzidos podem ser controlados ao especificar a coleção outputFiles.

Name Tipo Description
@odata.type string:

#Microsoft.Media.MultiBitrateFormat

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

outputFiles

OutputFile[]

A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto.

OnErrorType

Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob".

Name Tipo Description
ContinueJob

string

Indica ao serviço que, se este TransformOutput falhar, permita que qualquer outro TransformOutput continue.

StopProcessingJob

string

Indica ao serviço que, se este TransformOutput falhar, quaisquer outros TransformOutputs incompletos podem ser parados.

OutputFile

Representa um ficheiro de saída produzido.

Name Tipo Description
labels

string[]

A lista de etiquetas que descrevem como o codificador deve utilizar o vídeo e o áudio multiplex num ficheiro de saída. Por exemplo, se o codificador estiver a produzir duas camadas de vídeo com etiquetas v1 e v2 e uma camada de áudio com a etiqueta a1, uma matriz como "[v1, a1]" indica ao codificador para produzir um ficheiro de saída com a faixa de vídeo representada pela v1 e a faixa de áudio representada por a1.

PngFormat

Descreve as definições para a produção de miniaturas PNG.

Name Tipo Description
@odata.type string:

#Microsoft.Media.PngFormat

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

PngImage

Descreve as propriedades para produzir uma série de imagens PNG a partir do vídeo de entrada.

Name Tipo Description
@odata.type string:

#Microsoft.Media.PngImage

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

layers

PngLayer[]

Uma coleção de camadas de imagem PNG de saída a serem produzidas pelo codificador.

range

string

A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo.

start

string

A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}.

step

string

Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

PngLayer

Descreve as definições para produzir uma imagem PNG a partir do vídeo de entrada.

Name Tipo Description
height

string

A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada.

label

string

A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída.

width

string

A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada.

PresetConfigurations

Um objeto de definições de configuração opcionais para codificador.

Name Tipo Description
complexity

Complexity

Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina a Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão.

interleaveOutput

InterleaveOutput

Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados.

keyFrameIntervalInSeconds

number

O intervalo da moldura da chave em segundos. Exemplo: defina KeyFrameIntervalInSeconds como 2 para reduzir a memória intermédia de reprodução para alguns jogadores.

maxBitrateBps

integer

A velocidade de transmissão máxima em bits por segundo (limiar para a camada de vídeo superior). Exemplo: defina MaxBitrateBps como 6000000 para evitar produzir saídas de velocidade de transmissão muito elevadas para conteúdos com elevada complexidade.

maxHeight

integer

A altura máxima das camadas de vídeo de saída. Exemplo: defina MaxHeight como 720 para produzir camadas de saída até 720P, mesmo que a entrada seja 4K.

maxLayers

integer

O número máximo de camadas de vídeo de saída. Exemplo: defina MaxLayers como 4 para garantir que, no máximo, são produzidas 4 camadas de saída para controlar o custo geral da tarefa de codificação.

minBitrateBps

integer

A velocidade de transmissão mínima em bits por segundo (limiar para a camada de vídeo inferior). Exemplo: defina MinBitrateBps como 200000 para ter uma camada inferior que abrange utilizadores com largura de banda de rede baixa.

minHeight

integer

A altura mínima das camadas de vídeo de saída. Exemplo: defina MinHeight como 360 para evitar camadas de saída de resoluções mais pequenas, como 180P.

Priority

Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal.

Name Tipo Description
High

string

Utilizado para TransformOutputs que deve ter precedência sobre outras pessoas.

Low

string

Utilizado para TransformOutputs que podem ser gerados após TransformOutputs de prioridade normal e alta.

Normal

string

Utilizado para TransformOutputs que podem ser gerados na prioridade Normal.

Rectangle

Descreve as propriedades de uma janela retangular aplicada ao suporte de dados de entrada antes de a processar.

Name Tipo Description
height

string

A altura da região retangular em píxeis. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%).

left

string

O número de píxeis da margem esquerda. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%).

top

string

O número de píxeis da margem superior. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%).

width

string

A largura da região retangular em píxeis. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%).

Rotation

A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática

Name Tipo Description
Auto

string

Detetar e rodar automaticamente conforme necessário.

None

string

Não rode o vídeo. Se o formato de saída o suportar, quaisquer metadados sobre a rotação são mantidos intactos.

Rotate0

string

Não rode o vídeo, mas remova quaisquer metadados sobre a rotação.

Rotate180

string

Rode 180 graus no sentido dos ponteiros do relógio.

Rotate270

string

Rode 270 graus no sentido dos ponteiros do relógio.

Rotate90

string

Rode 90 graus no sentido dos ponteiros do relógio.

StandardEncoderPreset

Descreve todas as definições a utilizar ao codificar o vídeo de entrada com o Codificador Standard.

Name Tipo Description
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

O discriminador para tipos derivados.

codecs Codec[]:

A lista de codecs a utilizar ao codificar o vídeo de entrada.

experimentalOptions

object

Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido

filters

Filters

Uma ou mais operações de filtragem que são aplicadas ao suporte de dados de entrada antes da codificação.

formats Format[]:

A lista de saídas a produzir pelo codificador.

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é o Dimensionamento Automático

Name Tipo Description
AutoFit

string

Preencho a saída (com caixa de correio ou pilar) para respeitar a resolução de saída, garantindo ao mesmo tempo que a região de vídeo ativa na saída tem a mesma proporção que a entrada. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, a saída será a 1280x1280, que contém um retângulo interno de 1280x720 na proporção de 16:9 e as regiões da caixa do pilar com 280 píxeis de largura à esquerda e à direita.

AutoSize

string

Substitua a resolução de saída e altere-a para corresponder à proporção de apresentação da entrada, sem preenchimento. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, o valor na predefinição será substituído e o resultado será 1280x720, que mantém a proporção de entrada de 16:9.

None

string

Respeite estritamente a resolução de saída sem considerar a proporção de píxeis ou apresentar a proporção do vídeo de entrada.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

Transform

Uma Transformação encapsula as regras ou instruções para gerar as saídas pretendidas a partir de suportes de dados de entrada, como transcodificação ou extração de informações. Após a criação da Transformação, pode ser aplicada ao suporte de dados de entrada ao criar Tarefas.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.created

string

A data e hora UTC em que a Transformação foi criada, no formato "YYYY-MM-DDThh:mm:ssZ".

properties.description

string

Uma descrição verbosa opcional da Transformação.

properties.lastModified

string

A data e hora UTC em que a Transformação foi atualizada pela última vez, no formato "YYYY-MM-DDThh:mm:ssZ".

properties.outputs

TransformOutput[]

Uma matriz de um ou mais TransformOutputs que a Transformação deve gerar.

systemData

systemData

Os metadados do sistema relacionados com este recurso.

type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

TransformOutput

Descreve as propriedades de um TransformOutput, que são as regras a aplicar ao gerar o resultado pretendido.

Name Tipo Description
onError

OnErrorType

Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob".

preset Preset:

Predefinição que descreve as operações que serão utilizadas para modificar, transcodificar ou extrair informações do ficheiro de origem para gerar a saída.

relativePriority

Priority

Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal.

TransportStreamFormat

Descreve as propriedades para gerar um(s) MPEG-2 Transport Stream (ISO/IEC 13818-1) ficheiro(s) de vídeo de saída.

Name Tipo Description
@odata.type string:

#Microsoft.Media.TransportStreamFormat

O discriminador para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro.

outputFiles

OutputFile[]

A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto.

Video

Descreve as propriedades básicas para codificar o vídeo de entrada.

Name Tipo Description
@odata.type string:

#Microsoft.Media.Video

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada.

label

string

Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing.

stretchMode

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático

syncMode

VideoSyncMode

O Modo de Sincronização de Vídeo

VideoAnalyzerPreset

Uma predefinição do analisador de vídeo que extrai informações (metadados avançados) de áudio e vídeo e produz um ficheiro de formato JSON.

Name Tipo Description
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

O discriminador para tipos derivados.

audioLanguage

string

O idioma do payload de áudio na entrada com o formato BCP-47 de "language tag-region" (por exemplo, "en-US"). Se souber o idioma do seu conteúdo, recomenda-se que o especifique. O idioma tem de ser especificado explicitamente para AudioAnalysisMode::Basic, uma vez que a deteção automática de idiomas não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a deteção automática de idiomas escolherá o primeiro idioma detetado e processará com o idioma selecionado durante a duração do ficheiro. Atualmente, não suporta alternar dinamicamente entre idiomas após a deteção do primeiro idioma. A deteção automática funciona melhor com gravações de áudio com voz claramente perceptível. Se a deteção automática não encontrar o idioma, a transcrição reverterá para "en-US". A lista de idiomas suportados está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Dicionário que contém pares de valores chave para parâmetros não expostos na própria predefinição

insightsToExtract

InsightsType

Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo.

mode

AudioAnalysisMode

Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão.

VideoOverlay

Descreve as propriedades de uma sobreposição de vídeo.

Name Tipo Description
@odata.type string:

#Microsoft.Media.VideoOverlay

O discriminador para tipos derivados.

audioGainLevel

number

O nível de ganho de áudio na sobreposição. O valor deve estar no intervalo [0, 1,0]. A predefinição é 1.0.

cropRectangle

Rectangle

Uma janela retangular opcional utilizada para recortar a imagem ou vídeo sobreposto.

end

string

A posição final, com referência ao vídeo de entrada, no qual a sobreposição termina. O valor deve estar no formato ISO 8601. Por exemplo, PT30S para terminar a sobreposição a 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior do que a duração do vídeo de entrada, a sobreposição será aplicada até ao fim do vídeo de entrada se a duração do suporte de dados de sobreposição for maior do que a duração do vídeo de entrada, caso contrário, a sobreposição irá durar até à duração do suporte de dados de sobreposição.

fadeInDuration

string

A duração sobre a qual a sobreposição se desvanece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S).

fadeOutDuration

string

A duração sobre a qual a sobreposição desaparece do vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S).

inputLabel

string

A etiqueta da entrada da tarefa que deve ser utilizada como uma sobreposição. A Entrada tem de especificar exatamente um ficheiro. Pode especificar um ficheiro de imagem no formato JPG, PNG, GIF ou BMP ou um ficheiro de áudio (como um ficheiro WAV, MP3, WMA ou M4A) ou um ficheiro de vídeo. Veja https://aka.ms/mesformats para obter a lista completa dos formatos de ficheiro de áudio e vídeo suportados.

opacity

number

A opacidade da sobreposição. Este é um valor no intervalo [0 - 1.0]. A predefinição é 1,0, o que significa que a sobreposição é opaca.

position

Rectangle

A localização no vídeo de entrada onde a sobreposição é aplicada.

start

string

A posição de início, com referência ao vídeo de entrada, no qual a sobreposição é iniciada. O valor deve estar no formato ISO 8601. Por exemplo, PT05S para iniciar a sobreposição a 5 segundos no vídeo de entrada. Se não for especificada, a sobreposição começa a partir do início do vídeo de entrada.

VideoSyncMode

Modo de Sincronização de Vídeo

Name Tipo Description
Auto

string

Este é o método predefinido. Escolhe entre Cfr e Vfr consoante as capacidades do muxer. Para o formato de saída MP4, o modo predefinido é Cfr.

Cfr

string

Os fotogramas de entrada serão repetidos e/ou removidos conforme necessário para alcançar exatamente a taxa de fotogramas constante pedida. Recomendado quando a taxa de fotogramas de saída é explicitamente definida com um valor especificado

Passthrough

string

Os carimbos de data/hora da apresentação em frames são transmitidos do ficheiro de entrada para o escritor de ficheiros de saída. Recomendado quando a origem de entrada tem uma taxa de fotogramas variável e está a tentar produzir várias camadas para transmissão em fluxo adaptável na saída que têm limites GOP alinhados. Nota: se dois ou mais fotogramas na entrada tiverem carimbos de data/hora duplicados, o resultado também terá o mesmo comportamento

Vfr

string

Semelhante ao modo Passthrough, mas se a entrada tiver fotogramas com carimbos de data/hora duplicados, apenas uma moldura é transmitida para a saída e outras são removidas. Recomendado quando se espera que o número de fotogramas de saída seja igual ao número de fotogramas de entrada. Por exemplo, o resultado é utilizado para calcular uma métrica de qualidade como PSNR em relação à entrada