Transforms - Create Or Update
Criar ou Atualizar Transformação
Cria ou atualiza uma nova Transformação.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta dos Serviços de Multimédia. |
resource
|
path | True |
string |
O nome do grupo de recursos na subscrição do Azure. |
subscription
|
path | True |
string |
O identificador exclusivo de uma subscrição do Microsoft Azure. |
transform
|
path | True |
string |
O Nome da transformação. |
api-version
|
query | True |
string |
A versão da API a utilizar com o pedido de cliente. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
properties.outputs | True |
Uma matriz de um ou mais TransformOutputs que a Transformação deve gerar. |
|
properties.description |
string |
Uma descrição verbosa opcional da Transformação. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
Other Status Codes |
Informações de erro detalhadas. |
Exemplos
Create or update a Transform
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2022-07-01
{
"properties": {
"description": "Example Transform to illustrate create and update.",
"outputs": [
{
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
}
}
Resposta da amostra
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
Definições
Name | Description |
---|---|
Aac |
Descreve as definições de codificação de áudio do Advanced Audio Codec (AAC). |
Aac |
O perfil de codificação a utilizar ao codificar áudio com o AAC. |
Analysis |
Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a proporção adequada. Só será redimensionada se o vídeo tiver uma resolução mais alta. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeo de alta resolução. Também pode reduzir o custo de utilização deste componente (veja https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados. |
Audio |
Define as propriedades comuns para todos os codecs de áudio. |
Audio |
Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão. |
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 voz. Atualmente, a predefinição suporta o processamento de conteúdos com uma única faixa de áudio. |
Audio |
Descreve as propriedades de uma sobreposição de áudio. |
Blur |
Tipo de desfocagem |
Built |
Descreve uma predefinição incorporada para codificar o vídeo de entrada com o Codificador Standard. |
Complexity |
Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão. |
Copy |
Um sinalizador codec, que indica ao codificador para copiar o bitstream de áudio de entrada. |
Copy |
Um sinalizador codec, que indica ao codificador para copiar o bitstream de vídeo de entrada sem voltar a codificar. |
created |
O tipo de identidade que criou o recurso. |
DDAudio |
Descreve as definições de codificação de áudio do Dolby Digital Audio Codec (AC3). A implementação atual do suporte do Dolby Digital Audio é: números de canais de áudio em 1((mono), 2(estéreo), 6(5.1side); Taxas de frequência de amostragem de áudio em: 32K/44,1K/48K Hz; Os valores de velocidade de transmissão de áudio como especificação AC3 suportam: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
Deinterlace |
Descreve as definições de eliminação de intercalação. |
Deinterlace |
O modo de desinterlacagem. A predefinição é AutoPixelAdaptive. |
Deinterlace |
A paridade do campo para descodificador, é predefinida como Auto. |
Encoder |
A predefinição incorporada a ser utilizada para codificar vídeos. |
Entropy |
O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
Face |
Descreve todas as definições a utilizar ao analisar um vídeo para detetar (e, opcionalmente, redigir) todos os rostos presentes. |
Face |
Este modo permite escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca as aparências dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado – Foram detetados também rostos de redação (desfocagem). 3) Redação - Isto permite um processo de 2 passagens, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem, e um subconjunto de IDs selecionado pelo utilizador que requerem redação. |
Fade |
Descreve as propriedades de um efeito Fade aplicado ao suporte de dados de entrada. |
Filters |
Descreve todas as operações de filtragem, como a eliminação de intercalação, a rotação, etc., que devem ser aplicadas ao suporte de dados de entrada antes da codificação. |
H264Complexity |
Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado. |
H264Layer |
Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.264. |
H264Rate |
O modo de controlo de taxa de vídeo |
H264Video |
Descreve todas as propriedades para codificar um vídeo com o codec H.264. |
H264Video |
Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática. |
H265Complexity |
Diz ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Equilibrado. |
H265Layer |
Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.265. |
H265Video |
Descreve todas as propriedades para codificar um vídeo com o codec H.265. |
H265Video |
Atualmente, suportamos o Main. A predefinição é Automática. |
Image |
Descreve as propriedades básicas para gerar miniaturas a partir do vídeo de entrada |
Image |
Descreve as propriedades de um ficheiro de imagem de saída. |
Insights |
Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo. |
Interleave |
Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados. |
Jpg |
Descreve as definições para produzir miniaturas JPEG. |
Jpg |
Descreve as propriedades para produzir uma série de imagens JPEG a partir do vídeo de entrada. |
Jpg |
Descreve as definições para produzir uma imagem JPEG a partir do vídeo de entrada. |
Mp4Format |
Descreve as propriedades de um ficheiro ISO MP4 de saída. |
Multi |
Descreve as propriedades para produzir uma coleção de ficheiros de velocidade de transmissão múltipla alinhados com GOP. O comportamento predefinido é produzir um ficheiro de saída para cada camada de vídeo, que é codificada juntamente com todos os áudios. Os ficheiros de saída exatos produzidos podem ser controlados ao especificar a coleção outputFiles. |
On |
Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob". |
Output |
Representa um ficheiro de saída produzido. |
Png |
Descreve as definições para a produção de miniaturas PNG. |
Png |
Descreve as propriedades para produzir uma série de imagens PNG a partir do vídeo de entrada. |
Png |
Descreve as definições para produzir uma imagem PNG a partir do vídeo de entrada. |
Preset |
Um objeto de definições de configuração opcionais para codificador. |
Priority |
Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal. |
Rectangle |
Descreve as propriedades de uma janela retangular aplicada ao suporte de dados de entrada antes de a processar. |
Rotation |
A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática |
Standard |
Descreve todas as definições a utilizar ao codificar o vídeo de entrada com o Codificador Standard. |
Stretch |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é o Dimensionamento Automático |
system |
Metadados relativos à criação e última modificação do recurso. |
Transform |
Uma Transformação encapsula as regras ou instruções para gerar as saídas pretendidas a partir de suportes de dados de entrada, como transcodificação ou extração de informações. Após a criação da Transformação, pode ser aplicada ao suporte de dados de entrada ao criar Tarefas. |
Transform |
Descreve as propriedades de um TransformOutput, que são as regras a aplicar ao gerar o resultado pretendido. |
Transport |
Descreve as propriedades para gerar um(s) MPEG-2 Transport Stream (ISO/IEC 13818-1) ficheiro(s) de vídeo de saída. |
Video |
Descreve as propriedades básicas para codificar o vídeo de entrada. |
Video |
Uma predefinição do analisador de vídeo que extrai informações (metadados avançados) de áudio e vídeo e produz um ficheiro de formato JSON. |
Video |
Descreve as propriedades de uma sobreposição de vídeo. |
Video |
Modo de Sincronização de Vídeo |
AacAudio
Descreve as definições de codificação de áudio do Advanced Audio Codec (AAC).
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
bitrate |
integer |
A velocidade de transmissão, em bits por segundo, do áudio codificado de saída. |
channels |
integer |
O número de canais no áudio. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento do muxing. |
profile |
O perfil de codificação a utilizar ao codificar áudio com o AAC. |
|
samplingRate |
integer |
A taxa de amostragem a utilizar para codificação no hertz. |
AacAudioProfile
O perfil de codificação a utilizar ao codificar áudio com o AAC.
Name | Tipo | Description |
---|---|---|
AacLc |
string |
Especifica que o áudio de saída deve ser codificado no perfil AAC Low Complexity (AAC-LC). |
HeAacV1 |
string |
Especifica que o áudio de saída deve ser codificado no perfil HE-AAC v1. |
HeAacV2 |
string |
Especifica que o áudio de saída deve ser codificado no perfil HE-AAC v2. |
AnalysisResolution
Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" redimensionará os vídeos de entrada para a definição padrão, preservando a proporção adequada. Só será redimensionada se o vídeo tiver uma resolução mais alta. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeo de alta resolução. Também pode reduzir o custo de utilização deste componente (veja https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados.
Name | Tipo | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
Audio
Define as propriedades comuns para todos os codecs de áudio.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
bitrate |
integer |
A velocidade de transmissão, em bits por segundo, do áudio codificado de saída. |
channels |
integer |
O número de canais no áudio. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
samplingRate |
integer |
A taxa de amostragem a utilizar para codificação no hertz. |
AudioAnalysisMode
Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão.
Name | Tipo | Description |
---|---|---|
Basic |
string |
Este modo executa a transcrição de voz em texto e a geração de um ficheiro de subtítulo/legenda VTT. O resultado deste modo inclui um ficheiro JSON do Insights, incluindo apenas as palavras-chave, transcrição e informações de temporização. A deteção automática de idiomas e a diarização de orador não estão incluídas neste modo. |
Standard |
string |
Efetua todas as operações incluídas no modo Básico, além de efetuar a deteção de idioma e a diarização de orador. |
AudioAnalyzerPreset
A predefinição do Analisador de Áudio aplica um conjunto predefinido de operações de análise baseadas em IA, incluindo transcrição de voz. Atualmente, a predefinição suporta o processamento de conteúdos com uma única faixa de áudio.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
audioLanguage |
string |
O idioma do payload de áudio na entrada com o formato BCP-47 de "language tag-region" (por exemplo, "en-US"). Se souber o idioma do seu conteúdo, recomenda-se que o especifique. O idioma tem de ser especificado explicitamente para AudioAnalysisMode::Basic, uma vez que a deteção automática de idiomas não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a deteção automática de idiomas escolherá o primeiro idioma detetado e processará com o idioma selecionado durante a duração do ficheiro. Atualmente, não suporta alternar dinamicamente entre idiomas após a deteção do primeiro idioma. A deteção automática funciona melhor com gravações de áudio com voz claramente perceptível. Se a deteção automática não encontrar o idioma, a transcrição reverterá para "en-US". A lista de idiomas suportados está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido |
mode |
Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Standard. |
AudioOverlay
Descreve as propriedades de uma sobreposição de áudio.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
audioGainLevel |
number |
O nível de ganho de áudio na sobreposição. O valor deve estar no intervalo [0, 1,0]. A predefinição é 1.0. |
end |
string |
A posição final, com referência ao vídeo de entrada, no qual a sobreposição termina. O valor deve estar no formato ISO 8601. Por exemplo, PT30S para terminar a sobreposição a 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior do que a duração do vídeo de entrada, a sobreposição será aplicada até ao fim do vídeo de entrada se a duração do suporte de dados de sobreposição for maior do que a duração do vídeo de entrada, caso contrário, a sobreposição irá durar até à duração do suporte de dados de sobreposição. |
fadeInDuration |
string |
A duração sobre a qual a sobreposição se desvanece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S). |
fadeOutDuration |
string |
A duração sobre a qual a sobreposição desaparece do vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S). |
inputLabel |
string |
A etiqueta da entrada da tarefa que deve ser utilizada como uma sobreposição. A Entrada tem de especificar exatamente um ficheiro. Pode especificar um ficheiro de imagem no formato JPG, PNG, GIF ou BMP ou um ficheiro de áudio (como um ficheiro WAV, MP3, WMA ou M4A) ou um ficheiro de vídeo. Veja https://aka.ms/mesformats para obter a lista completa dos formatos de ficheiro de áudio e vídeo suportados. |
start |
string |
A posição de início, com referência ao vídeo de entrada, no qual a sobreposição é iniciada. O valor deve estar no formato ISO 8601. Por exemplo, PT05S para iniciar a sobreposição a 5 segundos no vídeo de entrada. Se não for especificada, a sobreposição começa a partir do início do vídeo de entrada. |
BlurType
Tipo de desfocagem
Name | Tipo | Description |
---|---|---|
Black |
string |
Preto: Filtro de desa black out |
Box |
string |
Caixa: filtro de depuração, apenas caixa delimitadora |
High |
string |
Alto: confundir filtro de desfocagem |
Low |
string |
Baixo: filtro de desfocagem de carro de caixa |
Med |
string |
Med: Filtro de desfocagem gaussiano |
BuiltInStandardEncoderPreset
Descreve uma predefinição incorporada para codificar o vídeo de entrada com o Codificador Standard.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
configurations |
Definições de configuração opcionais para codificador. As configurações só são suportadas para ContentAwareEncoding e H265ContentAwareEncoding BuiltInStandardEncoderPreset. |
|
presetName |
A predefinição incorporada a ser utilizada para codificar vídeos. |
Complexity
Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão.
Name | Tipo | Description |
---|---|---|
Balanced |
string |
Configura o codificador para utilizar definições que conseguem um equilíbrio entre velocidade e qualidade. |
Quality |
string |
Configura o codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento do tempo de codificação geral mais lento. |
Speed |
string |
Configura o codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação. |
CopyAudio
Um sinalizador codec, que indica ao codificador para copiar o bitstream de áudio de entrada.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
CopyVideo
Um sinalizador codec, que indica ao codificador para copiar o bitstream de vídeo de entrada sem voltar a codificar.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Descreve as definições de codificação de áudio do Dolby Digital Audio Codec (AC3). A implementação atual do suporte do Dolby Digital Audio é: números de canais de áudio em 1((mono), 2(estéreo), 6(5.1side); Taxas de frequência de amostragem de áudio em: 32K/44,1K/48K Hz; Os valores de velocidade de transmissão de áudio como especificação AC3 suportam: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
bitrate |
integer |
A velocidade de transmissão, em bits por segundo, do áudio codificado de saída. |
channels |
integer |
O número de canais no áudio. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento do muxing. |
samplingRate |
integer |
A taxa de amostragem a utilizar para codificação no hertz. |
Deinterlace
Descreve as definições de eliminação de intercalação.
Name | Tipo | Description |
---|---|---|
mode |
O modo de desinterlacagem. Predefinição para AutoPixelAdaptive. |
|
parity |
A paridade do campo para descodificador, é predefinida como Auto. |
DeinterlaceMode
O modo de desinterlacagem. A predefinição é AutoPixelAdaptive.
Name | Tipo | Description |
---|---|---|
AutoPixelAdaptive |
string |
Aplique a descodificadora adaptável automática de píxeis em cada frame no vídeo de entrada. |
Off |
string |
Desativa a eliminação de intercalação do vídeo de origem. |
DeinterlaceParity
A paridade do campo para descodificador, é predefinida como Auto.
Name | Tipo | Description |
---|---|---|
Auto |
string |
Detetar automaticamente a ordem dos campos |
BottomFieldFirst |
string |
Aplique o primeiro processamento do campo inferior do vídeo de entrada. |
TopFieldFirst |
string |
Aplique o primeiro processamento do campo superior do vídeo de entrada. |
EncoderNamedPreset
A predefinição incorporada a ser utilizada para codificar vídeos.
Name | Tipo | Description |
---|---|---|
AACGoodQualityAudio |
string |
Produz um único ficheiro MP4 que contém apenas áudio estéreo AAC codificado a 192 kbps. |
AdaptiveStreaming |
string |
Produz um conjunto de ficheiros MP4 alinhados com GOP com vídeo H.264 e áudio AAC estéreo. Gera automaticamente uma escada de velocidade de transmissão com base na resolução de entrada, velocidade de transmissão e taxa de fotogramas. A predefinição gerada automaticamente nunca excederá a resolução de entrada. Por exemplo, se a entrada for de 720p, a saída permanecerá, na melhor das hipóteses, 720p. |
ContentAwareEncoding |
string |
Produz um conjunto de MP4s alinhados com GOP através da codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço realiza uma análise simples inicial do conteúdo de entrada e utiliza os resultados para determinar o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega através da transmissão em fluxo adaptável. Esta predefinição é particularmente eficaz para vídeos de complexidade baixa e média, onde os ficheiros de saída estarão em velocidades de transmissão mais baixas, mas com uma qualidade que ainda proporciona uma boa experiência aos espectadores. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados. |
ContentAwareEncodingExperimental |
string |
Expõe uma predefinição experimental para codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço tenta determinar automaticamente o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega por transmissão em fluxo adaptável. Os algoritmos subjacentes continuarão a evoluir ao longo do tempo. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados. |
CopyAllBitrateNonInterleaved |
string |
Copie todos os fluxos de vídeo e áudio do elemento de entrada como ficheiros de saída de áudio e vídeo não intercalados. Esta predefinição pode ser utilizada para recortar um recurso existente ou converter um grupo de ficheiros MP4 alinhados com moldura de chave (GOP) como um recurso que pode ser transmitido em fluxo. |
DDGoodQualityAudio |
string |
Produz um único ficheiro MP4 que contém apenas áudio estéreo DD (Digital Dolby) codificado a 192 kbps. |
H264MultipleBitrate1080p |
string |
Produz um conjunto de 8 ficheiros MP4 alinhados com GOP, que variam entre 6000 kbps e 400 kbps e áudio AAC estéreo. A resolução começa a 1080p e desce para 180p. |
H264MultipleBitrate720p |
string |
Produz um conjunto de 6 ficheiros MP4 alinhados com GOP, que variam entre 3400 kbps e 400 kbps e áudio AAC estéreo. A resolução começa nos 720p e desce para 180p. |
H264MultipleBitrateSD |
string |
Produz um conjunto de 5 ficheiros MP4 alinhados com GOP, que variam entre 1900 kbps e 400 kbps e áudio AAC estéreo. A resolução começa nos 480p e desce para 240p. |
H264SingleBitrate1080p |
string |
Produz um ficheiro MP4 onde o vídeo é codificado com codec H.264 a 6750 kbps e uma altura de imagem de 1080 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps. |
H264SingleBitrate720p |
string |
Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.264 a 4500 kbps e uma altura de imagem de 720 píxeis e o áudio estéreo é codificado com o codec AAC-LC a 128 kbps. |
H264SingleBitrateSD |
string |
Produz um ficheiro MP4 em que o vídeo é codificado com um codec H.264 a 2200 kbps e uma altura de imagem de 480 píxeis e o áudio estéreo é codificado com o codec AAC-LC a 128 kbps. |
H265AdaptiveStreaming |
string |
Produz um conjunto de ficheiros MP4 alinhados com GOP com vídeo H.265 e áudio AAC estéreo. Gera automaticamente uma escada de velocidade de transmissão com base na resolução de entrada, velocidade de transmissão e taxa de fotogramas. A predefinição gerada automaticamente nunca excederá a resolução de entrada. Por exemplo, se a entrada for de 720p, a saída permanecerá, na melhor das hipóteses, 720p. |
H265ContentAwareEncoding |
string |
Produz um conjunto de MP4s alinhados com GOP através da codificação com deteção de conteúdo. Tendo em conta qualquer conteúdo de entrada, o serviço realiza uma análise simples inicial do conteúdo de entrada e utiliza os resultados para determinar o número ideal de camadas, as definições de velocidade de transmissão e resolução adequadas para entrega através da transmissão em fluxo adaptável. Esta predefinição é particularmente eficaz para vídeos de complexidade baixa e média, onde os ficheiros de saída estarão em velocidades de transmissão mais baixas, mas com uma qualidade que ainda proporciona uma boa experiência aos espectadores. A saída irá conter ficheiros MP4 com vídeo e áudio intercalados. |
H265SingleBitrate1080p |
string |
Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 3500 kbps e uma altura de imagem de 1080 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps. |
H265SingleBitrate4K |
string |
Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 9500 kbps e uma altura de imagem de 2160 pixels e o áudio estéreo é codificado com codec AAC-LC a 128 kbps. |
H265SingleBitrate720p |
string |
Produz um ficheiro MP4 onde o vídeo é codificado com um codec H.265 a 1800 kbps e uma altura de imagem de 720 píxeis e o áudio estéreo é codificado com codec AAC-LC a 128 kbps. |
EntropyMode
O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível.
Name | Tipo | Description |
---|---|---|
Cabac |
string |
Codificação de entropia do Codificador Aritmético Binário de Contexto (CABAC). |
Cavlc |
string |
Codificação de entropia do Codificador de Comprimento de Variável Adaptável de Contexto (CAVLC). |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
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 a erros
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
FaceDetectorPreset
Descreve todas as definições a utilizar ao analisar um vídeo para detetar (e, opcionalmente, redigir) todos os rostos presentes.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
blurType |
Tipo de desfocagem |
|
experimentalOptions |
object |
Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido |
mode |
Este modo fornece a capacidade de escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca os aspetos dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado - Também foram detetados rostos de redação(desfocados). 3) Redact - Isto permite um processo de 2 passes, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem e um subconjunto selecionado pelo utilizador de IDs que requerem redação. |
|
resolution |
Especifica a resolução máxima em que o vídeo é analisado. O comportamento predefinido é "SourceResolution", que manterá o vídeo de entrada na resolução original quando analisado. A utilização de "StandardDefinition" irá redimensionar os vídeos de entrada para a definição padrão, preservando ao mesmo tempo a proporção adequada. Só será redimensionada se o vídeo for de resolução superior. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeos de alta resolução. Também pode reduzir o custo de utilização deste componente (consulte https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics para obter detalhes). No entanto, os rostos que acabam por ser demasiado pequenos no vídeo redimensionado podem não ser detetados. |
FaceRedactorMode
Este modo permite escolher entre as seguintes definições: 1) Analisar – apenas para deteção. Este modo gera um ficheiro JSON de metadados que marca as aparências dos rostos ao longo do vídeo. Sempre que possível, os aspetos da mesma pessoa são atribuídos ao mesmo ID. 2) Combinado – Foram detetados também rostos de redação (desfocagem). 3) Redação - Isto permite um processo de 2 passagens, permitindo a redação seletiva de um subconjunto de rostos detetados. Recebe o ficheiro de metadados de um passe de análise anterior, juntamente com o vídeo de origem, e um subconjunto de IDs selecionado pelo utilizador que requerem redação.
Name | Tipo | Description |
---|---|---|
Analyze |
string |
O modo de análise deteta rostos e produz um ficheiro de metadados com os resultados. Permite a edição do ficheiro de metadados antes de os rostos serem desfocados com o modo Redact. |
Combined |
string |
O modo combinado faz com que os passos Analisar e Redigir num só passo ao editar os rostos analisados não são os pretendidos. |
Redact |
string |
O modo de redação consome o ficheiro de metadados do modo Analisar e redigi os rostos encontrados. |
Fade
Descreve as propriedades de um efeito Fade aplicado ao suporte de dados de entrada.
Name | Tipo | Description |
---|---|---|
duration |
string |
A Duração do efeito de desvanecimento no vídeo. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para desvanecer uma cor durante 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para desaparecer 10 fotogramas a partir da hora de início) ou um valor relativo à duração do fluxo (por exemplo, 10% para desaparecer 10% da duração do fluxo) |
fadeColor |
string |
A Cor para a entrada/saída desvanecimento. pode estar nas cores https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords do Nível CSS1 ou num valor RGB/hexadecim: por exemplo: rgb(255,0,0), 0xFF0000 ou #FF0000 |
start |
string |
A posição no vídeo de entrada a partir de onde começar a desaparecer. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). A predefinição é 0 |
Filters
Descreve todas as operações de filtragem, como a eliminação de intercalação, a rotação, etc., que devem ser aplicadas ao suporte de dados de entrada antes da codificação.
Name | Tipo | Description |
---|---|---|
crop |
Os parâmetros da janela retangular com a qual recortar o vídeo de entrada. |
|
deinterlace |
As definições de eliminação de intercalação. |
|
fadeIn |
Descreve as propriedades de um efeito Desvanecer aplicado ao suporte de dados de entrada. |
|
fadeOut |
Descreve as propriedades de um efeito Desvanecer aplicado ao suporte de dados de entrada. |
|
overlays | Overlay[]: |
As propriedades das sobreposições a aplicar ao vídeo de entrada. Podem ser sobreposições de áudio, imagem ou vídeo. |
rotation |
A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática |
H264Complexity
Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado.
Name | Tipo | Description |
---|---|---|
Balanced |
string |
Diz ao codificador para utilizar definições que conseguem um equilíbrio entre a velocidade e a qualidade. |
Quality |
string |
Indica ao codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento do tempo de codificação geral mais lento. |
Speed |
string |
Indica ao codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação. |
H264Layer
Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.264.
Name | Tipo | Description |
---|---|---|
adaptiveBFrame |
boolean |
Se as molduras B adaptáveis devem ou não ser utilizadas ao codificar esta camada. Se não for especificado, o codificador irá ativá-lo sempre que o perfil de vídeo permitir a sua utilização. |
bFrames |
integer |
O número de fotogramas B a utilizar ao codificar esta camada. Se não for especificado, o codificador escolhe um número adequado com base no perfil e nível de vídeo. |
bitrate |
integer |
A velocidade de transmissão média em bits por segundo para codificar o vídeo de entrada ao gerar esta camada. Este é um campo obrigatório. |
bufferWindow |
string |
O comprimento da janela da memória intermédia VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. A predefinição é de 5 segundos (por exemplo, PT5S). |
crf |
number |
O valor de CRF a ser utilizado ao codificar esta camada. Esta definição entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor CRF é entre 0 e 51, em que os valores mais baixos resultariam numa melhor qualidade, em detrimento de tamanhos de ficheiro mais elevados. Os valores mais elevados significam mais compressão, mas em algum momento a degradação da qualidade será notada. O valor predefinido é 23. |
entropyMode |
O modo de entropia a ser utilizado para esta camada. Se não for especificado, o codificador escolhe o modo adequado para o perfil e o nível. |
|
frameRate |
string |
A taxa de fotogramas (em fotogramas por segundo) para codificar esta camada. O valor pode ser na forma de M/N em que M e N são números inteiros (por exemplo, 30000/1001) ou na forma de um número (por exemplo, 30 ou 29,97). O codificador impõe restrições às taxas de fotogramas permitidas com base no perfil e no nível. Se não for especificado, o codificador utilizará a mesma taxa de fotogramas que o vídeo de entrada. |
height |
string |
A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada. |
label |
string |
A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída. |
level |
string |
Atualmente, suportamos o Nível até 6.2. O valor pode ser Automático ou um número que corresponda ao perfil H.264. Se não for especificado, a predefinição é Automático, o que permite ao codificador escolher o Nível adequado para esta camada. |
maxBitrate |
integer |
A velocidade de transmissão máxima (em bits por segundo), na qual a memória intermédia VBV deve ser assumida como recarga. Se não for especificado, a predefinição é o mesmo valor que a velocidade de transmissão. |
profile |
Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática. |
|
referenceFrames |
integer |
O número de fotogramas de referência a utilizar ao codificar esta camada. Se não for especificado, o codificador determina um número adequado com base na definição de complexidade do codificador. |
slices |
integer |
O número de setores a utilizar ao codificar esta camada. Se não for especificado, a predefinição é zero, o que significa que o codificador utilizará um único setor para cada moldura. |
width |
string |
A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada. |
H264RateControlMode
O modo de controlo de taxa de vídeo
Name | Tipo | Description |
---|---|---|
ABR |
string |
Modo de Velocidade de Transmissão Média (ABR) que atinge a velocidade de transmissão de destino: modo predefinido. |
CBR |
string |
Modo de Velocidade de Transmissão Constante (CBR) que aperta as variações de velocidade de transmissão em torno da velocidade de transmissão de destino. |
CRF |
string |
Modo De Fator de Taxa Constante (CRF) que visa a qualidade subjetiva constante. |
H264Video
Descreve todas as propriedades para codificar um vídeo com o codec H.264.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
complexity |
Indica ao codificador como escolher as respetivas definições de codificação. O valor predefinido é Balanceado. |
|
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
layers |
A coleção de camadas H.264 de saída a produzir pelo codificador. |
|
rateControlMode |
O modo de controlo de taxa de vídeo |
|
sceneChangeDetection |
boolean |
Se o codificador deve ou não inserir fotogramas de chave nas alterações de cena. Se não for especificado, a predefinição é falsa. Este sinalizador deve ser definido como verdadeiro apenas quando o codificador estiver a ser configurado para produzir um único vídeo de saída. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
H264VideoProfile
Atualmente, suportamos a Linha base, Principal, Alta, High422, High444. A predefinição é Automática.
Name | Tipo | Description |
---|---|---|
Auto |
string |
Indica ao codificador para determinar automaticamente o perfil H.264 adequado. |
Baseline |
string |
Perfil de linha de base |
High |
string |
Perfil elevado. |
High422 |
string |
Perfil alto 4:2:2. |
High444 |
string |
Perfil preditivo elevado de 4:4:4. |
Main |
string |
Perfil principal |
H265Complexity
Diz ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Equilibrado.
Name | Tipo | Description |
---|---|---|
Balanced |
string |
Diz ao codificador para utilizar definições que conseguem um equilíbrio entre velocidade e qualidade. |
Quality |
string |
Diz ao codificador para utilizar definições otimizadas para produzir uma saída de maior qualidade em detrimento de um tempo de codificação geral mais lento. |
Speed |
string |
Diz ao codificador para utilizar definições otimizadas para codificação mais rápida. A qualidade é sacrificada para diminuir o tempo de codificação. |
H265Layer
Descreve as definições a utilizar ao codificar o vídeo de entrada numa camada de velocidade de transmissão de saída pretendida com o codec de vídeo H.265.
Name | Tipo | Description |
---|---|---|
adaptiveBFrame |
boolean |
Especifica se os fotogramas B adaptáveis devem ou não ser utilizados ao codificar esta camada. Se não for especificado, o codificador irá ativá-lo sempre que o perfil de vídeo permitir a sua utilização. |
bFrames |
integer |
O número de fotogramas B a utilizar ao codificar esta camada. Se não for especificado, o codificador escolhe um número adequado com base no perfil e nível de vídeo. |
bitrate |
integer |
A velocidade de transmissão média em bits por segundo para codificar o vídeo de entrada ao gerar esta camada. Por exemplo: uma velocidade de bit de destino de 3000 Kbps ou 3 Mbps significa que este valor deve ser 3000000 Este é um campo obrigatório. |
bufferWindow |
string |
O comprimento da janela da memória intermédia VBV. O valor deve estar no formato ISO 8601. O valor deve estar no intervalo [0,1-100] segundos. A predefinição é de 5 segundos (por exemplo, PT5S). |
crf |
number |
O valor de CRF a ser utilizado ao codificar esta camada. Esta definição entra em vigor quando RateControlMode do codec de vídeo é definido no modo CRF. O intervalo de valor CRF é entre 0 e 51, em que os valores mais baixos resultariam numa melhor qualidade, em detrimento de tamanhos de ficheiro mais elevados. Os valores mais elevados significam mais compressão, mas em algum momento a degradação da qualidade será notada. O valor predefinido é 28. |
frameRate |
string |
A taxa de fotogramas (em fotogramas por segundo) para codificar esta camada. O valor pode ser na forma de M/N em que M e N são números inteiros (por exemplo, 30000/1001) ou na forma de um número (por exemplo, 30 ou 29,97). O codificador impõe restrições às taxas de fotogramas permitidas com base no perfil e no nível. Se não for especificado, o codificador utilizará a mesma taxa de fotogramas que o vídeo de entrada. |
height |
string |
A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada. |
label |
string |
A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída. |
level |
string |
Atualmente, suportamos o Nível até 6.2. O valor pode ser Automático ou um número que corresponda ao perfil H.265. Se não for especificado, a predefinição é Automático, o que permite ao codificador escolher o Nível adequado para esta camada. |
maxBitrate |
integer |
A velocidade de transmissão máxima (em bits por segundo), na qual a memória intermédia VBV deve ser assumida como recarga. Se não for especificado, a predefinição é o mesmo valor que a velocidade de transmissão. |
profile |
Atualmente, suportamos o Main. A predefinição é Automática. |
|
referenceFrames |
integer |
O número de fotogramas de referência a utilizar ao codificar esta camada. Se não for especificado, o codificador determina um número adequado com base na definição de complexidade do codificador. |
slices |
integer |
O número de setores a utilizar ao codificar esta camada. Se não for especificado, a predefinição é zero, o que significa que o codificador utilizará um único setor para cada moldura. |
width |
string |
A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada. |
H265Video
Descreve todas as propriedades para codificar um vídeo com o codec H.265.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
complexity |
Indica ao codificador como escolher as respetivas definições de codificação. A qualidade proporcionará uma proporção de compressão mais elevada, mas com um custo mais elevado e um tempo de computação mais longo. A velocidade produzirá um ficheiro relativamente maior, mas é mais rápido e económico. O valor predefinido é Balanceado. |
|
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
layers |
A coleção de camadas H.265 de saída a produzir pelo codificador. |
|
sceneChangeDetection |
boolean |
Especifica se o codificador deve ou não inserir fotogramas de chave nas alterações de cena. Se não for especificado, a predefinição é falsa. Este sinalizador deve ser definido como verdadeiro apenas quando o codificador estiver a ser configurado para produzir um único vídeo de saída. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
H265VideoProfile
Atualmente, suportamos o Main. A predefinição é Automática.
Name | Tipo | Description |
---|---|---|
Auto |
string |
Indica ao codificador para determinar automaticamente o perfil H.265 adequado. |
Main |
string |
Perfil principal (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier) |
Main10 |
string |
Perfil principal 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
Descreve as propriedades básicas para gerar miniaturas a partir do vídeo de entrada
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
range |
string |
A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo. |
start |
string |
A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}. |
step |
string |
Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
ImageFormat
Descreve as propriedades de um ficheiro de imagem de saída.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
InsightsType
Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo.
Name | Tipo | Description |
---|---|---|
AllInsights |
string |
Gerar informações de áudio e vídeo. Falha se o Audio ou o Video Insights falharem. |
AudioInsightsOnly |
string |
Gerar apenas informações de áudio. Ignore o vídeo mesmo que esteja presente. Falha se não existir áudio. |
VideoInsightsOnly |
string |
Gerar apenas informações de vídeo. Ignore o áudio se estiver presente. Falha se não existir nenhum vídeo. |
InterleaveOutput
Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados.
Name | Tipo | Description |
---|---|---|
InterleavedOutput |
string |
A saída inclui áudio e vídeo. |
NonInterleavedOutput |
string |
A saída é apenas de vídeo ou apenas áudio. |
JpgFormat
Descreve as definições para produzir miniaturas JPEG.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
JpgImage
Descreve as propriedades para produzir uma série de imagens JPEG a partir do vídeo de entrada.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
layers |
Jpg |
Uma coleção de camadas de imagem JPEG de saída a serem produzidas pelo codificador. |
range |
string |
A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo. |
spriteColumn |
integer |
Define o número de colunas utilizadas na imagem de sprite de miniaturas. O número de linhas é calculado automaticamente e é gerado um ficheiro VTT com os mapeamentos de coordenadas para cada miniatura no sprite. Nota: este valor deve ser um número inteiro positivo e é recomendado um valor adequado para que a resolução da imagem de saída não ultrapasse o limite máximo de resolução de píxeis JPEG 65535x65535. |
start |
string |
A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}. |
step |
string |
Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
JpgLayer
Descreve as definições para produzir uma imagem JPEG a partir do vídeo de entrada.
Name | Tipo | Description |
---|---|---|
height |
string |
A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada. |
label |
string |
A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída. |
quality |
integer |
A qualidade de compressão da saída JPEG. O intervalo é de 0 a 100 e a predefinição é 70. |
width |
string |
A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada. |
Mp4Format
Descreve as propriedades de um ficheiro ISO MP4 de saída.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
outputFiles |
A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto. |
MultiBitrateFormat
Descreve as propriedades para produzir uma coleção de ficheiros de velocidade de transmissão múltipla alinhados com GOP. O comportamento predefinido é produzir um ficheiro de saída para cada camada de vídeo, que é codificada juntamente com todos os áudios. Os ficheiros de saída exatos produzidos podem ser controlados ao especificar a coleção outputFiles.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
outputFiles |
A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto. |
OnErrorType
Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob".
Name | Tipo | Description |
---|---|---|
ContinueJob |
string |
Indica ao serviço que, se este TransformOutput falhar, permita que qualquer outro TransformOutput continue. |
StopProcessingJob |
string |
Indica ao serviço que, se este TransformOutput falhar, quaisquer outros TransformOutputs incompletos podem ser parados. |
OutputFile
Representa um ficheiro de saída produzido.
Name | Tipo | Description |
---|---|---|
labels |
string[] |
A lista de etiquetas que descrevem como o codificador deve utilizar o vídeo e o áudio multiplex num ficheiro de saída. Por exemplo, se o codificador estiver a produzir duas camadas de vídeo com etiquetas v1 e v2 e uma camada de áudio com a etiqueta a1, uma matriz como "[v1, a1]" indica ao codificador para produzir um ficheiro de saída com a faixa de vídeo representada pela v1 e a faixa de áudio representada por a1. |
PngFormat
Descreve as definições para a produção de miniaturas PNG.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
PngImage
Descreve as propriedades para produzir uma série de imagens PNG a partir do vídeo de entrada.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
layers |
Png |
Uma coleção de camadas de imagem PNG de saída a serem produzidas pelo codificador. |
range |
string |
A posição relativa à transformação da hora de início predefinida no vídeo de entrada para parar de gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT5M30S parar a 5 minutos e 30 segundos a partir da hora de início) ou uma contagem de fotogramas (por exemplo, 300 para parar no 300º fotograma da hora de início. Se este valor for 1, significa apenas produzir uma miniatura à hora de início) ou um valor relativo à duração do fluxo (por exemplo, 50% para parar a metade da duração do fluxo a partir da hora de início). O valor predefinido é 100%, o que significa parar no final do fluxo. |
start |
string |
A posição no vídeo de entrada de onde começar a gerar miniaturas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para começar a 5 segundos) ou uma contagem de fotogramas (por exemplo, 10 para começar no 10.º fotograma) ou um valor relativo para a duração do fluxo (por exemplo, 10% para começar a 10% da duração do fluxo). Também suporta uma macro {Best}, que indica ao codificador para selecionar a melhor miniatura dos primeiros segundos do vídeo e produzirá apenas uma miniatura, independentemente das outras definições para Passo e Intervalo. O valor predefinido é macro {Best}. |
step |
string |
Os intervalos em que as miniaturas são geradas. O valor pode estar no formato ISO 8601 (por exemplo, PT05S para uma imagem a cada 5 segundos) ou uma contagem de fotogramas (por exemplo, 30 para uma imagem a cada 30 fotogramas) ou um valor relativo à duração do fluxo (por exemplo, 10% para uma imagem a cada 10% da duração do fluxo). Nota: o valor do passo afetará a primeira miniatura gerada, que pode não ser exatamente a especificada na hora de início da transformação predefinida. Isto deve-se ao codificador, que tenta selecionar a melhor miniatura entre a hora de início e a posição Passo a partir da hora de início como o primeiro resultado. Uma vez que o valor predefinido é 10%, significa que, se o fluxo tiver uma duração longa, a primeira miniatura gerada poderá estar longe da especificada à hora de início. Tente selecionar um valor razoável para Passo se a primeira miniatura for esperada perto da hora de início ou defina o valor intervalo como 1 se apenas for necessária uma miniatura na hora de início. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
PngLayer
Descreve as definições para produzir uma imagem PNG a partir do vídeo de entrada.
Name | Tipo | Description |
---|---|---|
height |
string |
A altura do vídeo de saída para esta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de altura que a entrada. |
label |
string |
A etiqueta alfanumérica para esta camada, que pode ser utilizada no multiplexing de diferentes camadas de vídeo e áudio ou no nome do ficheiro de saída. |
width |
string |
A largura do vídeo de saída desta camada. O valor pode ser absoluto (em píxeis) ou relativo (em percentagem). Por exemplo, 50% significa que o vídeo de saída tem metade dos pixéis de largura que a entrada. |
PresetConfigurations
Um objeto de definições de configuração opcionais para codificador.
Name | Tipo | Description |
---|---|---|
complexity |
Permite-lhe configurar as definições do codificador para controlar o equilíbrio entre velocidade e qualidade. Exemplo: defina a Complexidade como Velocidade para codificação mais rápida, mas menos eficiência de compressão. |
|
interleaveOutput |
Define o modo de intercalação da saída para controlar a forma como o áudio e o vídeo são armazenados no formato de contentor. Exemplo: defina InterleavedOutput como NonInterleavedOutput para produzir saídas apenas de áudio e apenas vídeo em ficheiros MP4 separados. |
|
keyFrameIntervalInSeconds |
number |
O intervalo da moldura da chave em segundos. Exemplo: defina KeyFrameIntervalInSeconds como 2 para reduzir a memória intermédia de reprodução para alguns jogadores. |
maxBitrateBps |
integer |
A velocidade de transmissão máxima em bits por segundo (limiar para a camada de vídeo superior). Exemplo: defina MaxBitrateBps como 6000000 para evitar produzir saídas de velocidade de transmissão muito elevadas para conteúdos com elevada complexidade. |
maxHeight |
integer |
A altura máxima das camadas de vídeo de saída. Exemplo: defina MaxHeight como 720 para produzir camadas de saída até 720P, mesmo que a entrada seja 4K. |
maxLayers |
integer |
O número máximo de camadas de vídeo de saída. Exemplo: defina MaxLayers como 4 para garantir que, no máximo, são produzidas 4 camadas de saída para controlar o custo geral da tarefa de codificação. |
minBitrateBps |
integer |
A velocidade de transmissão mínima em bits por segundo (limiar para a camada de vídeo inferior). Exemplo: defina MinBitrateBps como 200000 para ter uma camada inferior que abrange utilizadores com largura de banda de rede baixa. |
minHeight |
integer |
A altura mínima das camadas de vídeo de saída. Exemplo: defina MinHeight como 360 para evitar camadas de saída de resoluções mais pequenas, como 180P. |
Priority
Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal.
Name | Tipo | Description |
---|---|---|
High |
string |
Utilizado para TransformOutputs que deve ter precedência sobre outras pessoas. |
Low |
string |
Utilizado para TransformOutputs que podem ser gerados após TransformOutputs de prioridade normal e alta. |
Normal |
string |
Utilizado para TransformOutputs que podem ser gerados na prioridade Normal. |
Rectangle
Descreve as propriedades de uma janela retangular aplicada ao suporte de dados de entrada antes de a processar.
Name | Tipo | Description |
---|---|---|
height |
string |
A altura da região retangular em píxeis. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%). |
left |
string |
O número de píxeis da margem esquerda. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%). |
top |
string |
O número de píxeis da margem superior. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%). |
width |
string |
A largura da região retangular em píxeis. Pode ser um valor de píxeis absoluto (por exemplo, 100) ou relativo ao tamanho do vídeo (por exemplo, 50%). |
Rotation
A rotação, se existir, a ser aplicada ao vídeo de entrada, antes de ser codificada. A predefinição é Automática
Name | Tipo | Description |
---|---|---|
Auto |
string |
Detetar e rodar automaticamente conforme necessário. |
None |
string |
Não rode o vídeo. Se o formato de saída o suportar, quaisquer metadados sobre a rotação são mantidos intactos. |
Rotate0 |
string |
Não rode o vídeo, mas remova quaisquer metadados sobre a rotação. |
Rotate180 |
string |
Rode 180 graus no sentido dos ponteiros do relógio. |
Rotate270 |
string |
Rode 270 graus no sentido dos ponteiros do relógio. |
Rotate90 |
string |
Rode 90 graus no sentido dos ponteiros do relógio. |
StandardEncoderPreset
Descreve todas as definições a utilizar ao codificar o vídeo de entrada com o Codificador Standard.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
codecs | Codec[]: |
A lista de codecs a utilizar ao codificar o vídeo de entrada. |
experimentalOptions |
object |
Dicionário que contém pares de valores chave para parâmetros não expostos no próprio predefinido |
filters |
Uma ou mais operações de filtragem que são aplicadas ao suporte de dados de entrada antes da codificação. |
|
formats | Format[]: |
A lista de saídas a produzir pelo codificador. |
StretchMode
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é o Dimensionamento Automático
Name | Tipo | Description |
---|---|---|
AutoFit |
string |
Preencho a saída (com caixa de correio ou pilar) para respeitar a resolução de saída, garantindo ao mesmo tempo que a região de vídeo ativa na saída tem a mesma proporção que a entrada. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, a saída será a 1280x1280, que contém um retângulo interno de 1280x720 na proporção de 16:9 e as regiões da caixa do pilar com 280 píxeis de largura à esquerda e à direita. |
AutoSize |
string |
Substitua a resolução de saída e altere-a para corresponder à proporção de apresentação da entrada, sem preenchimento. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, o valor na predefinição será substituído e o resultado será 1280x720, que mantém a proporção de entrada de 16:9. |
None |
string |
Respeite estritamente a resolução de saída sem considerar a proporção de píxeis ou apresentar a proporção do vídeo de entrada. |
systemData
Metadados relativos à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
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 as saídas pretendidas a partir de suportes de dados de entrada, como transcodificação ou extração de informações. Após a criação da Transformação, pode ser aplicada ao suporte de dados de entrada ao criar Tarefas.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties.created |
string |
A data e hora UTC em que a Transformação foi criada, no formato "YYYY-MM-DDThh:mm:ssZ". |
properties.description |
string |
Uma descrição verbosa opcional da Transformação. |
properties.lastModified |
string |
A data e hora UTC em que a Transformação foi atualizada pela última vez, no formato "YYYY-MM-DDThh:mm:ssZ". |
properties.outputs |
Uma matriz de um ou mais TransformOutputs que a Transformação deve gerar. |
|
systemData |
Os metadados do sistema relacionados com este recurso. |
|
type |
string |
O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
TransformOutput
Descreve as propriedades de um TransformOutput, que são as regras a aplicar ao gerar o resultado pretendido.
Name | Tipo | Description |
---|---|---|
onError |
Uma Transformação pode definir mais do que uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha: continue a produzir outras saídas ou pare as outras saídas. O estado geral da Tarefa não refletirá falhas de saídas especificadas com "ContinueJob". A predefinição é "StopProcessingJob". |
|
preset | Preset: |
Predefinição que descreve as operações que serão utilizadas para modificar, transcodificar ou extrair informações do ficheiro de origem para gerar a saída. |
relativePriority |
Define a prioridade relativa dos TransformOutputs numa Transformação. Isto define a prioridade que o serviço utiliza para o processamento de TransformOutputs. A prioridade predefinida é Normal. |
TransportStreamFormat
Descreve as propriedades para gerar um(s) MPEG-2 Transport Stream (ISO/IEC 13818-1) ficheiro(s) de vídeo de saída.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
filenamePattern |
string |
O padrão de nomenclatura de ficheiros utilizado para a criação de ficheiros de saída. As seguintes macros são suportadas no nome do ficheiro: {Basename} – uma macro de expansão que utilizará o nome do ficheiro de vídeo de entrada. Se o nome base (o sufixo do ficheiro não estiver incluído) do ficheiro de vídeo de entrada tiver menos de 32 carateres, será utilizado o nome base dos ficheiros de vídeo de entrada. Se o comprimento do nome base do ficheiro de vídeo de entrada exceder os 32 carateres, o nome base é truncado para os primeiros 32 carateres no comprimento total. {Extension} - A extensão adequada para este formato. {Label} - A etiqueta atribuída ao codec/camada. {Index} - Um índice exclusivo para miniaturas. Apenas aplicável a miniaturas. {AudioStream} - cadeia "Áudio" mais número de transmissão de áudio (a partir de 1). {Bitrate} - A velocidade de transmissão de áudio/vídeo em kbps. Não aplicável às miniaturas. {Codec} - O tipo de codec de áudio/vídeo. {Resolution} - A resolução de vídeo. Todas as macros sem título serão fechadas e removidas do nome de ficheiro. |
outputFiles |
A lista de ficheiros de saída a produzir. Cada entrada na lista é um conjunto de etiquetas de camada de áudio e vídeo a utilizar em conjunto. |
Video
Descreve as propriedades básicas para codificar o vídeo de entrada.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
keyFrameInterval |
string |
A distância entre duas molduras de chave. O valor deve não ser zero no intervalo [0,5, 20] segundos, especificado no formato ISO 8601. A predefinição é 2 segundos (PT2S). Tenha em atenção que esta definição é ignorada se VideoSyncMode.Passthrough estiver definido, em que o valor KeyFrameInterval seguirá a definição de origem de entrada. |
label |
string |
Uma etiqueta opcional para o codec. A etiqueta pode ser utilizada para controlar o comportamento de muxing. |
stretchMode |
O modo de redimensionamento – como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. Predefinição é Dimensionamento Automático |
|
syncMode |
O Modo de Sincronização de Vídeo |
VideoAnalyzerPreset
Uma predefinição do analisador de vídeo que extrai informações (metadados avançados) de áudio e vídeo e produz um ficheiro de formato JSON.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
audioLanguage |
string |
O idioma do payload de áudio na entrada com o formato BCP-47 de "language tag-region" (por exemplo, "en-US"). Se souber o idioma do seu conteúdo, recomenda-se que o especifique. O idioma tem de ser especificado explicitamente para AudioAnalysisMode::Basic, uma vez que a deteção automática de idiomas não está incluída no modo básico. Se o idioma não for especificado ou definido como nulo, a deteção automática de idiomas escolherá o primeiro idioma detetado e processará com o idioma selecionado durante a duração do ficheiro. Atualmente, não suporta alternar dinamicamente entre idiomas após a deteção do primeiro idioma. A deteção automática funciona melhor com gravações de áudio com voz claramente perceptível. Se a deteção automática não encontrar o idioma, a transcrição reverterá para "en-US". A lista de idiomas suportados está disponível aqui: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
Dicionário que contém pares de valores chave para parâmetros não expostos na própria predefinição |
insightsToExtract |
Define o tipo de informações que pretende que o serviço gere. Os valores permitidos são "AudioInsightsOnly", "VideoInsightsOnly" e "AllInsights". A predefinição é AllInsights. Se definir isto como AllInsights e a entrada for apenas áudio, só são geradas informações de áudio. Da mesma forma, se a entrada for apenas vídeo, só são geradas informações de vídeo. Recomenda-se que não utilize o AudioInsightsOnly se esperar que algumas das suas entradas sejam apenas vídeo; ou utilize o VideoInsightsOnly se espera que algumas das suas entradas sejam apenas áudio. As suas Tarefas nessas condições seriam esticá-lo. |
|
mode |
Determina o conjunto de operações de análise de áudio a executar. Se não for especificado, será escolhido o AudioAnalysisMode Padrão. |
VideoOverlay
Descreve as propriedades de uma sobreposição de vídeo.
Name | Tipo | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
O discriminador para tipos derivados. |
audioGainLevel |
number |
O nível de ganho de áudio na sobreposição. O valor deve estar no intervalo [0, 1,0]. A predefinição é 1.0. |
cropRectangle |
Uma janela retangular opcional utilizada para recortar a imagem ou vídeo sobreposto. |
|
end |
string |
A posição final, com referência ao vídeo de entrada, no qual a sobreposição termina. O valor deve estar no formato ISO 8601. Por exemplo, PT30S para terminar a sobreposição a 30 segundos no vídeo de entrada. Se não for especificado ou o valor for maior do que a duração do vídeo de entrada, a sobreposição será aplicada até ao fim do vídeo de entrada se a duração do suporte de dados de sobreposição for maior do que a duração do vídeo de entrada, caso contrário, a sobreposição irá durar até à duração do suporte de dados de sobreposição. |
fadeInDuration |
string |
A duração sobre a qual a sobreposição se desvanece no vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S). |
fadeOutDuration |
string |
A duração sobre a qual a sobreposição desaparece do vídeo de entrada. O valor deve estar no formato de duração ISO 8601. Se não for especificado, o comportamento predefinido é não desaparecer gradualmente (o mesmo que PT0S). |
inputLabel |
string |
A etiqueta da entrada da tarefa que deve ser utilizada como uma sobreposição. A Entrada tem de especificar exatamente um ficheiro. Pode especificar um ficheiro de imagem no formato JPG, PNG, GIF ou BMP ou um ficheiro de áudio (como um ficheiro WAV, MP3, WMA ou M4A) ou um ficheiro de vídeo. Veja https://aka.ms/mesformats para obter a lista completa dos formatos de ficheiro de áudio e vídeo suportados. |
opacity |
number |
A opacidade da sobreposição. Este é um valor no intervalo [0 - 1.0]. A predefinição é 1,0, o que significa que a sobreposição é opaca. |
position |
A localização no vídeo de entrada onde a sobreposição é aplicada. |
|
start |
string |
A posição de início, com referência ao vídeo de entrada, no qual a sobreposição é iniciada. O valor deve estar no formato ISO 8601. Por exemplo, PT05S para iniciar a sobreposição a 5 segundos no vídeo de entrada. Se não for especificada, a sobreposição começa a partir do início do vídeo de entrada. |
VideoSyncMode
Modo de Sincronização de Vídeo
Name | Tipo | Description |
---|---|---|
Auto |
string |
Este é o método predefinido. Escolhe entre Cfr e Vfr consoante as capacidades do muxer. Para o formato de saída MP4, o modo predefinido é Cfr. |
Cfr |
string |
Os fotogramas de entrada serão repetidos e/ou removidos conforme necessário para alcançar exatamente a taxa de fotogramas constante pedida. Recomendado quando a taxa de fotogramas de saída é explicitamente definida com um valor especificado |
Passthrough |
string |
Os carimbos de data/hora da apresentação em frames são transmitidos do ficheiro de entrada para o escritor de ficheiros de saída. Recomendado quando a origem de entrada tem uma taxa de fotogramas variável e está a tentar produzir várias camadas para transmissão em fluxo adaptável na saída que têm limites GOP alinhados. Nota: se dois ou mais fotogramas na entrada tiverem carimbos de data/hora duplicados, o resultado também terá o mesmo comportamento |
Vfr |
string |
Semelhante ao modo Passthrough, mas se a entrada tiver fotogramas com carimbos de data/hora duplicados, apenas uma moldura é transmitida para a saída e outras são removidas. Recomendado quando se espera que o número de fotogramas de saída seja igual ao número de fotogramas de entrada. Por exemplo, o resultado é utilizado para calcular uma métrica de qualidade como PSNR em relação à entrada |