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 de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

O nome da conta dos Serviços de Mídia.

resourceGroupName
path True

string

O nome do grupo de recursos na assinatura do Azure.

subscriptionId
path True

string

O identificador exclusivo de uma assinatura do Microsoft Azure.

transformName
path True

string

O nome da transformação.

api-version
query True

string

A versão da API a ser usada com a solicitação do cliente.

Corpo da solicitação

Nome Obrigató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 detalhada opcional da transformação.

Respostas

Nome Tipo Description
200 OK

Transform

OK

201 Created

Transform

Criado

Other Status Codes

ErrorResponse

Informações detalhadas de erro.

Exemplos

Create or update a Transform

Sample Request

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"
        }
      }
    ]
  }
}

Sample Response

{
  "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

Nome Description
AacAudio

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

AacAudioProfile

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

AnalysisResolution

Especifica a resolução máxima na qual o vídeo é analisado. O comportamento padrão é "SourceResolution", que manterá o vídeo de entrada em sua resolução original quando analisado. O uso de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a taxa de proporção apropriada. Ele só será redimensionado se o vídeo for de maior resolução. 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. Ele também pode reduzir o custo de uso desse componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, rostos que acabam sendo muito pequenos no vídeo redimensionado podem não ser detectados.

Audio

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

AudioAnalysisMode

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

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 fala. Atualmente, a predefinição dá suporta ao processamento de conteúdo com uma única faixa do áudio.

AudioOverlay

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

BlurType

Tipo de desfoque

BuiltInStandardEncoderPreset

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

Complexity

Permite definir as configuraçõ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 compactação.

CopyAudio

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

CopyVideo

Um sinalizador de codec, que informa ao codificador para copiar o bitstream de vídeo de entrada sem codificação novamente.

createdByType

O tipo de identidade que criou o recurso.

DDAudio

Descreve as configurações de codificação de áudio DOlby Digital Audio Codec (AC3). A implementação atual para o suporte ao Dolby Digital Audio é: números de canal 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 taxa de bits de áudio como especificação AC3 dão suporte a: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 5760000, 640000 bps.

Deinterlace

Descreve as configurações de desassociamento.

DeinterlaceMode

O modo de desinterlacing. O padrão é AutoPixelAdaptive.

DeinterlaceParity

A paridade de campo para desassociamento, usa como padrão Auto.

EncoderNamedPreset

A predefinição interna a ser usada para codificar vídeos.

EntropyMode

O modo de entropia a ser usado para essa camada. Se não for especificado, o codificador escolherá o modo apropriado para o perfil e o nível.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

Os detalhes do erro.

ErrorResponse

Resposta de erro

FaceDetectorPreset

Descreve todas as configurações a serem usadas ao analisar um vídeo para detectar (e, opcionalmente, redigir) todos os rostos presentes.

FaceRedactorMode

Esse modo fornece a capacidade de escolher entre as seguintes configurações: 1) Analisar – somente para detecção. Esse modo gera um arquivo JSON de metadados marcando aparências de rostos em todo o vídeo. Sempre que possível, as aparências da mesma pessoa recebem a mesma ID. 2) Combinado – Além disso, redigi(desfoca) rostos detectados. 3) Redact – isso habilita um processo de duas passões, permitindo a redação seletiva de um subconjunto de rostos detectados. Ele usa o arquivo de metadados de uma passagem de análise anterior, juntamente com o vídeo de origem e um subconjunto de IDs selecionados pelo usuário que exigem redação.

Fade

Descreve as propriedades de um efeito Fade aplicado à mídia de entrada.

Filters

Descreve todas as operações de filtragem, como desassociamento, rotação etc. que devem ser aplicadas à mídia de entrada antes da codificação.

H264Complexity

Informa ao codificador como escolher suas configurações de codificação. O valor padrão é Balanced.

H264Layer

Descreve as configurações a serem usadas ao codificar o vídeo de entrada em uma camada de taxa de bits de saída desejada com o codec de vídeo H.264.

H264RateControlMode

O modo de controle de taxa de vídeo

H264Video

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

H264VideoProfile

Atualmente, damos suporte a Baseline, Main, High, High422, High444. O padrão é Automático.

H265Complexity

Informa ao codificador como escolher suas configurações de codificação. A qualidade fornecerá uma taxa de compactação mais alta, mas a um custo mais alto e tempo de computação mais longo. A velocidade produzirá um arquivo relativamente maior, mas é mais rápida e econômica. O valor padrão é Balanceado.

H265Layer

Descreve as configurações a serem usadas ao codificar o vídeo de entrada em uma camada de taxa de bits de saída desejada 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, damos suporte a Main. O padrão é Automático.

Image

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

ImageFormat

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

InsightsType

Define o tipo de insights que você deseja que o serviço gere. Os valores permitidos são 'AudioInsightsOnly', 'VideoInsightsOnly' e 'AllInsights'. O padrão é AllInsights. Se você definir isso como AllInsights e a entrada for somente áudio, somente os insights de áudio serão gerados. Da mesma forma, se a entrada for somente vídeo, somente os insights de vídeo serão gerados. É recomendável que você não use AudioInsightsOnly se você espera que algumas de suas entradas sejam somente vídeo; ou use VideoInsightsOnly se você espera que algumas de suas entradas sejam somente áudio. Seus trabalhos nessas condições seriam descartados.

InterleaveOutput

Define o modo de intercalação da saída para controlar como áudio e vídeo são armazenados no formato de contêiner. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas somente áudio e somente vídeo em arquivos MP4 separados.

JpgFormat

Descreve as configurações para produzir miniaturas JPEG.

JpgImage

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

JpgLayer

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

Mp4Format

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

MultiBitrateFormat

Descreve as propriedades para produzir uma coleção de arquivos de várias taxas de bits alinhados ao GOP. O comportamento padrão é produzir um arquivo de saída para cada camada de vídeo que é muxed junto com todos os áudios. Os arquivos de saída exatos produzidos podem ser controlados especificando a coleção outputFiles.

OnErrorType

Uma Transformação pode definir mais de uma saída. Essa propriedade define o que o serviço deve fazer quando uma saída falha – continue produzindo outras saídas ou interrompa as outras saídas. O estado geral do trabalho não refletirá falhas de saídas especificadas com 'ContinueJob'. O padrão é 'StopProcessingJob'.

OutputFile

Representa um arquivo de saída produzido.

PngFormat

Descreve as configurações para produzir miniaturas PNG.

PngImage

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

PngLayer

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

PresetConfigurations

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

Priority

Define a prioridade relativa de TransformOutputs em uma Transformação. Isso define a prioridade que o serviço usa para processar TransformOutputs. A prioridade padrão é Normal.

Rectangle

Descreve as propriedades de uma janela retangular aplicada à mídia de entrada antes de processá-la.

Rotation

A rotação, se houver, a ser aplicada ao vídeo de entrada, antes de ser codificada. O padrão é Automático

StandardEncoderPreset

Descreve todas as configurações a serem usadas ao codificar o vídeo de entrada com o Codificador Padrão.

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída desejadas. O padrão é AutoSize

systemData

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

Transform

Uma Transformação encapsula as regras ou instruções para gerar saídas desejadas da mídia de entrada, como transcodificação ou extração de insights. Depois que a Transformação é criada, ela pode ser aplicada à mídia de entrada criando Trabalhos.

TransformOutput

Descreve as propriedades de um TransformOutput, que são as regras a serem aplicadas ao gerar a saída desejada.

TransportStreamFormat

Descreve as propriedades para gerar um arquivo de vídeo de saída de fluxo de transporte MPEG-2 (ISO/IEC 13818-1).

Video

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

VideoAnalyzerPreset

Uma predefinição do analisador de vídeo que extrai insights (metadados avançados) de áudio e vídeo e gera um arquivo de formato JSON.

VideoOverlay

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

VideoSyncMode

O modo de sincronização de vídeo

AacAudio

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.AacAudio

O discriminador para tipos derivados.

bitrate

integer

A taxa de bits, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

profile

AacAudioProfile

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

samplingRate

integer

A taxa de amostragem a ser usada para codificação em hertz.

AacAudioProfile

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

Nome Tipo Description
AacLc

string

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

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 na qual o vídeo é analisado. O comportamento padrão é "SourceResolution", que manterá o vídeo de entrada em sua resolução original quando analisado. O uso de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a taxa de proporção apropriada. Ele só será redimensionado se o vídeo for de maior resolução. 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. Ele também pode reduzir o custo de uso desse componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, rostos que acabam sendo muito pequenos no vídeo redimensionado podem não ser detectados.

Nome Tipo Description
SourceResolution

string

StandardDefinition

string

Audio

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.Audio

O discriminatório para tipos derivados.

bitrate

integer

A taxa de bits, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

samplingRate

integer

A taxa de amostragem a ser usada para codificação em hertz.

AudioAnalysisMode

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

Nome Tipo Description
Basic

string

Esse modo executa a transcrição de fala em texto e a geração de um arquivo de legenda VTT. A saída desse modo inclui um arquivo JSON do Insights, incluindo apenas palavras-chave, transcrição e informações de tempo. A detecção automática de idioma e a diarização de alto-falante não estão incluídos nesse modo.

Standard

string

Executa todas as operações incluídas no modo Básico, além de executar a detecção de idiomas e a diarização do locutor.

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 fala. Atualmente, a predefinição dá suporta ao processamento de conteúdo com uma única faixa do áudio.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.AudioAnalyzerPreset

O discriminador para tipos derivados.

audioLanguage

string

O idioma do conteúdo de áudio na entrada usando o formato BCP-47 de "região de marca de idioma" (por exemplo: 'en-US'). Se você souber o idioma do seu conteúdo, é recomendável especificá-lo. O idioma deve ser especificado explicitamente para AudioAnalysisMode::Basic, pois a detecção automática de idioma não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a detecção automática de idioma escolherá o primeiro idioma detectado e processará com o idioma selecionado para a duração do arquivo. Ele não suporta no momento alternar dinamicamente entre os idiomas depois que o primeiro idioma for detectado. A detecção automática funciona melhor com gravações de áudio com fala claramente perceptível. Se a detecção automática não encontrar o idioma, a transcrição retornará para 'en-US'." A lista de idiomas com suporte está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

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

mode

AudioAnalysisMode

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

AudioOverlay

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.AudioOverlay

O discriminatório para tipos derivados.

audioGainLevel

number

O nível de ganho de áudio na sobreposição. O valor deve estar no intervalo [0, 1,0]. O padrã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 encerrar a sobreposição em 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior que a duração do vídeo de entrada, a sobreposição será aplicada até o final do vídeo de entrada se a duração da mídia de sobreposição for maior que a duração do vídeo de entrada, caso contrário, a sobreposição durará tanto quanto a duração da mídia de sobreposição.

fadeInDuration

string

A duração sobre a qual a sobreposição desaparece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento padrão será não ter fade in (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 padrão será não ter desvanecimento (o mesmo que PT0S).

inputLabel

string

O rótulo da entrada do trabalho que deve ser usado como uma sobreposição. A Entrada deve especificar exatamente um arquivo. Você pode especificar um arquivo de imagem no formato JPG, PNG, GIF ou BMP ou um arquivo de áudio (como um arquivo WAV, MP3, WMA ou M4A) ou um arquivo de vídeo. Confira https://aka.ms/mesformats a lista completa de formatos de arquivo de áudio e vídeo com suporte.

start

string

A posição inicial, 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 em 5 segundos no vídeo de entrada. Se não for especificado, a sobreposição será iniciada desde o início do vídeo de entrada.

BlurType

Tipo de desfoque

Nome Tipo Description
Black

string

Preto: Apagar filtro

Box

string

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

High

string

Alto: confundir filtro de desfoque

Low

string

Baixo: filtro de desfoque box-car

Med

string

Med: filtro de desfoque gaussiano

BuiltInStandardEncoderPreset

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

O discriminador para tipos derivados.

configurations

PresetConfigurations

Definições de configuração opcionais para o codificador. As configurações só têm suporte para ContentAwareEncoding e H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

A predefinição interna a ser usada para codificar vídeos.

Complexity

Permite definir as configuraçõ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 compactação.

Nome Tipo Description
Balanced

string

Define o codificador para usar configurações que alcançam um equilíbrio entre velocidade e qualidade.

Quality

string

Configura o codificador para usar as configuraçõ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 usar as configurações otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

CopyAudio

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.CopyAudio

O discriminatório para tipos derivados.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

CopyVideo

Um sinalizador de codec, que informa ao codificador para copiar o bitstream de vídeo de entrada sem codificação novamente.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.CopyVideo

O discriminatório para tipos derivados.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DDAudio

Descreve as configurações de codificação de áudio DOlby Digital Audio Codec (AC3). A implementação atual para o suporte ao Dolby Digital Audio é: números de canal 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 taxa de bits de áudio como especificação AC3 dão suporte a: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 5760000, 640000 bps.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.DDAudio

O discriminatório para tipos derivados.

bitrate

integer

A taxa de bits, em bits por segundo, do áudio codificado de saída.

channels

integer

O número de canais no áudio.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

samplingRate

integer

A taxa de amostragem a ser usada para codificação em hertz.

Deinterlace

Descreve as configurações de desassociamento.

Nome Tipo Description
mode

DeinterlaceMode

O modo de desinterlacing. O padrão é AutoPixelAdaptive.

parity

DeinterlaceParity

A paridade de campo para desassociamento, usa como padrão Auto.

DeinterlaceMode

O modo de desinterlacing. O padrão é AutoPixelAdaptive.

Nome Tipo Description
AutoPixelAdaptive

string

Aplique a interlacagem adaptável automática de pixel em cada quadro no vídeo de entrada.

Off

string

Desabilita a interlacção do vídeo de origem.

DeinterlaceParity

A paridade de campo para desassociamento, usa como padrão Auto.

Nome Tipo Description
Auto

string

Detectar 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 de campo superior do vídeo de entrada.

EncoderNamedPreset

A predefinição interna a ser usada para codificar vídeos.

Nome Tipo Description
AACGoodQualityAudio

string

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

AdaptiveStreaming

string

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

ContentAwareEncoding

string

Produz um conjunto de MP4s alinhados a GOP usando a codificação com reconhecimento de conteúdo. Dado qualquer conteúdo de entrada, o serviço executa uma análise inicial leve desse conteúdo e usa os resultados para determinar o número ideal de camadas, a taxa de bits apropriada e as configurações de resolução para entrega por streaming adaptável. Essa predefinição é particularmente eficaz para vídeos de baixa complexidade e de complexidade média, em que os arquivos de saída terão taxas de bits menores, mas com uma qualidade que ainda oferecerá uma boa experiência aos espectadores. A saída conterá arquivos MP4 com vídeo e áudio intercalados.

ContentAwareEncodingExperimental

string

Expõe uma predefinição experimental para codificação com reconhecimento de conteúdo. Considerando qualquer conteúdo de entrada, o serviço tenta determinar automaticamente o número ideal de camadas, as configurações apropriadas de taxa de bits e resolução para entrega por streaming adaptável. Os algoritmos subjacentes continuarão a evoluir ao longo do tempo. A saída conterá arquivos MP4 com vídeo e áudio intercalados.

CopyAllBitrateNonInterleaved

string

Copie todos os fluxos de áudio e vídeo do ativo de entrada como arquivos de saída de áudio e vídeo não intercalados. Essa predefinição pode ser usada para recortar um ativo existente ou converter um grupo de arquivos MP4 alinhados ao quadro-chave (GOP) como um ativo que pode ser transmitido.

DDGoodQualityAudio

string

Produz um único arquivo MP4 contendo apenas áudio estéreo DD(Digital Dolby) codificado em 192 kbps.

H264MultipleBitrate1080p

string

Produz um conjunto de 8 arquivos MP4 alinhados ao GOP, variando de 6.000 kbps a 400 kbps e áudio AAC estéreo. A resolução começa em 1080p e cai para 180p.

H264MultipleBitrate720p

string

Produz um conjunto de 6 arquivos MP4 alinhados a GOP, variando de 3400 kbps a 400 kbps e áudio AAC estéreo. A resolução começa em 720p e cai para 180p.

H264MultipleBitrateSD

string

Produz um conjunto de 5 arquivos MP4 alinhados ao GOP, variando de 1900kbps a 400 kbps e áudio AAC estéreo. A resolução começa em 480p e cai para 240p.

H264SingleBitrate1080p

string

Produz um arquivo MP4 em que 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 arquivo MP4 em que o vídeo é codificado com código H.264 a 4.500 kbps e uma altura de imagem de 720 pixels, e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

H264SingleBitrateSD

string

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

H265AdaptiveStreaming

string

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

H265ContentAwareEncoding

string

Produz um conjunto de MP4s alinhados a GOP usando a codificação com reconhecimento de conteúdo. Dado qualquer conteúdo de entrada, o serviço executa uma análise inicial leve desse conteúdo e usa os resultados para determinar o número ideal de camadas, a taxa de bits apropriada e as configurações de resolução para entrega por streaming adaptável. Essa predefinição é particularmente eficaz para vídeos de baixa complexidade e de complexidade média, em que os arquivos de saída terão taxas de bits menores, mas com uma qualidade que ainda oferecerá uma boa experiência aos espectadores. A saída conterá arquivos MP4 com vídeo e áudio intercalados.

H265SingleBitrate1080p

string

Produz um arquivo MP4 em que o vídeo é codificado com 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 arquivo MP4 em que o vídeo é codificado com código H.265 a 9.500 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 arquivo MP4 em que o vídeo é codificado com codec H.265 a 1800 kbps e uma altura de imagem de 720 pixels, e o áudio estéreo é codificado com codec AAC-LC a 128 kbps.

EntropyMode

O modo de entropia a ser usado para essa camada. Se não for especificado, o codificador escolherá o modo apropriado para o perfil e o nível.

Nome Tipo Description
Cabac

string

Context Adaptive Binary Aithmetic Coder (CABAC) entropia encoding.

Cavlc

string

Codificação de entropia CAVLC (Context Adaptive Variable Length Coder).

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

Os detalhes do erro.

Nome 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 de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

FaceDetectorPreset

Descreve todas as configurações a serem usadas ao analisar um vídeo para detectar (e, opcionalmente, redigir) todos os rostos presentes.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.FaceDetectorPreset

O discriminador para tipos derivados.

blurType

BlurType

Tipo de desfoque

experimentalOptions

object

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

mode

FaceRedactorMode

Esse modo fornece a capacidade de escolher entre as seguintes configurações: 1) Analisar – somente para detecção. Esse modo gera um arquivo JSON de metadados marcando aparências de rostos em todo o vídeo. Sempre que possível, as aparências da mesma pessoa recebem a mesma ID. 2) Combinado - Além disso, redigi(desfoca) rostos detectados. 3) Redação – habilita um processo de duas passões, permitindo a redação seletiva de um subconjunto de rostos detectados. Ele usa o arquivo de metadados de uma passagem de análise anterior, juntamente com o vídeo de origem, e um subconjunto selecionado pelo usuário de IDs que exigem redação.

resolution

AnalysisResolution

Especifica a resolução máxima na qual o vídeo é analisado. O comportamento padrão é "SourceResolution", que manterá o vídeo de entrada em sua resolução original quando analisado. O uso de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a taxa de proporção apropriada. Ele só será redimensionar se o vídeo for de resolução mais alta. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Alternar para "StandardDefinition" reduzirá o tempo necessário para processar vídeos de alta resolução. Ele também pode reduzir o custo de uso desse componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, rostos que acabam sendo muito pequenos no vídeo redimensionado podem não ser detectados.

FaceRedactorMode

Esse modo fornece a capacidade de escolher entre as seguintes configurações: 1) Analisar – somente para detecção. Esse modo gera um arquivo JSON de metadados marcando aparências de rostos em todo o vídeo. Sempre que possível, as aparências da mesma pessoa recebem a mesma ID. 2) Combinado – Além disso, redigi(desfoca) rostos detectados. 3) Redact – isso habilita um processo de duas passões, permitindo a redação seletiva de um subconjunto de rostos detectados. Ele usa o arquivo de metadados de uma passagem de análise anterior, juntamente com o vídeo de origem e um subconjunto de IDs selecionados pelo usuário que exigem redação.

Nome Tipo Description
Analyze

string

O modo de análise detecta faces e gera um arquivo de metadados com os resultados. Permite a edição do arquivo de metadados antes que os rostos sejam desfocados com o modo Redact.

Combined

string

O modo combinado executa as etapas Analisar e Redigir em uma passagem ao editar os rostos analisados não é desejado.

Redact

string

O modo Redact consome o arquivo de metadados do modo Analisar e redimensula os rostos encontrados.

Fade

Descreve as propriedades de um efeito Fade aplicado à mídia de entrada.

Nome Tipo Description
duration

string

A Duração do efeito fade no vídeo. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para esmaecer uma cor durante 5 segundos) ou uma contagem de quadros (por exemplo, 10 para desaparecer 10 quadros 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 do fade In/Out. ele pode estar nas cores https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 ou um valor RGB/hex: por exemplo: rgb(255,0,0), 0xFF0000 ou #FF0000

start

string

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

Filters

Descreve todas as operações de filtragem, como desassociamento, rotação etc. que devem ser aplicadas à mídia de entrada antes da codificação.

Nome Tipo Description
crop

Rectangle

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

deinterlace

Deinterlace

As configurações de desassociamento.

fadeIn

Fade

Descreve as propriedades de um efeito Fade aplicado à mídia de entrada.

fadeOut

Fade

Descreve as propriedades de um efeito Fade aplicado à mídia de entrada.

overlays Overlay[]:

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

rotation

Rotation

A rotação, se houver, a ser aplicada ao vídeo de entrada, antes de ser codificada. O padrão é Automático

H264Complexity

Informa ao codificador como escolher suas configurações de codificação. O valor padrão é Balanced.

Nome Tipo Description
Balanced

string

Informa ao codificador para usar configurações que alcançam um equilíbrio entre velocidade e qualidade.

Quality

string

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

Speed

string

Informa ao codificador para usar configurações otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

H264Layer

Descreve as configurações a serem usadas ao codificar o vídeo de entrada em uma camada de taxa de bits de saída desejada com o codec de vídeo H.264.

Nome Tipo Description
adaptiveBFrame

boolean

Se os quadros B adaptáveis devem ou não ser usados ao codificar essa camada. Se não for especificado, o codificador o ativará sempre que o perfil de vídeo permitir seu uso.

bFrames

integer

O número de quadros B a serem usados ao codificar essa camada. Se não for especificado, o codificador escolherá um número apropriado com base no perfil e no nível do vídeo.

bitrate

integer

A taxa média de bits em bits por segundo na qual codificar o vídeo de entrada ao gerar essa camada. Esse é um campo obrigatório.

bufferWindow

string

O comprimento da janela do buffer VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. O padrão é 5 segundos (por exemplo, PT5S).

crf

number

O valor do CRF a ser usado ao codificar essa camada. Essa configuração entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor crf está entre 0 e 51, onde valores mais baixos resultariam em melhor qualidade, em detrimento de tamanhos de arquivo mais altos. Valores mais altos significam mais compactação, mas em algum momento a degradação da qualidade será observada. O valor padrão é 23.

entropyMode

EntropyMode

O modo de entropia a ser usado para essa camada. Se não for especificado, o codificador escolherá o modo apropriado para o perfil e o nível.

frameRate

string

A taxa de quadros (em quadros por segundo) na qual codificar essa camada. O valor pode estar na forma de M/N em que M e N são 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 quadros permitidas com base no perfil e no nível. Se não for especificado, o codificador usará a mesma taxa de quadros que o vídeo de entrada.

height

string

A altura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de altura quanto a entrada.

label

string

O rótulo alfanumérico para essa camada, que pode ser usado no multiplexação de diferentes camadas de áudio e vídeo ou na nomenclatura do arquivo de saída.

level

string

Atualmente, damos suporte ao Nível até 6.2. O valor pode ser Auto ou um número que corresponda ao perfil H.264. Se não for especificado, o padrão será Automático, o que permite que o codificador escolha o Nível apropriado para essa camada.

maxBitrate

integer

A taxa de bits máxima (em bits por segundo), na qual o buffer VBV deve ser considerado para recarregar. Se não for especificado, o padrão será o mesmo valor que a taxa de bits.

profile

H264VideoProfile

Atualmente, damos suporte a Baseline, Main, High, High422, High444. O padrão é Automático.

referenceFrames

integer

O número de quadros de referência a serem usados ao codificar essa camada. Se não for especificado, o codificador determinará um número apropriado com base na configuração de complexidade do codificador.

slices

integer

O número de fatias a serem usadas ao codificar essa camada. Se não for especificado, o padrão será zero, o que significa que o codificador usará uma única fatia para cada quadro.

width

string

A largura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de largura quanto a entrada.

H264RateControlMode

O modo de controle de taxa de vídeo

Nome Tipo Description
ABR

string

Modo ABR (taxa de bits média) que atinge a taxa de bits de destino: modo padrão.

CBR

string

Modo CBR (taxa de bits constante) que aperta as variações de taxa de bits em torno da taxa de bits de destino.

CRF

string

Modo crf (fator de taxa constante) que se destina à qualidade subjetiva constante.

H264Video

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.H264Video

O discriminador para tipos derivados.

complexity

H264Complexity

Informa ao codificador como escolher suas configurações de codificação. O valor padrão é Balanced.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

layers

H264Layer[]

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

rateControlMode

H264RateControlMode

O modo de controle de taxa de vídeo

sceneChangeDetection

boolean

Se o codificador deve ou não inserir quadros-chave em alterações de cena. Se não for especificado, o padrão será false. Esse sinalizador deve ser definido como true somente quando o codificador está sendo 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

H264VideoProfile

Atualmente, damos suporte a Baseline, Main, High, High422, High444. O padrão é Automático.

Nome Tipo Description
Auto

string

Informa ao codificador para determinar automaticamente o perfil H.264 apropriado.

Baseline

string

Perfil de linha de base

High

string

Alto perfil.

High422

string

Alto perfil 4:2:2.

High444

string

Alto perfil preditivo 4:4:4.

Main

string

Perfil principal

H265Complexity

Informa ao codificador como escolher suas configurações de codificação. A qualidade fornecerá uma taxa de compactação mais alta, mas a um custo mais alto e tempo de computação mais longo. A velocidade produzirá um arquivo relativamente maior, mas é mais rápida e econômica. O valor padrão é Balanceado.

Nome Tipo Description
Balanced

string

Informa ao codificador para usar configurações que alcançam um equilíbrio entre velocidade e qualidade.

Quality

string

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

Speed

string

Informa ao codificador para usar configurações otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação.

H265Layer

Descreve as configurações a serem usadas ao codificar o vídeo de entrada em uma camada de taxa de bits de saída desejada com o codec de vídeo H.265.

Nome Tipo Description
adaptiveBFrame

boolean

Especifica se os quadros B adaptáveis devem ou não ser usados ao codificar essa camada. Se não for especificado, o codificador o ativará sempre que o perfil de vídeo permitir seu uso.

bFrames

integer

O número de quadros B a serem usados ao codificar essa camada. Se não for especificado, o codificador escolherá um número apropriado com base no perfil e no nível do vídeo.

bitrate

integer

A taxa média de bits em bits por segundo na qual codificar o vídeo de entrada ao gerar essa camada. Por exemplo: uma taxa de bits de destino de 3000Kbps ou 3Mbps significa que esse valor deve ser 3000000. Esse é um campo obrigatório.

bufferWindow

string

O comprimento da janela do buffer VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. O padrão é 5 segundos (por exemplo, PT5S).

crf

number

O valor do CRF a ser usado ao codificar essa camada. Essa configuração entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor crf está entre 0 e 51, onde valores mais baixos resultariam em melhor qualidade, em detrimento de tamanhos de arquivo mais altos. Valores mais altos significam mais compactação, mas em algum momento a degradação da qualidade será observada. O valor padrão é 28.

frameRate

string

A taxa de quadros (em quadros por segundo) na qual codificar essa camada. O valor pode estar na forma de M/N em que M e N são 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 quadros permitidas com base no perfil e no nível. Se não for especificado, o codificador usará a mesma taxa de quadros que o vídeo de entrada.

height

string

A altura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de altura quanto a entrada.

label

string

O rótulo alfanumérico para essa camada, que pode ser usado no multiplexação de diferentes camadas de áudio e vídeo ou na nomenclatura do arquivo de saída.

level

string

Atualmente, damos suporte ao Nível até 6.2. O valor pode ser Auto ou um número que corresponda ao perfil H.265. Se não for especificado, o padrão será Automático, o que permite que o codificador escolha o Nível apropriado para essa camada.

maxBitrate

integer

A taxa de bits máxima (em bits por segundo), na qual o buffer VBV deve ser considerado para recarregar. Se não for especificado, o padrão será o mesmo valor que a taxa de bits.

profile

H265VideoProfile

Atualmente, damos suporte a Main. O padrão é Automático.

referenceFrames

integer

O número de quadros de referência a serem usados ao codificar essa camada. Se não for especificado, o codificador determinará um número apropriado com base na configuração de complexidade do codificador.

slices

integer

O número de fatias a serem usadas ao codificar essa camada. Se não for especificado, o padrão será zero, o que significa que o codificador usará uma única fatia para cada quadro.

width

string

A largura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de largura quanto a entrada.

H265Video

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.H265Video

O discriminatório para tipos derivados.

complexity

H265Complexity

Informa ao codificador como escolher suas configurações de codificação. A qualidade fornecerá uma taxa de compactação mais alta, mas a um custo mais alto e tempo de computação mais longo. A velocidade produzirá um arquivo relativamente maior, mas é mais rápida e econômica. O valor padrão é Balanceado.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

layers

H265Layer[]

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

sceneChangeDetection

boolean

Especifica se o codificador deve ou não inserir quadros-chave em alterações de cena. Se não for especificado, o padrão será false. Esse sinalizador deve ser definido como true somente quando o codificador estiver sendo 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

H265VideoProfile

Atualmente, damos suporte a Main. O padrão é Automático.

Nome Tipo Description
Auto

string

Informa ao codificador para determinar automaticamente o perfil H.265 apropriado.

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 do vídeo de entrada

Nome Tipo Description
@odata.type string:

#Microsoft.Media.Image

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado para controlar o comportamento de muxing.

range

string

A posição relativa à hora de início predefinida no vídeo de entrada no qual parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar em 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de quadros (por exemplo, 300 para parar no 300º quadro do quadro na hora de início. Se esse valor for 1, significará produzir apenas uma miniatura na hora de início) ou um valor relativo para a duração do fluxo (por exemplo, 50% para parar na metade da duração do fluxo a partir da hora de início). O valor padrão é 100%, que significa parar no fim 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 iniciar em 5 segundos) ou uma contagem de quadros (por exemplo, 10 para iniciar no 10º quadro) ou um valor relativo para a duração do fluxo (por exemplo, 10% para iniciar com 10% da duração do fluxo). Também dá suporte à macro {Best}, que diz ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, não importando quais são as outras configurações para Step e Range. O valor padrão é macro {Best}.

step

string

Os intervalos nos quais 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 quadros (por exemplo, 30 para uma imagem a cada 30 quadros) ou um valor relativo para a duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Observação: o valor da etapa afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da predefinição de transformação. Isso ocorre devido ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a Posição da etapa da hora de início como a primeira saída. Como o valor padrão é 10%, isso significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada na hora de início. Tente selecionar um valor razoável para Etapa se a primeira miniatura for esperada perto da hora de início ou defina o valor de Intervalo como 1 se apenas uma miniatura for necessária 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

ImageFormat

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.ImageFormat

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

InsightsType

Define o tipo de insights que você deseja que o serviço gere. Os valores permitidos são 'AudioInsightsOnly', 'VideoInsightsOnly' e 'AllInsights'. O padrão é AllInsights. Se você definir isso como AllInsights e a entrada for somente áudio, somente os insights de áudio serão gerados. Da mesma forma, se a entrada for somente vídeo, somente os insights de vídeo serão gerados. É recomendável que você não use AudioInsightsOnly se você espera que algumas de suas entradas sejam somente vídeo; ou use VideoInsightsOnly se você espera que algumas de suas entradas sejam somente áudio. Seus trabalhos nessas condições seriam descartados.

Nome Tipo Description
AllInsights

string

Gere insights de áudio e vídeo. Falha se o Insights de áudio ou vídeo falhar.

AudioInsightsOnly

string

Gerar somente insights de áudio. Ignore o vídeo mesmo que esteja presente. Falha se nenhum áudio estiver presente.

VideoInsightsOnly

string

Gerar somente insights de vídeo. Ignore o áudio se estiver presente. Falha se nenhum vídeo estiver presente.

InterleaveOutput

Define o modo de intercalação da saída para controlar como áudio e vídeo são armazenados no formato de contêiner. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas somente áudio e somente vídeo em arquivos MP4 separados.

Nome Tipo Description
InterleavedOutput

string

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

NonInterleavedOutput

string

A saída é somente vídeo ou somente áudio.

JpgFormat

Descreve as configurações para produzir miniaturas JPEG.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.JpgFormat

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

JpgImage

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.JpgImage

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado 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 à hora de início predefinida no vídeo de entrada no qual parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar em 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de quadros (por exemplo, 300 para parar no 300º quadro do quadro na hora de início. Se esse valor for 1, significará produzir apenas uma miniatura na hora de início) ou um valor relativo para a duração do fluxo (por exemplo, 50% para parar na metade da duração do fluxo a partir da hora de início). O valor padrão é 100%, que significa parar no fim do fluxo.

spriteColumn

integer

Define o número de colunas usadas na imagem de sprite de miniatura. O número de linhas é calculado automaticamente e um arquivo VTT é gerado com os mapeamentos de coordenadas para cada miniatura no sprite. Observação: esse valor deve ser um inteiro positivo e um valor adequado é recomendado para que a resolução da imagem de saída não vá além do limite máximo de resolução de pixel 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 iniciar em 5 segundos) ou uma contagem de quadros (por exemplo, 10 para iniciar no 10º quadro) ou um valor relativo para a duração do fluxo (por exemplo, 10% para iniciar com 10% da duração do fluxo). Também dá suporte à macro {Best}, que diz ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, não importando quais são as outras configurações para Step e Range. O valor padrão é macro {Best}.

step

string

Os intervalos nos quais 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 quadros (por exemplo, 30 para uma imagem a cada 30 quadros) ou um valor relativo para a duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Observação: o valor da etapa afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da predefinição de transformação. Isso ocorre devido ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a Posição da etapa da hora de início como a primeira saída. Como o valor padrão é 10%, isso significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada na hora de início. Tente selecionar um valor razoável para Etapa se a primeira miniatura for esperada perto da hora de início ou defina o valor de Intervalo como 1 se apenas uma miniatura for necessária 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

JpgLayer

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

Nome Tipo Description
height

string

A altura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de altura quanto a entrada.

label

string

O rótulo alfanumérico para essa camada, que pode ser usado no multiplexação de diferentes camadas de áudio e vídeo ou na nomenclatura do arquivo de saída.

quality

integer

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

width

string

A largura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de largura quanto a entrada.

Mp4Format

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.Mp4Format

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

outputFiles

OutputFile[]

A lista de arquivos de saída a serem produzidos. Cada entrada na lista é um conjunto de rótulos de camada de áudio e vídeo a serem muxed juntos.

MultiBitrateFormat

Descreve as propriedades para produzir uma coleção de arquivos de várias taxas de bits alinhados ao GOP. O comportamento padrão é produzir um arquivo de saída para cada camada de vídeo que é muxed junto com todos os áudios. Os arquivos de saída exatos produzidos podem ser controlados especificando a coleção outputFiles.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.MultiBitrateFormat

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

outputFiles

OutputFile[]

A lista de arquivos de saída a serem produzidos. Cada entrada na lista é um conjunto de rótulos de camada de áudio e vídeo a serem muxed juntos.

OnErrorType

Uma Transformação pode definir mais de uma saída. Essa propriedade define o que o serviço deve fazer quando uma saída falha – continue produzindo outras saídas ou interrompa as outras saídas. O estado geral do trabalho não refletirá falhas de saídas especificadas com 'ContinueJob'. O padrão é 'StopProcessingJob'.

Nome Tipo Description
ContinueJob

string

Informa ao serviço que, se esse TransformOutput falhar, permita que qualquer outro TransformOutput continue.

StopProcessingJob

string

Informa ao serviço que, se esse TransformOutput falhar, qualquer outro TransformOutputs incompleto poderá ser interrompido.

OutputFile

Representa um arquivo de saída produzido.

Nome Tipo Description
labels

string[]

A lista de rótulos que descrevem como o codificador deve multiplexar vídeo e áudio em um arquivo de saída. Por exemplo, se o codificador estiver produzindo duas camadas de vídeo com rótulos v1 e v2 e uma camada de áudio com rótulo a1, uma matriz como '[v1, a1]' instrui o codificador a produzir um arquivo de saída com a faixa de vídeo representada pela v1 e a faixa de áudio representada por a1.

PngFormat

Descreve as configurações para produzir miniaturas PNG.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.PngFormat

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

PngImage

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.PngImage

O discriminador para tipos derivados.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado 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 à hora de início predefinida no vídeo de entrada no qual parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar em 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de quadros (por exemplo, 300 para parar no 300º quadro do quadro na hora de início. Se esse valor for 1, significará produzir apenas uma miniatura na hora de início) ou um valor relativo para a duração do fluxo (por exemplo, 50% para parar na metade da duração do fluxo a partir da hora de início). O valor padrão é 100%, que significa parar no fim 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 iniciar em 5 segundos) ou uma contagem de quadros (por exemplo, 10 para iniciar no 10º quadro) ou um valor relativo para a duração do fluxo (por exemplo, 10% para iniciar com 10% da duração do fluxo). Também dá suporte à macro {Best}, que diz ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, não importando quais são as outras configurações para Step e Range. O valor padrão é macro {Best}.

step

string

Os intervalos nos quais 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 quadros (por exemplo, 30 para uma imagem a cada 30 quadros) ou um valor relativo para a duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Observação: o valor da etapa afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da predefinição de transformação. Isso ocorre devido ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a Posição da etapa da hora de início como a primeira saída. Como o valor padrão é 10%, isso significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada na hora de início. Tente selecionar um valor razoável para Etapa se a primeira miniatura for esperada perto da hora de início ou defina o valor de Intervalo como 1 se apenas uma miniatura for necessária 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

PngLayer

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

Nome Tipo Description
height

string

A altura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de altura quanto a entrada.

label

string

O rótulo alfanumérico para essa camada, que pode ser usado no multiplexação de diferentes camadas de áudio e vídeo ou na nomenclatura do arquivo de saída.

width

string

A largura do vídeo de saída para essa camada. O valor pode ser absoluto (em pixels) ou relativo (em porcentagem). Por exemplo, 50% significa que o vídeo de saída tem metade de tantos pixels de largura quanto a entrada.

PresetConfigurations

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

Nome Tipo Description
complexity

Complexity

Permite definir as configuraçõ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 compactação.

interleaveOutput

InterleaveOutput

Define o modo de intercalação da saída para controlar como áudio e vídeo são armazenados no formato de contêiner. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas somente áudio e somente vídeo em arquivos MP4 separados.

keyFrameIntervalInSeconds

number

O intervalo de quadro-chave em segundos. Exemplo: defina KeyFrameIntervalInSeconds como 2 para reduzir o buffer de reprodução para alguns jogadores.

maxBitrateBps

integer

A taxa máxima de bits em bits por segundo (limite para a camada de vídeo superior). Exemplo: defina MaxBitrateBps como 60000000 para evitar produzir saídas de taxa de bits muito altas para conteúdo com alta 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 de 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 4 camadas de saída sejam produzidas para controlar o custo geral do trabalho de codificação.

minBitrateBps

integer

A taxa de bits mínima em bits por segundo (limite para a camada de vídeo inferior). Exemplo: defina MinBitrateBps como 200000 para ter uma camada inferior que abrange usuários com baixa largura de banda de rede.

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 menores, como 180P.

Priority

Define a prioridade relativa de TransformOutputs em uma Transformação. Isso define a prioridade que o serviço usa para processar TransformOutputs. A prioridade padrão é Normal.

Nome Tipo Description
High

string

Usado para TransformOutputs que devem ter precedência sobre outros.

Low

string

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

Normal

string

Usado para TransformOutputs que podem ser gerados com prioridade normal.

Rectangle

Descreve as propriedades de uma janela retangular aplicada à mídia de entrada antes de processá-la.

Nome Tipo Description
height

string

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

left

string

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

top

string

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

width

string

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

Rotation

A rotação, se houver, a ser aplicada ao vídeo de entrada, antes de ser codificada. O padrão é Automático

Nome Tipo Description
Auto

string

Detecte e gire automaticamente conforme necessário.

None

string

Não gire o vídeo. Se o formato de saída der suporte a ele, todos os metadados sobre rotação serão mantidos intactos.

Rotate0

string

Não gire o vídeo, mas remova os metadados sobre a rotação.

Rotate180

string

Gire 180 graus no sentido horário.

Rotate270

string

Gire 270 graus no sentido horário.

Rotate90

string

Gire 90 graus no sentido horário.

StandardEncoderPreset

Descreve todas as configurações a serem usadas ao codificar o vídeo de entrada com o Codificador Padrão.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

O discriminador para tipos derivados.

codecs Codec[]:

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

experimentalOptions

object

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

filters

Filters

Uma ou mais operações de filtragem que são aplicadas à mídia de entrada antes da codificação.

formats Format[]:

A lista de saídas a serem produzidas pelo codificador.

StretchMode

O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída desejadas. O padrão é AutoSize

Nome Tipo Description
AutoFit

string

Remova a saída (com caixa de correio ou caixa de pilares) para honrar a resolução de saída, garantindo que a região de vídeo ativa na saída tenha a mesma taxa de proporção que a entrada. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação solicitar 1280x1280, a saída será em 1280x1280, que contém um retângulo interno de 1280x720 na proporção de proporção de 16:9 e regiões de caixa de pilar de 280 pixels de largura à esquerda e à direita.

AutoSize

string

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

None

string

Respeite estritamente a resolução de saída sem considerar a taxa de proporção de pixel ou a taxa de proporção de exibição do vídeo de entrada.

systemData

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

Nome 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 saídas desejadas da mídia de entrada, como transcodificação ou extração de insights. Depois que a Transformação é criada, ela pode ser aplicada à mídia de entrada criando Trabalhos.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada 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 quando a transformação foi criada no formato “AAAA-MM-DDThh:mm:ssZ”.

properties.description

string

Uma descrição detalhada opcional da transformação.

properties.lastModified

string

A data e hora UTC quando a transformação foi atualizada no formato “AAAA-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 a esse recurso.

type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

TransformOutput

Descreve as propriedades de um TransformOutput, que são as regras a serem aplicadas ao gerar a saída desejada.

Nome Tipo Description
onError

OnErrorType

Uma Transformação pode definir mais de uma saída. Essa propriedade define o que o serviço deve fazer quando uma saída falha – continue produzindo outras saídas ou interrompa as outras saídas. O estado geral do trabalho não refletirá falhas de saídas especificadas com 'ContinueJob'. O padrão é 'StopProcessingJob'.

preset Preset:

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

relativePriority

Priority

Define a prioridade relativa de TransformOutputs em uma Transformação. Isso define a prioridade que o serviço usa para processar TransformOutputs. A prioridade padrão é Normal.

TransportStreamFormat

Descreve as propriedades para gerar um arquivo de vídeo de saída de fluxo de transporte MPEG-2 (ISO/IEC 13818-1).

Nome Tipo Description
@odata.type string:

#Microsoft.Media.TransportStreamFormat

O discriminatório para tipos derivados.

filenamePattern

string

O padrão de nomenclatura de arquivo usado para a criação de arquivos de saída. As macros a seguir têm suporte no nome do arquivo: {Basename} – Uma macro de expansão que usará o nome do arquivo de vídeo de entrada. Se o nome base (o sufixo de arquivo não estiver incluído) do arquivo de vídeo de entrada tiver menos de 32 caracteres, o nome base dos arquivos de vídeo de entrada será usado. Se o comprimento do nome base do arquivo de vídeo de entrada exceder 32 caracteres, o nome base será truncado para os primeiros 32 caracteres de comprimento total. {Extension} – a extensão apropriada para esse formato. {Label} - O rótulo atribuído ao codec/camada. {Index} – um índice exclusivo para miniaturas. Aplicável somente a miniaturas. {AudioStream} - cadeia de caracteres "Áudio" mais número de fluxo de áudio (comece a partir de 1). {Bitrate} – a taxa de bits de áudio/vídeo em kbps. Não aplicável a miniaturas. {Codec} – o tipo do codec de áudio/vídeo. {Resolution} – A resolução de vídeo. Todas as macros não estruturadas serão recolhidas e removidas do nome do arquivo.

outputFiles

OutputFile[]

A lista de arquivos de saída a serem produzidos. Cada entrada na lista é um conjunto de rótulos de camada de áudio e vídeo a serem muxed juntos.

Video

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.Video

O discriminatório para tipos derivados.

keyFrameInterval

string

A distância entre dois quadros-chave. O valor deve ser diferente de zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. O padrão é 2 segundos (PT2S). Observe que essa configuração será ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a configuração de origem de entrada.

label

string

Um rótulo opcional para o codec. O rótulo pode ser usado 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 desejadas. O padrão é AutoSize

syncMode

VideoSyncMode

O modo de sincronização de vídeo

VideoAnalyzerPreset

Uma predefinição do analisador de vídeo que extrai insights (metadados avançados) de áudio e vídeo e gera um arquivo de formato JSON.

Nome Tipo Description
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

O discriminatório para tipos derivados.

audioLanguage

string

O idioma do conteúdo de áudio na entrada usando o formato BCP-47 de "região de marca de idioma" (por exemplo: 'en-US'). Se você souber o idioma do seu conteúdo, é recomendável especificá-lo. O idioma deve ser especificado explicitamente para AudioAnalysisMode::Basic, pois a detecção automática de idioma não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a detecção automática de idioma escolherá o primeiro idioma detectado e processará com o idioma selecionado para a duração do arquivo. Ele não suporta no momento alternar dinamicamente entre os idiomas depois que o primeiro idioma for detectado. A detecção automática funciona melhor com gravações de áudio com fala claramente perceptível. Se a detecção automática não encontrar o idioma, a transcrição retornará para 'en-US'." A lista de idiomas com suporte está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

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

insightsToExtract

InsightsType

Define o tipo de insights que você deseja que o serviço gere. Os valores permitidos são 'AudioInsightsOnly', 'VideoInsightsOnly' e 'AllInsights'. O padrão é AllInsights. Se você definir isso como AllInsights e a entrada for somente áudio, somente os insights de áudio serão gerados. Da mesma forma, se a entrada for somente vídeo, somente os insights de vídeo serão gerados. É recomendável que você não use AudioInsightsOnly se você espera que algumas de suas entradas sejam somente vídeo; ou use VideoInsightsOnly se você espera que algumas de suas entradas sejam somente áudio. Seus Trabalhos nessas condições seriam descartados.

mode

AudioAnalysisMode

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

VideoOverlay

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

Nome Tipo Description
@odata.type string:

#Microsoft.Media.VideoOverlay

O discriminatório para tipos derivados.

audioGainLevel

number

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

cropRectangle

Rectangle

Uma janela retangular opcional usada para cortar a imagem ou o vídeo de sobreposição.

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 encerrar a sobreposição em 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior que a duração do vídeo de entrada, a sobreposição será aplicada até o final do vídeo de entrada se a duração da mídia de sobreposição for maior que a duração do vídeo de entrada, caso contrário, a sobreposição durará tanto quanto a duração da mídia de sobreposição.

fadeInDuration

string

A duração sobre a qual a sobreposição desaparece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento padrão será não ter fade in (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 padrão será não ter desvanecimento (o mesmo que PT0S).

inputLabel

string

O rótulo da entrada do trabalho que deve ser usado como uma sobreposição. A Entrada deve especificar exatamente um arquivo. Você pode especificar um arquivo de imagem no formato JPG, PNG, GIF ou BMP ou um arquivo de áudio (como um arquivo WAV, MP3, WMA ou M4A) ou um arquivo de vídeo. Confira https://aka.ms/mesformats a lista completa de formatos de arquivo de áudio e vídeo com suporte.

opacity

number

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

position

Rectangle

O local no vídeo de entrada em que a sobreposição é aplicada.

start

string

A posição inicial, 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 em 5 segundos no vídeo de entrada. Se não for especificado, a sobreposição será iniciada desde o início do vídeo de entrada.

VideoSyncMode

O modo de sincronização de vídeo

Nome Tipo Description
Auto

string

Esse é o método padrão. Escolhe entre Cfr e Vfr dependendo dos recursos do muxer. Para o formato de saída MP4, o modo padrão é Cfr.

Cfr

string

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

Passthrough

string

Os carimbos de data/hora de apresentação em quadros são passados do arquivo de entrada para o gravador de arquivo de saída. Recomendado quando a fonte de entrada tem taxa de quadros variável e está tentando produzir várias camadas para streaming adaptável na saída que têm limites gop alinhados. Observação: se dois ou mais quadros na entrada tiverem carimbos de data/hora duplicados, a saída também terá o mesmo comportamento

Vfr

string

Semelhante ao modo passagem, mas se a entrada tiver quadros com carimbos de data/hora duplicados, apenas um quadro será passado para a saída e outros serão removidos. Recomendado quando se espera que o número de quadros de saída seja igual ao número de quadros de entrada. Por exemplo, a saída é usada para calcular uma métrica de qualidade como PSNR na entrada