Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Tipos de dados da Timeline de edição online - para o editor legado (descontinuado)

Última atualização: Jun 27, 2026

O ApsaraVideo VOD utiliza os seguintes tipos de dados nas operações de API de edição online.

Timeline: informações da timeline

Nome

Tipo

Descrição

ID

String

ID do projeto de edição online.

Title

String

Título do projeto de edição online.

CreationTime

String

Momento de criação da timeline.

ModifiedTime

String

Data e hora da última modificação da timeline.

Duration

Float

Duração total da timeline. Unidade: segundos. Valor com precisão de quatro casas decimais.

CurrentRuler

Float

Tamanho da régua da timeline.

Parâmetro opcional se a timeline for usada apenas para produção de vídeo.

CurrentPosition

Float

Posição do cursor de reprodução no projeto de edição online. Unidade: segundos. Valor com precisão de quatro casas decimais.

Parâmetro opcional se a timeline for usada apenas para produção de vídeo.

VideoTracks

VideoTrack[]

Lista de faixas de vídeo.

VideoTrack: informações da faixa de vídeo

Nome

Tipo

Descrição

Count

Int

Número total de clipes de vídeo.

Duration

String

Duração total da faixa de vídeo.

VideoTrackClips

VideoTrackClip[]

Lista de clipes de vídeo.

VideoTrackClip: informações do clipe de vídeo

Nome

Tipo

Descrição

ID

String

ID do clipe de vídeo.

Parâmetro opcional quando a timeline serve apenas para produção de vídeo.

Se a timeline for usada para edição, este parâmetro deve ser único dentro dela.

VideoId

String

ID do material correspondente ao clipe de vídeo.

Type

String

Tipo do clipe de vídeo. Valores válidos:

  • Video.

  • Image: representação visual.

O valor padrão é Video.

Title

String

Título do clipe de vídeo. Por padrão, corresponde ao título do material de source.

Index

Int

Ordem do clipe de vídeo na timeline. O valor começa em 0.

CutFlag

Boolean

Indica se o clipe de vídeo foi cortado. Valores válidos: true e false.

Parâmetro opcional caso a timeline seja utilizada somente para produção de vídeo.

TextFlag

Boolean

Indica se há texto de banner adicionado ao clipe de vídeo. Valores válidos: true e false.

Parâmetro opcional se a finalidade da timeline for exclusivamente a produção de vídeo.

DeWatermarkFlag

Boolean

Indica se o clipe de vídeo está mascarado. Valores válidos: true e false.

Parâmetro opcional quando a timeline se destina apenas à produção de vídeo.

URL

String

URL do stream usado na edição de vídeo.

Parâmetro opcional se a timeline for usada apenas para produção de vídeo.

CoverURL

String

URL da miniatura do clipe de vídeo. Por padrão, é igual à URL da miniatura do material de source.

Parâmetro opcional caso a timeline sirva apenas para produção de vídeo.

SpriteURLs

String

URLs de sprite do clipe de vídeo. Separe múltiplas URLs com vírgula (,).

Parâmetro opcional quando a timeline é usada somente para produção de vídeo.

Width

Int

Largura do stream utilizado na edição de vídeo. Unidade: px.

Parâmetro opcional se a timeline for destinada apenas à produção de vídeo e nenhum efeito, como texto de banner ou máscara, for adicionado.

Height

Int

Altura do stream utilizado na edição de vídeo. Unidade: px.

Parâmetro opcional se a timeline for destinada apenas à produção de vídeo e nenhum efeito, como texto de banner ou máscara, for adicionado.

Fps

Float

Taxa de quadros do clipe de vídeo.

Parâmetro opcional quando a timeline é usada exclusivamente para produção de vídeo.

Bitrate

Float

Taxa de bits do stream usado na edição de vídeo.

Parâmetro opcional se a timeline servir apenas para produção de vídeo.

In

Float

Ponto de entrada do clipe de vídeo em relação ao material de source. Unidade: segundos. Valor com precisão de quatro casas decimais.

Out

Float

Ponto de saída do clipe de vídeo em relação ao material de source. Unidade: segundos. Valor com precisão de quatro casas decimais.

Duration

Float

Duração do clipe de vídeo. Unidade: segundos. Valor com precisão de quatro casas decimais.

VirginDuration

Float

Duração completa do material de source correspondente ao clipe de vídeo. Unidade: segundos. Valor com precisão de quatro casas decimais.

Parâmetro opcional caso a timeline seja usada apenas para produção de vídeo.

TimelineIn

Float

Ponto de entrada do clipe de vídeo em relação à timeline. Unidade: segundos. Valor com precisão de quatro casas decimais.

TimelineOut

Float

Ponto de saída do clipe de vídeo em relação à timeline. Unidade: segundos. Valor com precisão de quatro casas decimais.

Effects

Effect[]

Lista de efeitos do clipe de vídeo.

Effect: informações do efeito

Nome

Tipo

Descrição

Type

String

Tipo do efeito. Valores válidos:

  • Text: texto de banner para um material de vídeo.

  • DeWatermark: mascaramento para um material de vídeo.

Name

String

Nome do efeito.

SubType

String

Subclasse do efeito.

Se Type for definido como DeWatermark, defina SubType como Delogo_Blur.

In

Float

Ponto de entrada do efeito em relação ao clipe de vídeo. Unidade: segundos. Valor com precisão de quatro casas decimais.

Out

Float

Ponto de saída do efeito em relação ao clipe de vídeo. Unidade: segundos. Valor com precisão de quatro casas decimais.

TimelineIn

Float

Ponto de entrada do efeito em relação à timeline. Unidade: segundos. Valor com precisão de quatro casas decimais.

TimelineOut

Float

Ponto de saída do efeito em relação à timeline. Unidade: segundos. Valor com precisão de quatro casas decimais.

X

String

Deslocamento da coordenada X em relação ao canto superior esquerdo do vídeo. O valor pode ser inteiro ou decimal.

  • Inteiro: indica valor em pixels. Valores válidos: [8, 4096]. Unidade: px.

  • Decimal: indica a proporção do deslocamento em relação à largura do vídeo de saída. Valores válidos: (0, 1). Precisão de até quatro casas decimais (ex.: 0,9999). Dígitos subsequentes são truncados.

Y

String

Deslocamento da coordenada Y em relação ao canto superior esquerdo do vídeo. O valor pode ser inteiro ou decimal.

  • Inteiro: indica valor em pixels. Valores válidos: [8, 4096]. Unidade: px.

  • Decimal: indica a proporção do deslocamento em relação à altura do vídeo de saída. Valores válidos: (0, 1). Precisão de até quatro casas decimais (ex.: 0,9999). Dígitos subsequentes são truncados.

Width

Int

Largura da área de efeito. O valor pode assumir uma de duas formas:

  • Inteiro: indica valor em pixels. Valores válidos: [8, 4096]. Unidade: px.

  • Decimal: indica a proporção da largura da área de efeito em relação à largura do vídeo de saída. Valores válidos: (0, 1). Precisão de até quatro casas decimais (ex.: 0,9999). Dígitos subsequentes são truncados.

Height

Int

Altura da área de efeito. O valor pode ser inteiro ou decimal.

  • Inteiro: indica valor em pixels. Valores válidos: [8, 4096]. Unidade: px.

  • Decimal: indica a proporção da altura da área de efeito em relação à altura do vídeo de saída. Valores válidos: (0, 1). Precisão de até quatro casas decimais (ex.: 0,9999). Dígitos subsequentes são truncados.

FEWidth

Float

Largura real de exibição do vídeo durante a edição. Unidade: px.

FEHeight

Float

Altura real de exibição do vídeo durante a edição. Unidade: px.

Font

String

Fonte. Defina o valor como SimSun.

FontFace

FontFace

Aparência da fonte.

FontColor

String

Cor da fonte. O valor começa com # seguido por um valor hexadecimal. Exemplo: #ffffff.

FontSize

Int

Tamanho da fonte.

FontColorOpacity

Float

Opacidade da fonte. Valores válidos: 0 a 1. O valor 1 significa opaco e 0 significa totalmente transparente.

Content

String

Conteúdo do texto de banner.

FontFace: estilo da fonte

Nome

Tipo

Descrição

Bold

Boolean

Negrito.

Italic

Boolean

Itálico.

Underline

Boolean

Sublinhado.