ApsaraVideo VOD:Tipos de dados básicos

Nome

Tipo

Descrição

VideoId

String

O ID do áudio ou vídeo.

Title

String

O título do áudio ou vídeo.

Description

String

A descrição do áudio ou vídeo.

Duration

Float

A duração do áudio ou vídeo. Unidade: segundos.

CoverURL

String

A URL da miniatura do áudio ou vídeo.

Status

String

O status do áudio ou vídeo. Para obter mais informações, consulte Status: o status de um arquivo de áudio ou vídeo.

CreationTime

String

O horário de criação do áudio ou vídeo. O horário deve estar no formato UTC.

Size

Long

O tamanho do arquivo source. Unidade: bytes.

Snapshots

String[]

As URLs dos snapshots do vídeo.

CateId

Long

O ID da categoria do áudio ou vídeo.

CateName

String

O nome da categoria do áudio ou vídeo.

Tags

String

As tags do áudio ou vídeo. Separe várias tags com vírgulas (,).

TemplateGroupId

String

O ID do grupo de modelos de transcodificação usado para transcodificar arquivos de áudio ou vídeo.

StorageLocation

String

O endereço de armazenamento do arquivo de áudio ou vídeo.

AppId

String

O ID do aplicativo.

Valor

Descrição

Observações

Uploading

Enviando

• Este é o status inicial de um arquivo de áudio ou vídeo e indica que o envio está em andamento. Caso seus arquivos permaneçam nesse status por muito tempo, consulte as possíveis causas e soluções descritas em Perguntas frequentes sobre envio de ativos de mídia.

• Apenas operações de exclusão são permitidas para arquivos neste status. Você não pode executar outras operações, como transcodificação, corte de vídeo ou revisão de ativos de mídia, em arquivos que estão sendo enviados.

UploadFail

Falha no envio

• Problemas de rede ou corrupção do arquivo source podem causar falhas no envio. Tente enviar novamente ou utilize um arquivo source diferente.

• Ao usar o envio retomável, este status não aparece, pois é impossível determinar se o envio falhou.

• Somente operações de exclusão são permitidas para arquivos neste status. Você não pode realizar outras operações, como transcodificação, corte de vídeo ou revisão de ativos de mídia, em arquivos cujo envio falhou.

UploadSucc

Envio concluído

• Se o processo padrão de transcodificação for ignorado durante o envio devido ao design do negócio ou outros motivos, impedindo a geração de streams de reprodução válidos, ou se for utilizado um grupo de modelos sem transcodificação e o arquivo source não estiver nos formatos MP4, FLV, M3U8, MP3 ou WEBM, o vídeo será marcado como Envio concluído. Após uma transcodificação subsequente gerar streams de reprodução válidos, o vídeo mudará para o status Normal.

• É possível executar operações como transcodificação, corte de vídeo e revisão de ativos de mídia em arquivos com este status.

Transcoding

Transcodificando

Arquivos de mídia neste status estão sendo transcodificados. Se um vídeo estiver passando pela transcodificação inicial, não haverá streams de reprodução válidos disponíveis e não será possível chamar operações de API para obter URLs de reprodução. Utilize as notificações de evento Single Definition Transcoding Complete ou Transcode complete para verificar o status da transcodificação.

TranscodeFail

Falha na transcodificação

Erros no arquivo source geralmente causam falhas na transcodificação. Obtenha a mensagem de erro através da notificação de evento Single Definition Transcoding Complete ou Transcode complete. Para saber mais sobre como solucionar falhas de transcodificação, consulte Perguntas frequentes sobre transcodificação.

Checking

Em revisão

• Caso você ative a opção Review Before Publish no ApsaraVideo VOD console > Review Management > Review Settings, os arquivos de áudio ou vídeo entrarão automaticamente no fluxo de revisão após a transcodificação bem-sucedida. O status do arquivo será então marcado como Em revisão. Inicie uma revisão manual; caso contrário, o arquivo permanecerá no status Em revisão.

• A reprodução de arquivos neste status só é possível via ApsaraVideo VOD console ou usando endereços IP de segurança para revisão. Não é possível chamar operações de API ou usar SDKs para obter URLs de reprodução de arquivos neste status. No entanto, URLs de reprodução válidas que já sejam publicamente acessíveis ainda funcionarão normalmente.

• Você pode executar operações como transcodificação e corte de vídeo em arquivos com este status.

Blocked

Bloqueado

• Áudios ou vídeos neste estado só podem ser reproduzidos no ApsaraVideo VOD console ou a partir de endereços IP na lista de permissões para revisão. Não é possível usar uma API ou SDK para obter a URL de reprodução. Contudo, URLs de reprodução válidas que já tenham sido expostas ainda podem ser reproduzidas normalmente.

• Apenas operações de exclusão são permitidas para arquivos neste status. Não é possível executar outras operações, como transcodificação, corte de vídeo ou revisão de ativos de mídia, em arquivos bloqueados.

Normal

Normal

• O arquivo de áudio ou vídeo estará no status Normal se existir pelo menos um stream de reprodução válido.

• Todas as operações estão disponíveis para arquivos neste status, incluindo transcodificação, corte de vídeo, revisão de ativos de mídia e reprodução.

ProduceFail

Falha na síntese

Indica que a produção do corte de vídeo falhou. Ao utilizar a edição online do ApsaraVideo VOD para produzir cortes de vídeo, certifique-se de que todos os ativos de mídia usados estejam no status Normal. Caso contrário, a produção do vídeo poderá falhar.

Nome

Tipo

Descrição

ImageId

String

O ID da imagem.

URL

String

A URL da imagem. Se um nome de domínio acelerado estiver configurado, uma URL de CDN será retornada. Caso contrário, uma URL do Object Storage Service (OSS) será retornada.

Title

String

O título da imagem.

Tags

String

As tags da imagem.

ImageType

String

O tipo da imagem.

CateId

Long

O ID da categoria.

CateName

String

O nome da categoria.

Description

String

Descrição.

StorageLocation

String

Endereço de armazenamento.

Mezzanine

Mezzanine

As informações source da imagem.

CreationTime

String

O horário de criação da imagem. O horário está no formato UTC.

Status

String

O status da imagem. Para obter mais informações, consulte Status: o status de uma imagem.

AppId

String

O ID do aplicativo.

Valor

Descrição

Observações

Uploading

Enviando

Este é o status inicial da imagem, indicando que ela está sendo enviada. Se suas imagens permanecerem neste status por um longo período, consulte Por que meus arquivos enviados ficam sempre no status Uploading?.

UploadFail

Falha no envio da imagem.

Problemas de rede ou corrupção do arquivo source podem causar falhas no envio. Tente novamente ou envie um arquivo source diferente.

Normal

Normal

Envio da imagem bem-sucedido.

Nome

Tipo

Descrição

MediaId

String

O ID do ativo de mídia auxiliar.

URL

String

A URL do ativo de mídia auxiliar. Se um nome de domínio para CDN for especificado, uma URL de CDN será retornada. Caso contrário, uma URL do OSS será retornada.

Title

String

Título.

Tags

String

Tag.

Type

String

O tipo do ativo de mídia auxiliar.

Categories

Category[]

As categorias.

Description

String

Descrição

StorageLocation

String

Endereço de armazenamento.

CreationTime

String

O horário de criação do ativo de mídia auxiliar. O horário deve estar no formato UTC.

ModificationTime

String

O horário da última modificação do ativo de mídia auxiliar. O horário deve estar no formato UTC.

Status

String

O status do ativo de mídia auxiliar. Para obter mais informações, consulte Status: Status de ativo de mídia auxiliar.

AppId

String

O ID do aplicativo.

Valor

Descrição

Explicação

Uploading

Enviando

Status inicial. O ativo de mídia auxiliar está sendo enviado.

Normal

Normal

O ativo de mídia auxiliar foi enviado com sucesso.

UploadFail

Falha

Falha no envio do ativo de mídia auxiliar.

Nome

Tipo

Descrição

VideoId

String

O ID do vídeo.

FileName

String

O nome do arquivo.

Duration

String

A duração do arquivo em segundos.

Status

String

O status do arquivo source. Para obter mais informações, consulte Status: Status de um arquivo source de áudio ou vídeo.

CreationTime

String

O horário de criação do arquivo. O horário está no formato UTC.

Height

Long

A altura do arquivo em pixels (px).

Width

Long

A largura do arquivo em pixels (px).

Fps

String

A taxa de quadros do arquivo em quadros por segundo (fps).

FileURL

String

A URL do arquivo.

Bitrate

String

A taxa de bits do arquivo em Kbps.

Size

Long

O tamanho do arquivo em bytes.

OutputType

String

O tipo do arquivo de saída. Valores válidos:

• oss: a URL do servidor de origem.

• cdn: a URL acelerada.

VideoStreamList

VideoStream[]

Uma lista de informações de stream de vídeo.

AudioStreamList

AudioStream[]

Uma lista de informações de stream de áudio.

Nome

Tipo

Descrição

Index

String

O número ordinal do stream de vídeo. Identifica a posição do stream de vídeo no stream de mídia.

CodecName

String

O nome curto do formato de codificação.

CodecLongName

String

O nome longo do formato de codificação.

Profile

String

O perfil do codec.

CodecTimeBase

String

A base de tempo do codec.

CodecTagString

String

O texto da tag do formato de codificação.

CodecTag

String

A tag do formato de codificação.

Width

Long

A largura da resolução do vídeo.

Height

Long

A altura da resolução do vídeo.

HasBFrames

String

Indica se o stream possui B-frames.

Sar

String

Taxa de proporção da amostra do sinal codificado.

Dar

String

A taxa de proporção de exibição (DAR).

PixFmt

String

O formato de pixel.

Level

String

O nível de codificação.

Fps

String

A taxa de quadros alvo.

AvgFPS

String

A taxa média de quadros.

Timebase

String

A base de tempo.

StartTime

String

O horário de início.

Duration

String

A duração.

NumFrames

String

O número total de quadros.

Lang

String

O idioma.

Rotate

String

O ângulo de rotação do vídeo. O valor deve estar no intervalo [0, 360).

Nome

Tipo

Descrição

Index

String

O número ordinal do stream de áudio. Identifica a posição do stream de áudio no stream de mídia.

CodecName

String

O nome curto do formato de codificação.

CodecLongName

String

O nome longo do formato de codificação.

CodecTimeBase

String

A base de tempo do codec.

CodecTagString

String

O texto da tag do formato de codificação.

CodecTag

String

A tag do formato de codificação.

SampleFmt

String

O formato de amostragem.

SampleRate

String

A taxa de amostragem.

Channels

String

O número de canais de som.

ChannelLayout

String

O layout dos canais de som.

Timebase

String

A base de tempo.

StartTime

String

O horário de início.

Duration

String

A duração.

Bitrate

String

A taxa de bits.

NumFrames

String

O número total de quadros.

Lang

String

O idioma.

Valor

Descrição

Observações

Uploading

Enviando

Estado inicial do arquivo. Indica que o arquivo está sendo enviado.

Normal

Normal

O arquivo foi enviado com sucesso.

UploadFail

Falha

Falha no envio do arquivo.

Deleted

Excluído

O arquivo foi excluído.

Nome

Tipo

Descrição

FileURL

String

A URL do OSS da imagem.

OriginalFileName

String

O nome do arquivo enviado.

FileSize

Long

O tamanho do arquivo em bytes.

Width

Integer

A largura da imagem em pixels (px).

Height

Integer

A altura da imagem em pixels (px).

Nome

Tipo

Descrição

JobId

String

O ID do trabalho de envio.

UploadURL

String

A URL do arquivo a ser enviado.

MediaId

String

O ID do arquivo a ser enviado.

FileSize

String

O tamanho do arquivo a ser enviado. Unidade: bytes.

Status

String

O status do trabalho de envio baseado em URL. Para obter mais informações sobre este parâmetro, consulte Status: o status de um trabalho de envio baseado em URL.

CreationTime

String

O horário de criação do trabalho.

CompleteTime

Long

O horário de conclusão do trabalho.

UserData

String

Um campo definido pelo usuário.

ErrorCode

String

Código de erro

ErrorMessage

String

Mensagem de erro.

Valor

Descrição

PENDING

O trabalho de envio foi submetido e aguarda processamento.

PROCESSING

O processamento da tarefa pode ser iniciado.

DOWNLOADING

O arquivo está sendo baixado.

DOWNLOAD_SUCCESS

O download do arquivo foi concluído.

DOWNLOAD_FAIL

Falha no download do arquivo.

UPLOADING

O arquivo está sendo enviado.

UPLOAD_SUCCESS

O envio do arquivo foi concluído.

UPLOAD_FAIL

Falha no envio do arquivo.

SUCCESS

O trabalho de envio foi bem-sucedido e o callback foi concluído.

Nome

Tipo

Descrição

VideoId

String

ID do vídeo

Title

String

Título do vídeo

Duration

String

A duração do vídeo em segundos.

CoverURL

String

Miniatura do vídeo.

Status

String

O status do arquivo de vídeo ou áudio.

CreationTime

String

O horário de criação do arquivo de vídeo ou áudio. O horário está no formato UTC.

MediaType

MediaType

O tipo do arquivo de mídia. Valores válidos:

• Vídeo.

• audio: um arquivo apenas de áudio.

Nome

Tipo

Descrição

Bitrate

String

A taxa de bits do stream de mídia, em Kbps.

Definition

String

A definição do stream de mídia. Valores válidos:

• FD: baixa definição

• LD: definição padrão

• SD: alta definição

• Alta Definição (HD).

• OD: qualidade original

• 2K: 2K

• 4K: 4K

Specification

String

As especificações de saída para transcodificação de vídeo e áudio. Para obter mais informações, consulte Especificações de saída.

Duration

String

A duração do stream de mídia, em segundos.

Encrypt

Long

Indica se o stream de mídia é criptografado. Valores válidos:

• 0: Não.

• 1: Sim.

EncryptType

String

O tipo de criptografia do stream de mídia. Valores válidos:

• AliyunVoDEncryption: Criptografia de Vídeo da Alibaba Cloud (criptografia privada).

• HLSEncryption: Criptografia HLS.

PlayURL

String

A URL de reprodução do stream de mídia.

Format

String

O formato do stream de mídia.

Se o arquivo de mídia for um vídeo, os valores válidos são:

• mp4

• m3u8

Se o arquivo de mídia contiver apenas áudio, o valor válido é mp3.

Fps

String

A taxa de quadros do stream de mídia, em quadros por segundo (fps).

Size

Long

O tamanho do stream de mídia, em bytes.

Width

Long

A largura do stream de mídia, em pixels (px).

Height

Long

A altura do stream de mídia, em pixels (px).

StreamType

String

O tipo do stream de mídia.

• Se o stream de mídia for vídeo, o valor é video.

• Se o stream de mídia contiver apenas áudio, o valor é audio.

JobId

String

O ID do trabalho de transcodificação do stream de mídia. Este ID é o identificador exclusivo do stream de mídia.

WatermarkId

String

O ID da marca d'água associada ao stream de mídia.

Status

String

O status do stream de mídia. Valores válidos:

• Normal: O status do stream de transcodificação concluído mais recente para cada definição e formato.

• Invisible: O status para streams redundantes. Quando vários streams são transcodificados para a mesma definição e formato, o stream mais recente é marcado como Normal e os demais são marcados como Invisible.

NarrowBandType

String

O tipo de Narrowband HD. Valores válidos:

• 0: regular

• 1.0: Narrowband HD 1.0

• 2.0: Narrowband HD 2.0

Este parâmetro entra em vigor apenas quando uma definição do modelo de transcodificação integrado Narrowband HD 1.0 estiver configurada. Para obter mais informações, consulte TranscodeTemplate: Configurações de modelo de transcodificação.

CreationTime

String

O horário de criação do stream. O horário está no formato UTC.

ModificationTime

String

O horário da última atualização do stream. O horário está no formato UTC.

Nome

Tipo

Descrição

VideoId

String

O ID do vídeo.

Title

String

O título do vídeo.

Duration

Float

A duração do vídeo, em segundos.

CoverURL

String

Miniatura do vídeo.

Status

String

O status do vídeo.

Nome

Tipo

Descrição

MediaId

String

O ID do ativo de mídia.

CreationTime

String

O horário de criação do ativo de mídia. O horário deve estar no formato UTC.

MediaType

String

O tipo do ativo de mídia. Valores válidos:

• video: vídeo

• audio: áudio

• Image: Uma imagem.

• attached: ativo de mídia auxiliar

Video

Video

As informações sobre o vídeo.

Audio

Audio

As informações sobre o áudio.

Image

Image

As informações sobre a imagem.

AttachedMedia

AttachedMedia

As informações sobre o ativo de mídia auxiliar.

Nome

Tipo

Descrição

CateId

Long

O ID da categoria.

CateName

String

O nome da categoria. O valor pode ter até 64 bytes de comprimento e deve ser codificado no formato UTF-8.

ParentId

Long

O ID da categoria pai. O ID da categoria pai de uma categoria de nível 1 é -1.

Level

Long

O nível da categoria. Um valor de 0 indica uma categoria de nível 1.

Nome

Tipo

Descrição

StreamName

String

O nome do stream ao vivo.

DomainName

String

O nome do domínio.

AppName

String

O nome do aplicativo.

PlaylistId

String

O ID da lista de reprodução.

RecordStartTime

String

O horário de início da gravação.

RecordEndTime

String

O horário de término da gravação.

Video

Video

As informações do vídeo.

Nome

Tipo

Descrição

ProjectId

String

O ID do projeto de edição online.

Title

String

O título do projeto de edição online.

CreationTime

String

O momento de criação do projeto de edição online. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.

Por exemplo, o valor 2017-01-11T12:00:00Z corresponde às 20:00:00 de 11 de janeiro de 2017 no horário de Pequim (UTC+8).

ModifiedTime

String

A última modificação do projeto de edição online. O horário está em UTC, no formato yyyy-MM-ddTHH:mm:ssZ.

Por exemplo, 2017-01-11T12:00:00Z (que equivale a 20:00:00 de 11 de janeiro de 2017, UTC+8).

Status

String

O status do projeto de edição online.

Description

String

A descrição do projeto de edição online.

Timeline

String

A timeline do projeto de edição online. O valor é uma string JSON.

Duration

String

A duração total do projeto de edição online. Deve ser igual à duração total da timeline.

CoverURL

String

A URL da miniatura do projeto de edição online.

Valor

Descrição

Observações

Normal

Rascunho

Status inicial de um projeto de edição online.

Producing

Renderização

Nenhuma.

Produced

Produção de vídeo concluída com sucesso.

Nenhuma.

ProduceFailed

Falha na síntese.

Nenhuma.

Nome

Tipo

Descrição

MaterialId

String

O ID do material.

Title

String

O título do material.

Description

String

Descrição do material.

Duration

Float

A duração do material em segundos. O valor tem precisão de quatro casas decimais.

CoverURL

String

A URL da miniatura do material.

Status

String

Status do material.

CreationTime

String

O momento de criação do material. O horário é exibido em UTC.

Size

Long

O tamanho do arquivo source em bytes.

CateId

Long

O ID da categoria do material.

CateName

String

O nome da categoria do material.

Tags

String

Tags do material. Separe múltiplas tags com vírgula (,).

Snapshots

String[]

Um array de URLs de snapshots do material.

Sprites

String[]

Um array de URLs de sprites do material.

Nome

Tipo

Descrição

TemplateGroupId

String

O ID do grupo de modelos de transcodificação usado para transcodificar os arquivos de vídeo produzidos. Os vídeos produzidos servem como arquivos source para a transcodificação. Esse processo é semelhante à transcodificação executada após a conclusão do upload de um arquivo.

Este campo é opcional. Se estiver vazio, o sistema usa o grupo de modelos padrão das configurações de transcodificação. Se especificado, o grupo de modelos informado será utilizado. Para visualizar o ID do grupo de modelos, acesse Transcoding Settings no console do ApsaraVideo VOD.

TemplateId

String

O ID do modelo de composição usado na composição de vídeo para gerar arquivos source de recursos de mídia. Este campo é opcional. Se o valor estiver vazio, o modelo de edição online integrado será usado para a composição.

Caso o alvo da composição seja um arquivo de vídeo, o formato de codificação do modelo integrado é H.264 e o formato de contêiner é MP4.

Se você tiver outros requisitos para especificar parâmetros de composição (como composição de imagens animadas, legendagem inteligente, edição rápida M3U8 ou suporte a parâmetros de composição personalizados), envie um ticket para solicitar.

Width

Integer

A largura do vídeo de saída, em pixels.

Parâmetro opcional. Por padrão, a resolução do vídeo de saída é definida usando a largura máxima e a altura máxima de todos os arquivos source na timeline.

Por exemplo, se uma timeline contiver três arquivos source com resoluções de 1280 × 720 pixels, 1920 × 1080 pixels e 720 × 1280 pixels, a resolução do vídeo de saída será de 1920 × 1280 pixels.

Height

Integer

A altura do vídeo de saída, em pixels.

Parâmetro opcional. Por padrão, a resolução de saída é definida usando a largura máxima e a altura máxima de todos os arquivos source na timeline.

Por exemplo, se uma timeline usar três arquivos source com resoluções de 1280×720, 1920×1080 e 720×1280, a resolução do vídeo de saída será 1920×1280.

Bitrate

Integer

A taxa de bits do vídeo produzido. Unidade: Kbit/s.

Parâmetro opcional. O valor padrão é a taxa de bits máxima dos arquivos source que você especificou na Timeline.

Por exemplo, se você especificar três materiais para a Timeline e as taxas de bits dos arquivos source forem 400, 600 e 800 Kbit/s, a taxa de bits padrão do vídeo produzido será 800 Kbit/s.

StorageLocation

String

O endereço de armazenamento do arquivo. Este parâmetro é obrigatório para regiões fora de China (Shanghai).

Nome

Tipo

Descrição

Title

String

O título do vídeo produzido. O valor pode ter até 128 bytes e deve estar codificado em UTF-8.

Description

String

A descrição do vídeo produzido. O valor pode ter até 1.024 bytes e deve estar codificado em UTF-8.

CoverURL

String

A URL da miniatura personalizada do vídeo produzido.

CateId

String

O ID da categoria do vídeo produzido. Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Configuration Management > Media Management > Categories.

Tags

String

As tags do vídeo produzido. Cada nome de tag pode ter até 32 bytes. É possível especificar no máximo 16 tags. Separe múltiplas tags com vírgulas (,). A string deve estar codificada no formato UTF-8.

Nome

Tipo

Obrigatório

Descrição

VideoTracks

VideoTrack[]

Não. Se VideoTracks estiver vazio, AudioTracks não deve estar vazio.

Lista de faixas de vídeo. A ordem de empilhamento de múltiplas faixas segue a ordem dos elementos do array. Por exemplo, a camada do primeiro elemento do array aparece na parte inferior, a camada do segundo elemento aparece acima dela, e assim por diante.

AudioTracks

AudioTrack[]

Não. Se AudioTracks estiver vazio, VideoTracks não deve estar vazio.

Lista de faixas de áudio.

SubtitleTracks

SubtitleTrack[]

Não

Lista de faixas de legendas.

EffectTracks

EffectTrack[]

Não

Lista de faixas de efeitos.

Nome

Tipo

Obrigatório

Descrição

Type

String

Não

O padrão é uma faixa de vídeo standard.

Quando Type=Effect, a faixa atual funciona como uma faixa de efeitos. Nesse caso, VideoTrackClips pode conter EffectTrackItem.

MainTrack

Boolean

Não

Especifica se a faixa atual é a faixa principal. O padrão é False.

VideoTrackClips

VideoTrackClip[]

Sim

Lista de clipes de mídia da faixa de vídeo.

Nome

Tipo

Obrigatório

Descrição

MainTrack

Boolean

Não

Especifica se a faixa atual é a faixa principal. O padrão é False.

AudioTrackClips

AudioTrackClip[]

Sim

Lista de clipes de mídia da faixa de áudio.

Nome

Tipo

Obrigatório

Descrição

SubtitleTrackClips

SubtitleTrackClip[]

Sim

Lista de clipes de mídia da faixa de legendas.

Nome

Tipo

Obrigatório

Descrição

EffectTrackItems

EffectTrackItem[]

Sim

Lista de itens da faixa de efeitos.

Nome

Tipo

Obrigatório

Descrição

MediaId

String

Não

ID de mídia do clipe da faixa de vídeo. Em alguns contextos, também é chamado de VideoId (para vídeo/áudio) ou ImageId (para imagens).

Type

String

Não

Tipo do clipe de mídia. O padrão é Video.

Valores válidos:

• Video

• Image

• GlobalImage (imagem global; a duração assume como padrão a maior duração da faixa de vídeo.)

Exemplo: Usar GlobalImage em uma faixa de vídeo

X

Float

Não

Distância horizontal do canto superior esquerdo da imagem ou vídeo até o canto superior esquerdo do vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da largura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Y

Float

Não

Distância vertical do canto superior esquerdo da imagem ou vídeo até o canto superior esquerdo do vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da altura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Width

Float

Não

Largura da imagem no vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da largura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Height

Float

Não

Altura da imagem no vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da altura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

AdaptMode

String

Não

Modo de dimensionamento de vídeo. O padrão é Fill. Este modo só entra em vigor quando Width e Height são definidos para a faixa de vídeo. Nesse caso, Width e Height definem as dimensões da área alvo, e o vídeo é dimensionado adaptativamente dentro dessa área.

• Contain: Dimensiona o conteúdo para caber na área alvo preservando sua proporção.

• Cover: Preenche toda a área alvo preservando a proporção. O conteúdo pode ser cortado se as proporções não coincidirem.

• Fill: Estica o conteúdo para preencher exatamente a área alvo. A proporção não é preservada.

In

Float

Não

Tempo inicial do clipe em relação à mídia de origem. Aplica-se apenas a fontes de áudio/vídeo. Unidade: segundos, com precisão de quatro casas decimais. O padrão é 0 se não for especificado.

Out

Float

Não

Tempo final do clipe em relação à mídia de origem. Aplica-se apenas a fontes de áudio/vídeo. Unidade: segundos, com precisão de quatro casas decimais. Assume a duração total da origem como padrão se não for especificado.

MaxOut

Float

Não

Tempo final máximo do clipe em relação à mídia de origem. Se definido, o ponto Out real torna-se o menor valor entre a duração da origem ou MaxOut. Aplica-se apenas a fontes de áudio/vídeo. Unidade: segundos, com precisão de quatro casas decimais. Se Out for especificado, MaxOut será ignorado.

Exemplo: Definir MaxOut em uma faixa de vídeo

Duration

Float

Não

Duração do clipe. Geralmente usado para fontes de imagem. Unidade: segundos, com precisão de quatro casas decimais.

DyncFrames

Int

Não

Taxa de quadros para imagens animadas. Aplica-se apenas quando a origem é uma imagem animada.

Exemplo: Usar adesivos GIF

TimelineIn

Float

Não

Tempo inicial do clipe na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineIn é calculado automaticamente com base no posicionamento sequencial.

TimelineOut

Float

Não

Tempo final do clipe na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineOut é calculado automaticamente com base no posicionamento sequencial.

Speed

Float

Não

Velocidade de reprodução do clipe de vídeo. Intervalo válido: 0,1–100. Por exemplo, Speed=2 reproduz o clipe em velocidade dupla, reduzindo pela metade sua Duration na saída final.

Exemplo: Ajustar velocidade de áudio/vídeo

MaskVideoUrl

String

Não

URL do vídeo de máscara. Geralmente é um vídeo com canal alfa, usado para adicionar efeitos de transparência ao vídeo original.

Apenas URLs públicas do OSS são suportadas.

Effects

Effect[]

Não

Lista de efeitos aplicados ao clipe.

Nome

Tipo

Obrigatório

Descrição

MediaId

String

Não

ID de mídia do clipe da faixa de áudio.

In

Float

Não

Tempo inicial do clipe em relação à mídia de origem. Unidade: segundos, com precisão de quatro casas decimais. O padrão é 0 se não for especificado.

Out

Float

Não

Tempo final do clipe em relação à mídia de origem. Unidade: segundos, com precisão de quatro casas decimais. Assume a duração total da origem como padrão se não for especificado.

TimelineIn

Float

Não

Tempo inicial do clipe na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineIn é calculado automaticamente com base no posicionamento sequencial.

TimelineOut

Float

Não

Tempo final do clipe na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineOut é calculado automaticamente com base no posicionamento sequencial.

Speed

Float

Não

Velocidade de reprodução do clipe de áudio. Intervalo válido: 0,1–100. Por exemplo, Speed=2 reproduz o clipe em velocidade dupla, reduzindo pela metade sua Duration na saída final.

Exemplo: Ajustar velocidade de áudio/vídeo

Effects

Effect[]

Não

Lista de efeitos aplicados ao clipe.

LoopMode

Boolean

Não

Comportamento de reprodução em loop do clipe na timeline. True ativa a reprodução em loop. False (padrão) desativa o loop.

Exemplo: Reprodução de áudio em loop

Nome

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo de mídia da legenda. Valores válidos:

• Subtitle: arquivo externo de legenda

• Text: texto de banner

SubType

String

Não

Subtipo de mídia da legenda. Valores válidos:

• srt: legenda SRT externa

• ass: legenda ASS externa

Ignore este campo quando Type for Text.

FileURL

String

Não

URL do OSS do arquivo de legenda. Obrigatório quando Type for Subtitle. Formato:

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt

Exemplo: Editar diretamente usando um arquivo de legenda

X

Float

Não

Quando Type for Text, distância horizontal do canto superior esquerdo do texto até o canto superior esquerdo do vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da largura do vídeo de saída. Um número inteiro >=2 representa pixels absolutos.

Y

Float

Não

Quando Type for Text, distância vertical do canto superior esquerdo do texto até o canto superior esquerdo do vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da altura do vídeo de saída. Um número inteiro >=2 representa pixels absolutos.

TimelineIn

Float

Não

Quando Type for Text, tempo inicial do texto na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineIn é calculado automaticamente com base no posicionamento sequencial.

TimelineOut

Float

Não

Quando Type for Text, tempo final do texto na timeline. Unidade: segundos, com precisão de quatro casas decimais. Se não for especificado, TimelineOut é calculado automaticamente com base no posicionamento sequencial.

Content

String

Não

Quando Type for Text, obrigatório. Especifica o conteúdo do texto.

Font

String

Não

Quando Type for Text, especifica a fonte. O padrão é SimSun. Para a lista completa de fontes suportadas, consulte Lista de fontes.

FontSize

Int

Não

Quando o tipo de legenda for texto de banner, especifica o tamanho da fonte.

FontColor

String

Não

Quando Type for Text, especifica a cor da fonte em formato hexadecimal (# seguido de dígitos hexadecimais). Exemplo: #ffffff.

FontColorOpacity

String

Não

Quando Type for Text, especifica a transparência da fonte. Intervalo válido: 0–1. O padrão é 1 (opaco). 0 significa totalmente transparente.

FontFace

FontFace

Não

Quando Type for Text, especifica o estilo da fonte.

Spacing

Int

Não

Quando Type for Text, especifica o espaçamento entre caracteres. Unidade: pixels. O padrão é 0.

Angle

Float

Não

Quando Type for Text, especifica o ângulo de rotação anti-horário. Unidade: graus. O padrão é 0.

BorderStyle

Int

Não

Especifica o estilo de borda e sombra para texto de banner. Valores válidos: 1 ou 3. 1 = borda + sombra. 3 = caixa de fundo opaca. O padrão é 1.

Outline

Int

Não

Quando Type for Text, especifica a largura do traço. Unidade: pixels. O padrão é 0.

OutlineColour

String

Não

Quando Type for Text, especifica a cor do traço em formato hexadecimal (# seguido de dígitos hexadecimais). Exemplo: #ffffff.

Shadow

Int

Não

Quando Type for Text, especifica a profundidade da sombra. Unidade: pixels. O padrão é 0.

BackColour

String

Não

Quando Type for Text, especifica a cor da sombra em formato hexadecimal (# seguido de dígitos hexadecimais). Exemplo: #ffffff.

Alignment

String

Não

Quando Type for Text, especifica o alinhamento do texto. O padrão é TopLeft. Valores válidos:

• TopLeft: canto superior esquerdo do vídeo

• TopCenter: centro superior ao longo do eixo vertical

• TopRight: canto superior direito do vídeo

• CenterLeft: lado esquerdo do eixo central horizontal do vídeo

• CenterCenter: centro do vídeo

• CenterRight: centro direito ao longo do eixo horizontal

• BottomLeft: canto inferior esquerdo do vídeo

• BottomCenter: centro inferior ao longo do eixo vertical

• BottomRight: canto inferior direito do vídeo

AdaptMode

String

Não

Especifica como o texto de banner se adapta quando excede a largura do vídeo ou a TextWidth especificada. Valores válidos:

• AutoWrap: quebra linhas automaticamente

• AutoScale: Auto Scaling

• AutoWrapAtSpaces: quebra apenas nos caracteres de espaço (ideal para legendas somente em inglês)

TextWidth

Integer

Não

Largura da caixa de texto da legenda. Entra em vigor apenas quando AdaptMode estiver definido. A quebra automática de linha ou o dimensionamento usam esta largura. Se não for especificado, a largura do vídeo será usada. Unidade: pixels.

FontUrl

String

Não

Quando Type for Text, aceita arquivos de fonte personalizados do seu bucket do OSS. Formatos suportados: ttf, otf, woff. Exemplo: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

Não

Quando Type for Text, especifica o estilo de word art.

Para estilos e efeitos de word art, consulte Exemplos de efeitos de word art.

AaiMotionInEffect

String

Não

Quando Type for Text, especifica o efeito de animação de entrada.

Para tipos e exemplos de efeitos de entrada, consulte Efeitos de entrada.

AaiMotionIn

Float

Não

Quando Type for Text, especifica a duração do efeito de entrada. Unidade: segundos, com precisão de quatro casas decimais. O padrão é 0,5 segundos se não for especificado. Se a duração total do texto for inferior a 0,5 segundos, a duração da entrada será igual à duração total menos a duração da saída.

AaiMotionOutEffect

String

Não

Quando o tipo de legenda for banner, especifica o efeito de entrada para o texto de banner.

Para os tipos e efeitos de entradas de legenda, consulte Efeitos de entrada.

AaiMotionOut

Float

Não

Quando Type for Text, especifica a duração do efeito de saída. Unidade: segundos, com precisão de quatro casas decimais. O padrão é 0,5 segundos se não for especificado. Se a duração total do texto for inferior a 0,5 segundos, a duração da saída será igual à duração total do texto.

AaiMotionLoopEffect

String

Não

Quando Type for Text, especifica o efeito de animação em loop. Não pode ser usado junto com efeitos de entrada ou saída.

Para tipos e exemplos de efeitos de loop, consulte Efeitos de loop.

Ratio

Float

Não

Quando Type for Text, especifica a velocidade de reprodução do efeito de loop. Precisão de quatro casas decimais. O padrão é 1 se não for especificado. Valores maiores que 1 aceleram o loop. Valores menores que 1 o desaceleram.

Nome

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo do item da faixa de efeitos. Valores válidos: VFX, Filter.

SubType

String

Sim

Subtipo do item da faixa de efeitos. Para tipos de efeitos suportados e exemplos, consulte Exemplos de efeitos especiais e Exemplos de efeitos de filtro.

TimelineIn

Float

Não

Tempo inicial do efeito na timeline. Unidade: segundos, com precisão de quatro casas decimais. O padrão é 0 se não for especificado.

TimelineOut

Float

Não

Tempo final do efeito na timeline. Unidade: segundos, com precisão de quatro casas decimais. Assume o tempo final do vídeo como padrão se não for especificado.

Duration

Float

Não

Duração do efeito na timeline. Unidade: segundos, com precisão de quatro casas decimais. Assume a duração do vídeo como padrão se não for especificado.

X

Float

Não

Aplica-se apenas quando SubType for mosaic_rect ou blur. Distância horizontal do canto superior esquerdo da área de efeito até o canto superior esquerdo do vídeo de saída.

Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da largura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Y

Float

Não

Aplica-se apenas quando SubType for mosaic_rect ou blur.

Distância vertical do canto superior esquerdo da área de efeito até o canto superior esquerdo do vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da altura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Width

Float

Não

Aplica-se apenas quando SubType for mosaic_rect ou blur. Largura da área de efeito no vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da largura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Height

Float

Não

Aplica-se apenas quando SubType for mosaic_rect ou blur. Altura da área de efeito no vídeo de saída. Aceita valores percentuais ou em pixels. Um valor entre [0–0,9999] representa uma porcentagem da altura do vídeo de saída. Um número inteiro ≥2 representa pixels absolutos.

Nome

Tipo

Obrigatório

Descrição

Bold

Boolean

Não

Negrito.

Italic

Boolean

Não

Itálico.

Underline

Boolean

Não

Sublinhado.

Nome

Tipo

Obrigatório

Descrição

Type

String

Sim

Tipo de efeito. Valores válidos:

• Text: texto de banner para clipes de faixa de vídeo.

• DeWatermark: remoção de marca d'água para clipes de faixa de vídeo.

• Crop: recorte para clipes de faixa de vídeo.

• Scale: dimensionamento para clipes de faixa de vídeo.

• Pad: Encaixe de clipes de faixa de vídeo

• Background: configurações de fundo para clipes de faixa de vídeo.

• Transition: efeitos de transição para clipes de faixa de vídeo.

• VFX: efeitos visuais para clipes de faixa de vídeo.

• Filter: filtros para clipes de faixa de vídeo.

• Volume: ajuste de volume para clipes de faixa de áudio.

• AFade: fade-in e fade-out de áudio para clipes de faixa de áudio.

• Rotate: rotação para clipes de faixa de vídeo.

• Clip: recorte aleatório.

• Flip: espelhamento.

• KenBurns: Efeito Ken Burns (panorâmica e zoom).

• Zoom: zoom.

SubType

String

Não

Subtipo do efeito.

• Quando Type for Transition, especifica o subtipo de transição. Para valores válidos, consulte Exemplos de efeitos de transição.

• Quando Type for VFX, especifica o subtipo de efeito visual. Para valores válidos, consulte Exemplos de efeitos especiais.

• Quando Type for Filter, especifica o subtipo de filtro. Para valores válidos, consulte Exemplos de efeitos de filtro.

Nome

Tipo

Descrição

JobId

String

O ID do job.

Nome

Tipo

Descrição

Name

String

Nome do modelo.

VodTemplateId

String

ID do modelo.

TemplateType

String

Tipo do modelo. Valores válidos:

• Snapshot: snapshot.

• DynamicImage: imagem dinâmica.

IsDefault

String

Indica se esta é a marca d'água padrão. Valores válidos:

• Default: a marca d'água é a padrão.

• NotDefault: a marca d'água não é a padrão.

TemplateConfig

JSON

Configuração detalhada do modelo. O valor é uma string JSON.

• Para mais informações sobre a configuração de snapshot, consulte SnapshotTemplateConfig.

• Para a configuração de DynamicImage, consulte DynamicImageTemplateConfig.

CreationTime

String

Horário de criação do modelo, no formato UTC.

ModifyTime

String

Horário da última modificação do modelo, no formato UTC.

Nome

Tipo

Descrição

JobId

String

ID do job de snapshot.

CreationTime

String

Horário de criação do job de snapshot, em UTC.

Total

Long

Quantidade total de snapshots.

Regular

String

Regra para geração das URLs dos snapshots.

Snapshots

Snapshot[]

Dados do snapshot.

Nome

Tipo

Descrição

Index

String

Valor do índice do snapshot.

Url

String

URL do snapshot.

Nome

Tipo

Descrição

VideoId

String

ID do vídeo.

DynamicImageId

String

ID da imagem dinâmica.

FileURL

String

URL do arquivo de imagem dinâmica.

Width

String

Largura da imagem dinâmica.

Height

String

Altura da imagem dinâmica.

Duration

String

Duração da imagem dinâmica.

Format

String

Formato da imagem dinâmica. Os valores válidos são gif ou webp.

FileSize

String

Tamanho do arquivo de imagem dinâmica.

Fps

String

Taxa de quadros da imagem dinâmica.

Nome

Tipo

Obrigatório

Descrição

CreationTime

String

Sim

Horário em que a marca d'água foi adicionada.

Name

String

Sim

Nome da marca d'água.

IsDefault

String

Sim

Indica se a marca d'água é a padrão. Valores válidos:

• Default: marca d'água padrão.

• NotDefault: marca d'água não padrão.

Type

String

Sim

Tipo da marca d'água. Valores válidos:

• Image: uma imagem.

• Text: texto.

WatermarkId

String

Sim

ID da marca d'água.

FileUrl

String

Não

URL do OSS ou URL do CDN do arquivo de marca d'água. Este parâmetro não se aplica a marcas d'água de texto.

WatermarkConfig

WatermarkConfig

Sim

Configurações de posição e efeito da marca d'água de texto ou imagem. O valor deve ser uma string JSON.

Nome

Tipo

Descrição

JobId

String

O ID do job de transcodificação.

Nome

Tipo

Obrigatório

Descrição

Name

String

Sim

Nome do grupo de modelos.

TranscodeTemplateGroupId

String

Sim

O ID do grupo de modelos de transcodificação.

IsDefault

String

Sim

Indica se este é o grupo de modelos padrão. Valores válidos:

• Default: o grupo de modelos padrão.

• NotDefault: um grupo de modelos não padrão.

CreationTime

String

Sim

O momento em que o grupo de modelos foi criado.

ModifyTime

String

Sim

O momento da última modificação do grupo de modelos.

TranscodeTemplateList

TranscodeTemplate[]

Sim

A lista de configurações de modelos de transcodificação.

Nome

Tipo

Obrigatório

Descrição

Type

String

Não

O tipo de modelo. Valores válidos:

• Normal: um modelo de transcodificação comum.

  Não é possível definir o parâmetro PackageSetting para este tipo de modelo.

• VideoPackage: um modelo de empacotamento de fluxo de vídeo.

  Este modelo primeiro transcodifica o vídeo e depois cria um fluxo de taxa de bits adaptável. É necessário configurar o parâmetro PackageSetting.

• SubtitlePackage: um modelo de empacotamento de legendas.

  Este tipo de modelo não realiza transcodificação. Em vez disso, ele incorpora as informações de legenda correspondentes aos arquivos de saída de taxa de bits adaptável. Configure o parâmetro PackageSetting. No entanto, esse tipo de modelo não pode existir independentemente em um grupo de modelos. Configure-o junto com um modelo VideoPackage, sendo permitido apenas um modelo desse tipo por grupo.

Valor padrão: Normal.

Video

Video

Sim

A configuração de transcodificação para o fluxo de vídeo. O valor deve ser uma string JSON.

Audio

Audio

Sim

A configuração de transcodificação para o fluxo de áudio. O valor deve ser uma string JSON.

Definition

String

Sim

A definição de um modelo de transcodificação comum. Valores válidos:

• LD: baixa definição.

• SD: definição padrão.

• HD: alta definição.

• FHD: ultra-alta definição.

• OD: qualidade original. Este valor é usado para conversão de formato de contêiner.

• 2K

• 4K

• SQ: qualidade de som padrão.

• HQ: alta qualidade de som.

A definição de um modelo de transcodificação Narrowband HD 1.0. Valores válidos:

• LD-NBV1: baixa definição.

• SD-NBV1: definição padrão.

• HD-NBV1: alta definição.

• FHD-NBV1: ultra-alta definição.

• 2K-NBV1

• 4K-NBV

Container

Container

Sim

O formato de contêiner usado para encapsular fluxos de áudio e vídeo. O valor deve ser uma string JSON.

MuxConfig

MuxConfig

Não

A configuração de segmento para transcodificação. Especifique este parâmetro se o formato do contêiner for HLS. O valor deve ser uma string JSON.

TransConfig

TransConfig

Não

A configuração de transcodificação condicional. Use este parâmetro para aplicar lógica básica com base na taxa de bits e na resolução do vídeo de origem antes de gerar o vídeo transcodificado. O valor deve ser uma string JSON.

TranscodeFileRegular

String

Não

O caminho personalizado para armazenar arquivos de saída.

Exemplo de configuração

{MediaId}/watermark-{PlayDefinition}: Durante a transcodificação, o ApsaraVideo VOD substitui {MediaId} pelo ID do vídeo (por exemplo, 8ff5cc93f6da4079a47a77bf71d) e {PlayDefinition} pela definição (por exemplo, fd).

Exemplo de saída

8ff5cc93f6da4079a47a77bf71d/watermark-fd.mp4 (O ApsaraVideo VOD anexa automaticamente a extensão do arquivo, como .mp4, .m3u8 ou .flv).

Clip

Clip

Não

A configuração de recorte de vídeo. O valor deve ser uma string JSON.

Por exemplo, defina este parâmetro para extrair 5 segundos de conteúdo de um vídeo e gerar um novo vídeo.

Rotate

String

Não

O ângulo de rotação do vídeo. Valores válidos: [0,360].

Por exemplo, definir este parâmetro como 180 inverte a imagem do vídeo de cabeça para baixo.

EncryptSetting

EncryptSetting

Não

A configuração de criptografia para transcodificação.

PackageSetting

PackageSetting

Não

A configuração de empacotamento. Apenas o empacotamento de taxa de bits adaptável HLS e o empacotamento DASH são suportados. O valor deve ser uma string JSON.

SubtitleList

SubtitleConfig

Não

A configuração de legenda. O valor deve ser uma string JSON.

WatermarkIds

String[]

Não

Os IDs das marcas d'água associadas. Associe até quatro IDs de marca d'água. USER_DEFAULT_WATERMARK representa o ID da marca d'água padrão.

TranscodeTemplateId

String

Não

O ID do modelo de transcodificação. Especifique este parâmetro ao modificar um modelo.

TemplateName

String

Não

O nome do modelo de transcodificação. Especifique este parâmetro ao criar um modelo.

Nome

Tipo

Obrigatório

Descrição

Codec

String

Sim

O formato de codificação de vídeo: H.264 ou H.265.

Remove

String

Sim

Indica se o fluxo de vídeo deve ser removido. Valores válidos:

• true: remove o fluxo de vídeo do arquivo de saída.

• false: mantém o fluxo de vídeo no arquivo de saída.

Valor padrão: false.

Bitrate

String

Não

A taxa de bits alvo para o vídeo de saída. Se você não especificar este parâmetro, a taxa de bits será calculada usando o parâmetro Crf. Unidade: Kbps.

Valores válidos: [10,50000].

Height

String

Não

A altura do vídeo de saída. O valor deve ser um múltiplo de 2. Se você não especificar este parâmetro, a altura do arquivo de origem será usada. Unidade: pixels. Valores válidos: [128,4096].

Width

String

Não

A largura do vídeo de saída. O valor deve ser um múltiplo de 2. Se você não especificar este parâmetro, a largura do arquivo de origem será usada. Unidade: pixels. Valores válidos: [128,4096].

Fps

String

Não

A taxa de quadros do vídeo de saída. Se você não especificar este parâmetro, a taxa de quadros do arquivo de origem será usada. Unidade: FPS. Valores válidos: (0,60].

Gop

String

Não

A distância entre quadros-chave adjacentes. Unidade: quadros. Valores válidos: [1,100000].

LongShortMode

String

Não

Ativa a rotação automática de tela. A largura do vídeo de saída corresponde ao lado longo da origem (altura no modo retrato). A altura do vídeo de saída corresponde ao lado curto da origem (largura no modo retrato). Valores válidos:

• true: Ativado.

• false: O recurso está desativado.

Valor padrão: true. Este recurso funciona melhor para vídeos verticais. Recomendamos ativá-lo.

Crf

String

Não

O fator de controle de qualidade da taxa de bits. Se você especificar este parâmetro, o parâmetro Bitrate será ignorado. Um valor maior resulta em menor qualidade de vídeo e tamanho de arquivo menor. Um valor menor resulta em maior qualidade de vídeo, tamanho de arquivo maior e tempo de transcodificação mais longo. Valores válidos: [0,51].

Valor padrão: 26. Não recomendamos alterar este valor.

Profile

String

Não

O perfil de codificação. Valores válidos:

• baseline: adequado para dispositivos móveis.

• main: adequado para dispositivos de definição padrão.

• high: adequado para dispositivos de alta definição.

Valor padrão: high. Este parâmetro aplica-se apenas à codificação H.264.

Melhores práticas

Se você oferecer suporte a várias definições, defina a definição mais baixa como baseline para garantir a reprodução em dispositivos básicos. Defina as outras definições como main ou high.

Preset

String

Não

O algoritmo de vídeo predefinido. Valores válidos: veryfast, fast, medium, slow, slower.

Valor padrão: medium. Este parâmetro aplica-se apenas à codificação H.264. Não recomendamos alterar este valor.

ScanMode

String

Não

O modo de varredura. Valores válidos:

• interlaced: varredura entrelaçada.

• progressive: varredura progressiva.

Bufsize

String

Não

O tamanho do buffer. Unidade: KB. Valores válidos: [1000,128000].

Valor padrão: 6000.

Maxrate

String

Não

A taxa de bits máxima de vídeo. Unidade: Kbps. Valores válidos: [1000,50000].

PixFmt

String

Não

O formato de pixel do vídeo. Formatos padrão como yuv420p e yuvj420p são suportados.

Valor padrão: yuv420p ou o formato de pixel original.

Nome

Tipo

Obrigatório

Descrição

Codec

String

Sim

O formato de codificação de áudio: AAC ou MP3.

Bitrate

String

Sim

A taxa de bits alvo para o áudio de saída. Unidade: Kbps. Valores válidos: [8,1000].

Remove

String

Sim

Indica se o fluxo de áudio deve ser removido. Valores válidos:

• true: remove o fluxo de áudio do arquivo de saída.

• false: mantém o fluxo de áudio no arquivo de saída.

Valor padrão: false.

Samplerate

String

Sim

A taxa de amostragem. Unidade: Hz. Valores válidos: 22050, 32000, 44100, 48000, 96000.

Valor padrão: 44100.

Se o formato do contêiner for FLV e o codec de áudio for MP3, a taxa de amostragem não pode ser 32000, 48000 ou 96000.

Se o codec de áudio for MP3, a taxa de amostragem não pode ser 96000.

Channels

String

Não

O número de canais de áudio. Valor padrão: 2.

• Se Codec estiver definido como MP3, os valores válidos são 1 ou 2.

• Se Codec estiver definido como AAC, os valores válidos são 1, 2, 4, 5, 6 ou 8.

Profile

String

Não

O perfil do codec de áudio. Se Codec estiver definido como AAC, os valores válidos incluem aac_low, aac_he, aac_he_v2, aac_ld e aac_eld.

Volume

Volume

Não

A configuração de volume.

Nome

Tipo

Obrigatório

Descrição

Format

String

Sim

O formato do contêiner.

• A transcodificação de vídeo suporta FLV, MP4 e HLS (M3U8+TS).

• A transcodificação de áudio suporta MP3 e MP4.

• Se o formato do contêiner for FLV, o codec de vídeo não pode ser definido como H.265.

Nome

Tipo

Obrigatório

Descrição

Segment

Segment

Sim

Um objeto JSON que contém campos de configuração de segmento.

Nome

Tipo

Obrigatório

Descrição

Duration

String

Sim

A duração de cada segmento TS. O valor deve ser um número inteiro. Valores válidos: [1,60]. Unidade: segundos.

Exemplo: {"Duration":"10"}.

Nome

Tipo

Obrigatório

Descrição

TransMode

String

Não

O modo de transcodificação. Valores válidos:

• onepass: modo de taxa de bits média (ABR). A codificação é mais rápida que twopass. O Alibaba Cloud usa onepass por padrão.

• twopass: modo de taxa de bits variável (VBR). O codificador executa duas vezes para alocar a taxa de bits com precisão, produzindo arquivos menores com maior qualidade. Twopass leva mais tempo que onepass e não é adequado para cenários sensíveis à latência, como streaming ao vivo ou comunicação em tempo real. Se o vídeo de entrada estiver altamente compactado, twopass pode causar artefatos de bloqueio.

• CBR: modo de taxa de bits constante. O arquivo usa a mesma taxa de bits em toda a sua extensão. Arquivos CBR são maiores que arquivos VBR ou ABR e não oferecem melhoria significativa de qualidade.

Valor padrão: onepass.

IsCheckReso

String

Não

Verifica a resolução do vídeo de origem para determinar se a resolução de origem deve ser usada na transcodificação. Valores válidos:

• true: verifica a resolução. Se a resolução de saída exceder a resolução de origem (com base na largura ou altura), a resolução de saída será definida como a resolução de origem.

• false: ignora a verificação.

Valor padrão: false.

IsCheckResoFail

String

Não

Verifica a resolução do vídeo de origem para determinar se a transcodificação falha. Valores válidos:

• true: verifica a resolução. Se a resolução de saída exceder a resolução de origem (com base na largura ou altura), a transcodificação falhará.

• false: ignora a verificação.

Valor padrão: false.

IsCheckVideoBitrate

String

Não

Verifica a taxa de bits do vídeo de origem para determinar se a taxa de bits de origem deve ser usada na transcodificação. Valores válidos:

• true: verifica a taxa de bits. Se a taxa de bits de saída exceder a taxa de bits de origem, a taxa de bits de saída será definida como a taxa de bits de origem.

• false: ignora a verificação.

Valor padrão: false.

IsCheckVideoBitrateFail

String

Não

Verifica a taxa de bits do vídeo de origem para determinar se a transcodificação falha. Valores válidos:

• true: verifica a taxa de bits. Se a taxa de bits de saída exceder a taxa de bits de origem, a transcodificação não ocorrerá.

• false: ignora a verificação.

Valor padrão: false. Este valor tem precedência sobre IsCheckVideoBitrate.

IsCheckAudioBitrate

String

Não

Verifica a taxa de bits do áudio de origem para determinar se a taxa de bits de origem deve ser usada na transcodificação. Valores válidos:

• true: verifica a taxa de bits. Se a taxa de bits de saída exceder a taxa de bits de origem, a taxa de bits de saída será definida como a taxa de bits de origem.

• false: ignora a verificação.

Valor padrão: false.

IsCheckAudioBitrateFail

String

Não

Verifica a taxa de bits do áudio de origem para determinar se a transcodificação falha. Valores válidos:

• true: verifica a taxa de bits. Se a taxa de bits de saída exceder a taxa de bits de origem, a transcodificação não ocorrerá.

• false: ignora a verificação.

Valor padrão: false. Este valor tem precedência sobre IsCheckAudioBitrate.

Nome

Tipo

Obrigatório

Descrição

TimeSpan

TimeSpan

Sim

A configuração relacionada ao tempo para recorte de vídeo.

Nome

Tipo

Obrigatório

Descrição

Seek

String

Sim

O horário de início do clipe de vídeo.

• Formato 1: sssss[.SSS]. Valores válidos: [0.000,86399.999].

  Exemplo: 12000.55.

• Formato 2: hh:mm:ss[.SSS]. Valores válidos: [00:00:00.000,23:59:59.999]. Exemplo: 00:00:05.003.

Recomendamos usar o Formato 1.

Duration

String

Não

Duração do recorte de vídeo.

• Formato 1: sssss[.SSS]. Valores válidos: [0.000,86399.999].

  Exemplo: 12000.55.

• Formato 2: hh:mm:ss[.SSS]. Valores válidos: [00:00:00.000,23:59:59.999]. Exemplo: 00:00:05.003.

Recomendamos usar o Formato 1.

End

String

Não

A duração do segmento final a ser descartada durante o recorte de vídeo.

• Formato 1: sssss[.SSS]. Valores válidos: [0.000,86399.999].

  Exemplo: 12000.55.

• Formato 2: hh:mm:ss[.SSS]. Valores válidos: [00:00:00.000,23:59:59.999]. Exemplo: 00:00:05.003.

Recomendamos usar o Formato 1.

Nome

Tipo

Obrigatório

Descrição

EncryptType

String

Sim

O tipo de criptografia. Valores válidos:

• AliyunVoDEncryption: criptografia privada ou criptografia padrão HLS para vídeos M3U8 (HLS).

• AliyunVoDLicenseEncryption: criptografia privada para vídeos MP4.

Nome

Tipo

Obrigatório

Descrição

PackageType

String

Sim

O tipo de empacotamento. Valor válido: HLSPackage (empacotamento de taxa de bits adaptável HLS).

PackageConfig

PackageConfig

Não

A configuração de empacotamento. Especifique este parâmetro para um modelo VideoPackage.

SubtitleExtractConfigList

SubtitleExtractConfig[]

Não

A configuração de empacotamento de legendas. Especifique este parâmetro para um modelo SubtitlePackage. Não o especifique para outros tipos de modelo.

Nome

Tipo

Obrigatório

Descrição

BandWidth

String

Sim

A largura de banda máxima. Especifique este parâmetro para empacotamento HLS. Unidade: bps.

Especifique este parâmetro apenas para modelos VideoPackage.

Nome

Tipo

Obrigatório

Descrição

SubtitleUrlList

String[]

Sim

A URL do arquivo de legenda. Apenas URLs HTTP do OSS são suportadas. URLs HTTP de CDN e URLs HTTPS não são suportadas.

Language

String

Sim

O idioma da legenda. Por exemplo, en-US. Consulte a RFC 5646 para obter mais informações.

Format

String

Sim

O formato do arquivo de legenda. Apenas arquivos .vtt são suportados. Por exemplo: subtitle.vtt.

Name

String

Sim

O nome de exibição da faixa de legenda no player. Por exemplo: Chinês ou Inglês.

Nome

Tipo

Obrigatório

Descrição

SubtitleUrl

String

Sim

A URL do OSS do arquivo de legenda. URLs HTTPS e nomes de domínio CDN puros não são suportados. Formatos de legenda suportados: srt e ass.

CharEncode

String

Sim

O formato de codificação de caracteres. Valores válidos:

• auto: detecção automática.

• UTF-8

• GBK

• BIG5

Valor padrão: UTF-8.

Nome

Tipo

Obrigatório

Descrição

Method

String

Não

O método de ajuste de volume. Valores válidos: auto, dynamic, linear.

IntegratedLoudnessTarget

String

Não

O nível de intensidade sonora alvo. Valores válidos: [-70,-5]. Obrigatório se Method estiver definido como dynamic.

Valor padrão: -6.

TruePeak

String

Não

O nível de pico máximo. Valores válidos: [-9,0]. Obrigatório se Method estiver definido como dynamic.

Valor padrão: -1.

LoudnessRangeTarget

String

Não

O intervalo de intensidade sonora. Valores válidos: [1,20]. Obrigatório se Method estiver definido como dynamic.

Valor padrão: 8.

Contêiner

Codecs de Áudio

mp3

MP3

mp4

AAC

ogg

VORBIS, FLAC

flac

FLAC

Contêiner

Codecs de Vídeo

Codecs de Áudio

flv

H.264

AAC, MP3

mp4

H.264, H.265

AAC, MP3

ts

H.264, H.265

AAC, MP3

m3u8

H.264, H.265

AAC, MP3

gif

GIF

Não suportado

Codecs de Vídeo

H.264

H.265

GIF

Profile

Suportado

×

×

Bitrate

Suportado

Suportado

×

Crf

Suportado

Suportado

×

Width

Suportado

Suportado

Suportado

Height

Suportado

Suportado

√

Fps

Suportado

Suportado

Suportado

Gop

Suportado

Suportado

×

Preset

√

×

×

ScanMode

Suportado

Suportado

Suportado

Bufsize

Suportado

Suportado

×

Maxrate

√

✓

×

PixFmt

Suportado

√

bgr8

Nome

Tipo

Descrição

VideoId

String

O ID do vídeo.

TranscodeTemplateGroupId

String

O ID do grupo de modelos de transcodificação usado para a transcodificação.

TranscodeStatus

String

O status da transcodificação. Valores válidos:

• Processing: Em andamento.

• Partial: alguns jobs de transcodificação foram concluídos.

• CompleteAllSucc: todos os jobs de transcodificação foram bem-sucedidos.

• CompleteAllFail: todos os jobs de transcodificação falharam. Se o vídeo de origem tiver problemas, nenhum job de transcodificação será iniciado e a tarefa inteira falhará.

• CompletePartialSucc: todos os jobs de transcodificação foram concluídos, mas apenas alguns foram bem-sucedidos.

TranscodeJobInfoSummaryList

TranscodeJobInfoSummary[]

A lista de resumos de jobs de transcodificação.

CreationTime

String

O momento em que a tarefa de transcodificação foi criada. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

CompleteTime

String

O momento em que a tarefa de transcodificação foi concluída. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

Nome

Tipo

Descrição

TranscodeTemplateId

String

O ID do modelo de transcodificação usado.

Width

String

A largura do vídeo de saída. Unidade: pixels.

Height

String

A altura do vídeo de saída. Unidade: pixels.

Duration

String

A duração do vídeo de saída. Unidade: segundos.

Filesize

String

O tamanho do arquivo de vídeo de saída. Unidade: bytes.

Bitrate

String

A taxa de bits média do vídeo de saída. Unidade: Kbps.

Fps

String

A taxa de quadros do vídeo de saída. Unidade: quadros por segundo.

Format

String

O formato de contêiner do vídeo de saída.

WatermarkIdList

String[]

A lista de IDs de marca d'água aplicados ao vídeo de saída.

TranscodeProgress

Long

O progresso da transcodificação. Valores válidos: [0,100].

TranscodeJobStatus

String

O status do job de transcodificação. Valores válidos:

• Transcoding: o job está em execução.

• TranscodeSuccess: o job foi bem-sucedido.

• TranscodeFail: A transcodificação falhou.

CreationTime

String

O momento em que o job de transcodificação foi criado. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

CompleteTime

String

O momento em que o job de transcodificação foi concluído. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

ErrorCode

String

O código de erro retornado se o job de transcodificação falhar.

ErrorMessage

String

A mensagem de erro retornada se o job de transcodificação falhar.

Nome

Tipo

Descrição

TranscodeTaskId

String

O ID da tarefa de transcodificação.

TranscodeTemplateGroupId

String

O ID do grupo de modelos de transcodificação usado para a transcodificação.

VideoId

String

O ID do vídeo.

TaskStatus

String

O status da tarefa de transcodificação. Valores válidos:

• Processing: Em andamento.

• Partial: alguns jobs de transcodificação foram concluídos.

• CompleteAllSucc: Todas as tarefas de transcodificação foram concluídas com sucesso.

• CompleteAllFail: todos os jobs de transcodificação falharam. Se o vídeo de origem tiver problemas, nenhum job de transcodificação será iniciado e a tarefa inteira falhará.

• CompletePartialSucc: todos os jobs de transcodificação foram concluídos, mas apenas alguns foram bem-sucedidos.

CreationTime

String

O momento em que a tarefa de transcodificação foi criada. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

CompleteTime

String

O momento em que a tarefa de transcodificação foi concluída. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.

Trigger

String

O tipo de gatilho. Valores válidos:

• Auto: a transcodificação é acionada automaticamente após o envio de um vídeo.

• Manual: a transcodificação é acionada chamando a operação SubmitTranscodeJobs.

TranscodeJobInfoList

TranscodeJobInfo

As informações sobre os jobs de transcodificação.

Nome

Tipo

Descrição

TranscodeTaskId

String

O ID da tarefa de transcodificação.

TranscodeJobId

String

O ID do job de transcodificação.

VideoId

String

O ID do vídeo.

TranscodeProgress

Long

O progresso do job de transcodificação. Valores válidos: [0,100].

TranscodeJobStatus

String

O status do job de transcodificação. Valores válidos:

• Transcoding: o job está em execução.

• TranscodeSuccess: o job foi bem-sucedido.

• TranscodeFail: o job falhou.

Priority

String

A prioridade da tarefa de transcodificação.

Definition

String

A definição.

TranscodeTemplateId

String

O ID do modelo de transcodificação usado para a transcodificação.

CreationTime

String

O momento em que o job de transcodificação foi criado.

CompleteTime

String

O momento em que o job de transcodificação foi concluído.

InputFileUrl

String

A URL do OSS do arquivo de origem.

OutputFile

OutputFile

As informações sobre o arquivo de saída.

ErrorCode

String

O código de erro retornado se o job de transcodificação falhar.

ErrorMessage

String

A mensagem de erro retornada se o job de transcodificação falhar.

Nome

Tipo

Descrição

OutputFileUrl

String

A URL do OSS do arquivo de saída.

Format

String

O formato de contêiner do arquivo de saída.

Width

String

A largura do vídeo no arquivo de saída. Unidade: pixels.

Height

String

A altura do vídeo no arquivo de saída. Unidade: pixels.

Duration

String

A duração do arquivo de saída. Unidade: segundos.

Bitrate

String

A taxa de bits média do arquivo de saída. Unidade: Kbps.

Fps

String

A taxa de quadros do arquivo de saída. Unidade: quadros por segundo.

Filesize

Long

O tamanho do arquivo de saída. Unidade: bytes.

EncryptType

String

O tipo de criptografia usado para o arquivo de saída. O valor é uma string JSON.

WatermarkIdList

String

A lista de IDs de marca d'água aplicados ao arquivo de saída.

VideoStreamList

String

A lista de fluxos de vídeo. Para obter mais informações, consulte VideoStream: informações do fluxo de vídeo.

AudioStreamList

String

A lista de fluxos de áudio. Para obter mais informações, consulte AudioStream: informações do fluxo de áudio.

Nome

Tipo

Descrição

VideoId

String

ID do vídeo.

PlayDuration

String

Duração da reprodução em milissegundos.

Title

String

Título do vídeo.

VV

String

Quantidade de visualizações do vídeo.

UV

String

Número de usuários que reproduziram o conteúdo.

Nome

Tipo

Descrição

Date

String

Data no formato yyyyMMdd.

Exemplo: 20170120.

PlayDuration

String

Duração da reprodução em milissegundos.

Title

String

Título do vídeo.

VV

String

Quantidade de visualizações do vídeo.

UV

String

Número de usuários que realizaram a reprodução.

PlayRange

String

Distribuição da duração de reprodução.

Nome

Tipo

Descrição

Date

String

Data no formato yyyyMMdd.

Exemplo: 20170120.

PlayDuration

String

Duração total de reprodução em milissegundos.

PlayRange

String

Distribuição da duração de reprodução.

VV

VV

Número total de visualizações de vídeo.

UV

UV

Total de usuários que reproduziram conteúdo.

Nome

Tipo

Descrição

Date

String

Data no formato yyyyMMdd.

Exemplo: 20170120.

AvgPlayDuration

String

Duração média de reprodução em milissegundos.

AvgPlayCount

String

Média de visualizações de vídeo.

Nome

Tipo

Descrição

Android

String

Total de visualizações de vídeo pelo player para Android.

iOS

String

Total de visualizações de vídeo pelo player para iOS.

Flash

String

Quantidade total de sessões de reprodução no player Flash.

HTML5

String

Total de visualizações de vídeo pelo player para HTML5.

Nome

Tipo

Descrição

Android

String

Total de visitantes únicos no player para Android.

iOS

String

Quantidade de usuários que reproduziram conteúdo no player para iOS.

Flash

String

Total de usuários de reprodução no Flash Player.

HTML5

String

Número total de usuários de reprodução em HTML5.

Nome

Tipo

Descrição

CallbackType

String

Método de callback. Valores válidos: HTTP e MNS.

CallbackURL

String

Endereço do webhook para callbacks HTTP.

MnsEndpoint

String

Endpoint público da fila MNS para callbacks via MNS.

MnsQueueName

String

Nome da fila MNS para callbacks via MNS.

EventTypeList

String

Tipo de evento de callback.

AuthSwitch

String

Chave de autenticação para callbacks HTTP. Valores válidos:

• On: ativado.

• off: desativado.

AuthKey

String

Chave de autenticação para callbacks HTTP.

Nome

Tipo

Descrição

AppId

String

ID da aplicação.

AppName

String

Nome da aplicação.

Description

String

Descrição da aplicação.

Type

String

Tipo da aplicação. Valores válidos:

• Default: definido pelo sistema.

• Custom: criado pelo usuário.

Status

String

Status da aplicação. Valores válidos:

• Normal: operação normal.

• Disable: aplicação desativada.

CreationTime

String

Horário de criação em UTC.

ModificationTime

String

Horário de atualização em UTC.

Nome

Tipo

Descrição

AppId

String

ID da aplicação.

PolicyType

String

Tipo da política. Valores válidos:

• System: política do sistema.

• Custom: política definida pelo usuário.

PolicyName

String

Nome da política.

CreationTime

String

Horário de criação em UTC.

Description

String

Descrição da política.