Transforms - Update
Atualizar Transformação
Atualizações uma Transformação.
PATCH 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 |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta dos Serviços de Mídia. |
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura do Azure. |
subscription
|
path | True |
string |
O identificador exclusivo para uma assinatura do Microsoft Azure. |
transform
|
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 |
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 |
OK |
|
Other Status Codes |
Informações detalhadas de erro. |
Exemplos
Update a Transform.
Solicitação de exemplo
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/transformToUpdate?api-version=2022-07-01
{
"properties": {
"description": "Example transform to illustrate update.",
"outputs": [
{
"relativePriority": "High",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "H264MultipleBitrate720p"
}
}
]
}
}
Resposta de exemplo
{
"name": "transformToUpdate",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/transformToUpdate",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:32.1435128Z",
"description": "Example transform to illustrate update.",
"lastModified": "2022-10-17T23:14:32.1455494Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "High",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "H264MultipleBitrate720p"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:32.1435128Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:32.1455494Z"
}
}
Definições
Nome | Description |
---|---|
Aac |
Descreve as configurações de codificação de áudio AAC (Advanced Audio Codec). |
Aac |
O perfil de codificação a ser usado ao codificar áudio com o AAC. |
Analysis |
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. |
Audio |
Determina o conjunto de operações de análise de áudio a serem executadas. Se não for especificado, o Standard AudioAnalysisMode será escolhido. |
Audio |
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. |
Audio |
Descreve as propriedades de uma sobreposição de áudio. |
Blur |
Tipo de desfoque |
Built |
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. |
Copy |
Um sinalizador codec, que informa ao codificador para copiar o bitstream de áudio de entrada. |
Copy |
Um sinalizador de codec, que informa ao codificador para copiar o bitstream de vídeo de entrada sem recodificação. |
created |
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. |
Deinterlace |
O modo de desinterlacing. O padrão é AutoPixelAdaptive. |
Deinterlace |
A paridade de campo para desassociamento, usa como padrão Auto. |
Encoder |
A predefinição interna a ser usada para codificar vídeos. |
Entropy |
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. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
Os detalhes do erro. |
Error |
Resposta de erro |
Face |
Descreve todas as configurações a serem usadas ao analisar um vídeo para detectar (e, opcionalmente, redigir) todos os rostos presentes. |
Face |
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 é Balanceado. |
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. |
H264Rate |
O modo de controle de taxa de vídeo |
H264Video |
Descreve todas as propriedades para codificar um vídeo com o codec H.264. |
H264Video |
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. |
H265Video |
Atualmente, damos suporte a Main. O padrão é Automático. |
Image |
Descreve as propriedades básicas para gerar miniaturas do vídeo de entrada |
Image |
Descreve as propriedades de um arquivo de imagem de saída. |
Insights |
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. |
Interleave |
Define o modo de intercalação da saída para controlar como o áudio e o 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. |
Jpg |
Descreve as configurações para produzir miniaturas JPEG. |
Jpg |
Descreve as propriedades para produzir uma série de imagens JPEG do vídeo de entrada. |
Jpg |
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. |
Multi |
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. |
On |
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'. |
Output |
Representa um arquivo de saída produzido. |
Png |
Descreve as configurações para produzir miniaturas PNG. |
Png |
Descreve as propriedades para produzir uma série de imagens PNG do vídeo de entrada. |
Png |
Descreve as configurações para produzir uma imagem PNG do vídeo de entrada. |
Preset |
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 |
Standard |
Descreve todas as configurações a serem usadas ao codificar o vídeo de entrada com o Codificador Padrão. |
Stretch |
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 |
system |
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. |
Transform |
Descreve as propriedades de um TransformOutput, que são as regras a serem aplicadas ao gerar a saída desejada. |
Transport |
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. |
Video |
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. |
Video |
Descreve as propriedades de uma sobreposição de vídeo. |
Video |
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. |
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 |
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. |
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. |
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. |
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 |
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. |
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. |
O discriminador para tipos derivados. |
configurations |
Definições de configuração opcionais para o codificador. As configurações só têm suporte para ContentAwareEncoding e H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
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 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 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. |
O discriminador 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 recodificação.
Nome | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador 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. |
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 |
O modo de desinterlacing. O padrão é AutoPixelAdaptive. |
|
parity |
A paridade de campo para desassociamento, o 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) entropy encoding. |
Cavlc |
string |
Codificação de entropia cavlc (coder de comprimento variável adaptável) de contexto. |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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. |
O discriminador para tipos derivados. |
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 |
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 |
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 esmaecer 10 quadros a partir da hora de início) ou um valor relativo para a duração do fluxo (por exemplo, 10% para esmaecer 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 em 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 esmaecer. 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 |
Os parâmetros para a janela retangular com a qual cortar o vídeo de entrada. |
|
deinterlace |
As configurações de desassociamento. |
|
fadeIn |
Descreve as propriedades de um efeito Fade aplicado à mídia de entrada. |
|
fadeOut |
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 |
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 é 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. |
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 de 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 |
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 dessa 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 dessa camada, que pode ser usado para multiplexação de diferentes camadas de vídeo e áudio, 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á Auto, 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 |
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 dessa 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 média de taxa de bits (ABR) 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) direcionado à 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. |
O discriminador para tipos derivados. |
complexity |
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 |
A coleção de camadas H.264 de saída a serem produzidas pelo codificador. |
|
rateControlMode |
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 |
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 |
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 |
Perfil preditivo alto 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 3 Mbps significa que esse valor deve ser 30000000. 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 de 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 dessa 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 dessa camada, que pode ser usado para multiplexação de diferentes camadas de vídeo e áudio, 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á Auto, 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 |
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 dessa 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. |
O discriminador para tipos derivados. |
complexity |
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 é 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 |
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 está sendo configurado para produzir um único vídeo de saída. |
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 |
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. |
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 |
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 |
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. |
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. Falhará se os Insights de áudio ou vídeo falharem. |
AudioInsightsOnly |
string |
Gerar insights somente de áudio. Ignore o vídeo mesmo que esteja presente. Falhará se nenhum áudio estiver presente. |
VideoInsightsOnly |
string |
Gerar insights somente em vídeo. Ignore o áudio se presente. Falhará se nenhum vídeo estiver presente. |
InterleaveOutput
Define o modo de intercalação da saída para controlar como o áudio e o 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. |
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. |
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 |
Jpg |
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 |
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 |
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 dessa 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 dessa camada, que pode ser usado para multiplexação de diferentes camadas de vídeo e áudio, ou na nomenclatura do arquivo de saída. |
quality |
integer |
A qualidade de 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 dessa 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. |
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 |
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. |
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 |
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. |
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. |
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 |
Png |
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 |
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 |
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 dessa 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 dessa camada, que pode ser usado para multiplexação de diferentes camadas de vídeo e áudio, ou na nomenclatura do arquivo de saída. |
width |
string |
A largura do vídeo de saída dessa 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 |
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 |
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 |
Detectar e girar 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. |
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 |
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 |
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 |
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 |
Uma matriz de um ou mais TransformOutputs que a Transformação deve gerar. |
|
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 |
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 |
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. |
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 |
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. |
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. |
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 |
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. |
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 |
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 |
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. |
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 |
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 |
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 |