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.
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:
|
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:
|
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:
|
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" }