Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Conclusão de transcodificação de definição única

Última atualização: Jun 27, 2026

Este tópico descreve o evento StreamTranscodeComplete e fornece exemplos de callbacks.

Tipo de evento

StreamTranscodeComplete

Descrição do evento

O evento StreamTranscodeComplete é gerado quando um fluxo de vídeo é transcodificado para uma definição e formato específicos, como um fluxo SD no formato MP4. É possível reproduzir imediatamente um fluxo de vídeo em resolução única após a transcodificação em pelo menos um formato.

Nota

Se a assinatura de URL estiver ativada, gere uma auth_key para acessar a URL de reprodução. Caso contrário, o sistema retornará um erro HTTP 403. Para obter mais informações sobre assinatura de URL, consulte configure assinatura de URL.

Conteúdo do evento

Nome do parâmetro

Tipo

Obrigatório

Descrição

EventTime

String

Sim

Horário de geração do evento. Segue o padrão ISO 8601 no formato yyyy-MM-ddThh:mm:ssZ e utiliza UTC.

EventType

String

Sim

Tipo do evento. Parâmetro obrigatório com valor fixo StreamTranscodeComplete.

VideoId

String

Sim

ID do vídeo.

Status

String

Sim

Status de transcodificação do fluxo de vídeo:

  • success: Job concluído com êxito.

  • fail: Falha na operação.

Bitrate

String

Não

Taxa de bits do fluxo de vídeo. Unidade: Kbit/s.

Definition

String

Não

Qualidade do fluxo de vídeo. Valores válidos:

  • FD: Baixa definição

  • LD: Definição padrão

  • HD: Alta definição

  • UHD: Ultra-alta definição

  • OD: Qualidade original

  • 2K: 2K

  • 4K: 4K

  • AUTO: Fluxo com taxa de bits adaptativa

Duration

Double

Não

Duração do fluxo de vídeo. Unidade: segundos.

Encrypt

Boolean

Não

Indica se o fluxo de vídeo está criptografado.

ErrorCode

String

Não

Código de erro. Retornado caso ocorra falha durante a transcodificação do fluxo de vídeo.

ErrorMessage

String

Não

Mensagem de erro. Retornada caso ocorra falha durante a transcodificação do fluxo de vídeo.

FileUrl

String

Não

URL de reprodução do fluxo de vídeo, sem incluir a auth_key. Se a assinatura de URL estiver ativada, gere a auth_key para reproduzir o vídeo por meio dessa URL.

Format

String

Não

Formato do fluxo de vídeo:

  • mp4

  • m3u8

Fps

String

Não

Taxa de quadros do fluxo de vídeo. Unidade: FPS.

Height

Long

Não

Altura do fluxo de vídeo. Unidade: pixels.

Size

Long

Não

Tamanho do fluxo de vídeo. Unidade: bytes.

Width

Long

Não

Largura do fluxo de vídeo. Unidade: pixels.

JobId

String

Não

ID do job de transcodificação.

WatermarkId

String

Não

IDs das marcas d'água, separados por vírgulas (,).

IsAudio

Boolean

Sim

Indica se o fluxo é de áudio.

StartTime

String

Sim

Horário de início da tarefa, exibido em UTC.

FinishTime

String

Sim

Horário de término da tarefa, exibido em UTC.

Extend

String

Não

Parâmetro personalizado retornado no modo de passagem direta. Para mais informações, consulte Parâmetros da solicitação.

Exemplos de callbacks

Confira abaixo um exemplo de callback:

  • Em callbacks HTTP, o exemplo a seguir corresponde ao corpo da mensagem da solicitação HTTP POST.

  • Em callbacks MNS, o exemplo a seguir corresponde ao corpo da mensagem.

    { 
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "StreamTranscodeComplete", 
       "VideoId": "43q9fj74hdf****", 
       "Status": "success",
       "Bitrate": "925",
       "Definition": "LD",
       "Duration": 15.0,
       "Encrypt": false,
       "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4",
       "Format": "mp4",
       "Fps": "30",
       "Height": 960,
       "Size": 1815321,
       "Width": 540,
       "JobId":"ddddddddddd",
       "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
       "IsAudio": false, 
       "StartTime": "2017-03-20T07:49:17Z",
       "FinishTime": "2017-03-20T09:49:17Z",
       "Extend":"test data"
    }