Consulta vários jobs de transcodificação simultaneamente com base nos IDs dos jobs.
Observações de uso
Por padrão, os jobs retornados são classificados em ordem decrescente por CreationTime.
Esta operação permite consultar até 10 jobs de transcodificação por vez.
Se o parâmetro JobIds não for definido, o sistema retorna o código de erro
InvalidParameter.
Limites de QPS
O limite desta operação é de 100 chamadas por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar esta operação. Para mais informações, consulte Limite de QPS.
Depuração
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | QueryJobList | Operação a ser executada. Defina o valor como QueryJobList. |
| JobIds | String | Não | bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd**** | IDs dos jobs de transcodificação. Separe múltiplos IDs com vírgulas (,). É possível consultar no máximo 10 jobs de transcodificação por vez. Faça login no console do ApsaraVideo Media Processing (MPS) e clique em Tasks no painel de navegação à esquerda para obter os IDs dos jobs. Alternativamente, obtenha os IDs na resposta da operação SubmitJobs. Nota Se você não definir o parâmetro JobIds, o sistema retorna o código de erro InvalidParameter. |
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| NonExistJobIds | Array of String | d1ce4d3efcb549419193f50f1fcd**** | Lista de IDs de jobs inexistentes. Se todos os IDs consultados existirem, a resposta não conterá este parâmetro. |
| RequestId | String | 197ADF44-104C-514C-9F92-D8924CB34E2A | ID da solicitação. |
| JobList | Array of Job | Lista de jobs de transcodificação. |
|
| Job | |||
| CreationTime | String | 2014-01-10T12:00:00Z | Horário de criação do job. |
| Percent | Long | 100 | Progresso da transcodificação. |
| FinishTime | String | 2014-01-10T12:20:25Z | Horário de conclusão do job de transcodificação. |
| State | String | TranscodeSuccess | Status do job. Valores válidos:
|
| JobId | String | 31fa3c9ca8134fb4b0b0f7878301**** | ID do job. |
| Code | String | InvalidParameter.NullValue | Código de erro retornado em caso de falha no job de transcodificação. Este parâmetro não é retornado se o job for bem-sucedido. |
| Message | String | The specified parameter "%s" cannot be null. | Mensagem retornada em caso de falha no job. Este parâmetro não é retornado se o job for bem-sucedido. |
| Output | Object | Saída do job. |
|
| Video | Object | Configuração de vídeo. |
|
| Bufsize | String | 6000 | Tamanho do buffer.
|
| Degrain | String | 5 | Nível do algoritmo independente de redução de ruído. |
| BitrateBnd | Object | Faixa de taxa de bits média do vídeo. |
|
| Max | String | 1000 | Taxa de bits máxima. |
| Min | String | 300 | Taxa de bits mínima. |
| PixFmt | String | yuv420p | Formato de pixel para codificação de cores de vídeo. Formatos padrão como yuv420p e yuvj420p são suportados. |
| Pad | String | 1280:800:0:140 | Bordas pretas a adicionar ao vídeo.
|
| Codec | String | H.264 | Codec utilizado.
|
| Height | String | 720 | Altura do vídeo.
|
| Qscale | String | 15 | Nível de controle de qualidade do vídeo. |
| Crop | String | 1280:800:0:140 | Modo de corte. Os dois modos a seguir são suportados:
|
| Bitrate | String | 500 | Taxa de bits média do vídeo. Unidade: Kbit/s. |
| Maxrate | String | 3000 | Taxa de bits máxima do vídeo. Unidade: Kbit/s. |
| MaxFps | String | 60 | Taxa de quadros máxima. |
| Profile | String | high | Perfil do codec. Valores válidos: baseline, main e high. Nota Se existirem múltiplas definições, recomendamos definir este parâmetro como baseline para a definição mais baixa, garantindo reprodução normal em dispositivos de baixo desempenho. Defina este parâmetro como main ou high para outras definições.
|
| Crf | String | 26 | Fator de taxa constante.
|
| Gop | String | 250 | Intervalo máximo entre quadros-chave ou número máximo de quadros em um grupo de quadros. Unidade: segundos.
|
| Width | String | 1280 | Largura do vídeo.
|
| Fps | String | 25 | Taxa de quadros.
|
| Preset | String | medium | Algoritmo de vídeo predefinido. Valor padrão: medium. Valores válidos:
|
| ScanMode | String | interlaced | Modo de varredura. Valores válidos:
|
| ResoPriority | String | 1 | Prioridade do recurso. |
| TransConfig | Object | Configuração geral de transcodificação. Nota Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de transcodificação especificado. |
|
| IsCheckAudioBitrate | String | false | Indica se a taxa de bits de áudio é verificada. Se o recurso estiver ativado e o sistema detectar que a taxa de bits de áudio do arquivo de saída é maior que a do arquivo de entrada, a taxa de bits de áudio do arquivo de entrada será mantida após a transcodificação. Nesse caso, a configuração do parâmetro Bitrate torna-se inválida. Este parâmetro tem prioridade menor que o parâmetro IsCheckAudioBitrateFail.
|
| TransMode | String | onepass | Modo de transcodificação.
|
| IsCheckReso | String | false | Indica se a resolução é verificada. Se a resolução de saída for superior à resolução de entrada com base na largura ou altura, o sistema considerará que a resolução de saída é igual à resolução de entrada.
|
| IsCheckVideoBitrateFail | String | false | Indica se a taxa de bits de vídeo é verificada. Se a taxa de bits do vídeo de saída for superior à do vídeo de entrada, o sistema retorna falha de transcodificação sem transcodificar o vídeo. Este parâmetro tem prioridade maior que o parâmetro IsCheckVideoBitrate.
|
| AdjDarMethod | String | none | Método de ajuste de resolução. Valor padrão: none. Valores válidos: rescale, crop, pad e none. |
| IsCheckVideoBitrate | String | false | Indica se a taxa de bits de vídeo é verificada. Se a taxa de bits de saída for superior à taxa de bits de entrada, o sistema considerará que a taxa de bits de saída é igual à taxa de bits de entrada.
|
| IsCheckResoFail | String | false | Indica se a resolução é verificada. Se a resolução de saída for superior à resolução de entrada com base na largura ou altura, o sistema retorna falha de transcodificação.
|
| IsCheckAudioBitrateFail | String | false | Indica se a taxa de bits de áudio é verificada. Se a taxa de bits de áudio de saída for superior à taxa de bits de áudio da source de mídia, o sistema retorna falha de transcodificação sem transcodificar a mídia. Este valor tem prioridade maior que IsCheckAudioBitrate.
|
| Encryption | Object | Configuração de criptografia. Apenas saídas no formato M3U8 são suportadas. |
|
| Type | String | hls-aes-128 | Tipo de criptografia. Valor válido: hls-aes-128. |
| Key | String | encryptionkey128 | Chave usada para criptografar o vídeo. |
| KeyType | String | Base64 | Método de criptografia da chave. Valores válidos: Base64 e KMS. Nota Por exemplo, se a chave for encryptionkey128, o valor poderá ser Base64("encryptionkey128") ou KMS(Base64("encryptionkey128"), dependendo do método de criptografia usado. |
| Id | String | 31fa3c9ca8134f9cec2b4b0b0f78**** | ID de criptografia. |
| KeyUri | String | https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ | URL usada para solicitar a chave. A URL é codificada em Base64. |
| SkipCnt | String | 3 | Número de quadros não criptografados no início do vídeo. Manter esses quadros sem criptografia permite início rápido da reprodução do vídeo. |
| WaterMarkList | Array of WaterMark | Lista de marcas d'água. |
|
| WaterMark | |||
| Type | String | Image | Tipo da marca d'água. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. Para mais informações, consulte Detalhes dos parâmetros. Valores válidos:
|
| ReferPos | String | TopRight | Posição da marca d'água. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. Valores válidos:
|
| Dx | String | 100 | Deslocamento horizontal da imagem da marca d'água em relação ao vídeo de saída. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. Valor padrão: 0. O valor pode ser inteiro ou decimal.
|
| Width | String | 50 | Largura da marca d'água. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. O valor pode ser inteiro ou decimal.
|
| Height | String | 50 | Altura da imagem da marca d'água. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. O valor pode ser inteiro ou decimal.
|
| InputFile | Object | Arquivo de entrada da marca d'água. Use uma imagem no formato PNG ou um arquivo no formato MOV como arquivo de entrada da marca d'água. |
|
| Object | String | example-logo-****.png | Nome do objeto do Object Storage Service (oss) usado como arquivo de entrada. |
| Location | String | oss-cn-hangzhou | Região do oss onde o arquivo de entrada reside. |
| Bucket | String | example-bucket | Nome do bucket do oss onde o arquivo de entrada está armazenado. |
| WaterMarkTemplateId | String | 88c6ca184c0e47098a5b665e2a12**** | ID do modelo de marca d'água. |
| Dy | String | 100 | Deslocamento vertical da imagem da marca d'água em relação ao vídeo de saída. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de marca d'água. O valor pode ser inteiro ou decimal.
|
| WaterMarkConfigUrl | String | http://example.com/configure | URL do arquivo de configuração da marca d'água. |
| DeWatermark | String | {"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]} | Configuração de desfoque da marca d'água. O valor deve ser um objeto JSON. Para mais informações, consulte Detalhes dos parâmetros. |
| M3U8NonStandardSupport | Object | Configuração de suporte não padrão para M3U8. O valor deve ser um objeto JSON. Para mais informações, consulte Detalhes dos parâmetros. |
|
| TS | Object | Configuração de suporte não padrão para M3U8 referente a arquivos TS. O valor deve ser um objeto JSON. Para mais informações, consulte Detalhes dos parâmetros. |
|
| SizeSupport | Boolean | true | Indica se há suporte para saída do tamanho do arquivo TS no arquivo M3U8. Valores válidos:
|
| Md5Support | Boolean | true | Indica se há suporte para saída do valor md5 do arquivo TS no arquivo M3U8. Valores válidos:
|
| Priority | String | 6 | Prioridade do job na fila do MPS à qual o job foi adicionado.
|
| Audio | Object | Configuração de áudio. Nota Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de transcodificação especificado. |
|
| Profile | String | aaclow | Perfil do codec do arquivo de áudio. Valores válidos quando o parâmetro Codec é aac: aaclow, aache, aachev2, aacld e aaceld. |
| Codec | String | aac | Formato de codificação e decodificação de áudio.
|
| Samplerate | String | 44100 | Taxa de amostragem.
Nota Se o formato de contêiner de vídeo for FLV e o codec de áudio for MP3, não defina este parâmetro como 32000, 48000 ou 96000. Se o codec de áudio for MP3, não defina este parâmetro como 96000. |
| Qscale | String | 15 | Nível de controle de qualidade do áudio. |
| Channels | String | 2 | Número de canais de som.
|
| Volume | Object | Configuração de volume. |
|
| Method | String | auto | Método de ajuste de volume. Valores válidos:
|
| Level | String | -20 | Faixa de ajuste de volume. Valor padrão: -20db. |
| Bitrate | String | 128 | Taxa de bits de áudio do arquivo de saída.
|
| AudioStreamMap | String | 0:a:0 | Número de sequência do fluxo de áudio.
|
| MergeList | Array of Merge | Configuração de mesclagem. No máximo quatro URLs podem ser mescladas. |
|
| Merge | |||
| Start | String | 01:59:59.999 | Ponto inicial no tempo do clipe.
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN (Alibaba Cloud Resource Name) da função usada para autorização de proxy. |
| MergeURL | String | http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv | URL do oss do clipe.
|
| Duration | String | 01:59:59.999 | Duração do clipe.
|
| SuperReso | Object | Indica que a resolução do vídeo de origem é utilizada. |
|
| IsHalfSample | String | true | Indica se devem ser obtidos parâmetros relacionados à taxa de amostragem. Valores válidos:
|
| UserData | String | testid-001 | Dados personalizados. |
| ExtendData | String | testid-002 | Campos personalizados. |
| OutSubtitleList | Array of OutSubtitle | Lista de legendas de saída. |
|
| OutSubtitle | |||
| Map | String | 0:v:0 | Faixa de vídeo. Formato: |
| OutSubtitleFile | Object | Detalhes do arquivo de saída. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN da função usada para autorização de proxy. |
| Object | String | example.flv | Nome do objeto do oss usado como arquivo de saída. |
| Location | String | oss-cn-hangzhou | ID da região do oss onde o arquivo de saída reside. |
| Bucket | String | exampleBucket | Bucket do oss onde o arquivo de saída está armazenado. |
| Success | Boolean | true | Indica se o job foi bem-sucedido. Valores válidos:
|
| Message | String | The specified parameter "%s" cannot be null. | Mensagem de erro retornada se o job não for criado. Este parâmetro não é retornado se o job for criado. |
| VideoStreamMap | String | 0 | Número de sequência do fluxo de vídeo. O número de sequência é o índice do fluxo de vídeo na lista e começa em 0. Se você não definir o parâmetro correspondente na solicitação, o sistema seleciona o fluxo de vídeo padrão. |
| OutputFile | Object | Informações sobre o arquivo de saída. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN da função usada para autorização de proxy. |
| Object | String | example-output.flv | Nome do objeto do oss usado como arquivo de saída. |
| Location | String | oss-cn-hangzhou | ID da região do oss onde o arquivo de saída reside. |
| Bucket | String | example-bucket | Bucket do oss onde o arquivo de saída está armazenado. |
| Rotate | String | 90 | Ângulo de rotação do vídeo. |
| Container | Object | Configuração do contêiner. |
|
| Format | String | mp4 | Formato do contêiner.
|
| Clip | Object | Informações sobre o clipe de mídia. |
|
| TimeSpan | Object | Intervalo de tempo do clipe. |
|
| Seek | String | 01:59:59.999 | Horário em que o clipe começa.
Ou
|
| Duration | String | 01:00:59.999 | Duração do clipe.
Ou
|
| MergeConfigUrl | String | https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8 | URL do arquivo de configuração de mesclagem. Especifique apenas um dos parâmetros MergeList e MergeConfigUrl.
|
| OpeningList | Array of Opening | Lista de partes de abertura. O valor é um objeto JSON. |
|
| Opening | |||
| openUrl | String | http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4 | URL do oss da parte de abertura do vídeo. |
| Start | String | 0 | Tempo decorrido após o qual a parte de abertura é reproduzida.
|
| Width | String | -1 | Largura da parte de abertura.
|
| Height | String | -1 | Altura da parte de abertura.
|
| MuxConfig | Object | Configuração de transmuxing. Se este parâmetro for especificado na solicitação, o valor substituirá o parâmetro correspondente no modelo de transcodificação especificado. |
|
| Webp | Object | Configuração de transmuxing para WebP. |
|
| Loop | String | 0 | Contagem de loops. |
| Gif | Object | Configuração de transmuxing para GIF. |
|
| FinalDelay | String | 0 | Duração pela qual o quadro final é pausado. Unidade: centésimos de segundo. |
| DitherMode | String | bayer | Algoritmo de dithering de cores da paleta. Valores válidos: sierra e bayer. |
| Loop | String | 0 | Contagem de loops. |
| IsCustomPalette | String | false | Indica se a paleta personalizada é usada. Valores válidos:
|
| Segment | Object | Configuração de segmento. O valor é um objeto JSON. |
|
| Duration | String | 20 | Comprimento do segmento. Unidade: segundos. |
| TailSlateList | Array of TailSlate | Lista de partes finais. |
|
| TailSlate | |||
| Start | String | 00000.00 | Horário em que a parte final é reproduzida. |
| BgColor | String | White | Cor das barras adicionadas à parte final se o tamanho da parte final for menor que o da parte principal. Valor padrão: White. Para mais informações, consulte Cores de fundo. |
| IsMergeAudio | Boolean | true | Indica se o conteúdo de áudio da parte final deve ser mesclado. Valores válidos:
|
| Width | String | -1 | Largura da parte final. Valores válidos: valores no intervalo de (0, 4096), -1 e full.
|
| Height | String | -1 | Altura da parte final.
|
| BlendDuration | String | 0 | Tempo entre o fim da parte principal e o início da parte final. Durante a transição das partes de vídeo, o último quadro da parte principal desaparece gradualmente e o primeiro quadro da parte final surge gradualmente. Unidade: segundos. Valor padrão: 0. |
| TailUrl | String | http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv | URL do oss da parte final. |
| TemplateId | String | S00000001-200010 | ID do modelo. |
| SubtitleConfig | Object | Configuração de legenda. |
|
| ExtSubtitleList | Array of ExtSubtitle | Lista de legendas externas. |
|
| ExtSubtitle | |||
| CharEnc | String | auto | Conjunto de caracteres usado pela legenda externa.
Nota Se você definir este parâmetro como auto, o conjunto de caracteres detectado pode não ser o conjunto real. Recomendamos definir este parâmetro com outro valor. |
| FontName | String | "WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" | Fonte das legendas fixas convertidas a partir de legendas externas. Valor padrão: SimSum. Para mais informações, consulte Fontes. |
| Input | Object | Arquivo de legenda de entrada.
|
|
| Object | String | example-output.flv | Nome do objeto do oss usado como arquivo de mídia de entrada. |
| Location | String | oss-cn-hangzhou | ID da região do oss onde o arquivo de entrada reside. |
| Bucket | String | example-bucket-**** | Nome do bucket do oss onde o arquivo de entrada está armazenado. |
| SubtitleList | Array of Subtitle | Lista de legendas. |
|
| Subtitle | |||
| Map | String | 0:a:0 | Faixa de áudio. Formato: |
| Properties | Object | Propriedades da mídia. |
|
| Width | String | 720 | Largura do vídeo. |
| Height | String | 1280 | Altura do vídeo. |
| SourceLogos | Array of SourceLogo | Palavras-chave da camada não relacionada ao mecanismo. |
|
| SourceLogo | |||
| Source | String | example | Palavra-chave. |
| Duration | String | 17 | Duração. |
| Fps | String | 30 | Taxa de quadros. |
| Bitrate | String | 490 | Taxa de bits. |
| FileFormat | String | mp4 | Formato do arquivo de mídia de entrada. |
| Streams | Object | Fluxos de mídia contidos no arquivo de mídia de entrada. |
|
| VideoStreamList | Array of VideoStream | Lista de fluxos de vídeo. |
|
| VideoStream | |||
| Index | String | 0 | Número de sequência do fluxo de vídeo. O valor indica a posição do fluxo de vídeo entre todos os fluxos de vídeo. |
| Timebase | String | 1/15360 | Base de tempo. |
| AvgFPS | String | 30.0 | Taxa média de quadros. |
| PixFmt | String | yuv420p | Formato de pixel. |
| Sar | String | 1:1 | Proporção de aspecto da amostra (SAR) do fluxo de vídeo. |
| Lang | String | eng | Idioma do fluxo de legendas. Para mais informações, consulte Definição de idioma FFmpeg e ISO 639. |
| CodecLongName | String | H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 | Nome completo do formato de codificação. |
| Height | String | 1280 | Altura do fluxo de vídeo em pixels. |
| NumFrames | String | 30 | Número total de quadros. |
| Bitrate | String | 421.117 | Taxa de bits. |
| CodecTagString | String | avc1 | String de tag do formato de codificação. |
| HasBFrames | String | 2 | Indica se o fluxo de vídeo contém quadros bidirecionais (B-frames). |
| Profile | String | high | Perfil do codec. |
| StartTime | String | 0.000000 | Horário de início. |
| NetworkCost | Object | Largura de banda de rede consumida. |
|
| PreloadTime | String | 8 | Quantidade de tempo de pré-carregamento. |
| AvgBitrate | String | 300 | Taxa de bits média. |
| CostBandwidth | String | 10 | Largura de banda máxima consumida. |
| Dar | String | 9:16 | Proporção de aspecto de exibição (DAR). |
| CodecName | String | h264 | Nome curto do formato de codificação. |
| Width | String | 720 | Largura do vídeo em pixels. |
| Duration | String | 17.233333 | Duração. |
| Fps | String | 30.0 | Taxa de quadros. |
| CodecTag | String | 0x31637661 | Tag do formato de codificação. |
| CodecTimeBase | String | 1/60 | Base de tempo do codec. |
| Level | String | 31 | Nível do codec. |
| colorTransfer | String | bt709 | Configuração de transferência de cor. |
| colorPrimaries | String | bt709 | Cores primárias. |
| bitsPerRawSample | String | 8 | Número de bits binários usados por cada amostra ou pixel. |
| AudioStreamList | Array of AudioStream | Lista de fluxos de áudio. |
|
| AudioStream | |||
| Timebase | String | 1/32000 | Base de tempo. |
| Index | String | 1 | Número de sequência do fluxo de áudio. O valor indica a posição do fluxo de áudio entre todos os fluxos de áudio. |
| SampleFmt | String | fltp | Formato de amostragem. |
| ChannelLayout | String | mono | Layout de saída dos canais de som. |
| Lang | String | und | Idioma do fluxo de legendas. Para mais informações, consulte Definição de idioma FFmpeg e ISO 639. |
| Samplerate | String | 32000 | Taxa de amostragem. |
| CodecLongName | String | AAC (Advanced Audio Coding) | Nome completo do formato de codificação. |
| Channels | String | 1 | Número de canais de som. |
| NumFrames | String | 50 | Número total de quadros. |
| Bitrate | String | 64.136 | Taxa de bits. |
| CodecTagString | String | mp4 | String de tag do formato de codificação. |
| StartTime | String | 0.064000 | Horário de início. |
| CodecName | String | aac | Nome curto do formato de codificação. |
| Duration | String | 17.223562 | Duração. |
| CodecTag | String | 0x6134706d | Tag do formato de codificação. |
| CodecTimeBase | String | 1/32000 | Base de tempo do codec. |
| SubtitleStreamList | Array of SubtitleStream | Lista de fluxos de legendas. |
|
| SubtitleStream | |||
| Index | String | 1 | Número de sequência do fluxo de legendas. Este parâmetro indica a posição do fluxo de legendas entre todos os fluxos de legendas. |
| Lang | String | eng | Idioma do fluxo de legendas. Para mais informações, consulte Definição de idioma FFmpeg e ISO 639. |
| Format | Object | Informações de formato. |
|
| StartTime | String | -0.064000 | Horário de início. |
| NumPrograms | String | 0 | Número total de fluxos de programa. |
| Size | String | 1057273 | Tamanho do arquivo. |
| NumStreams | String | 2 | Número total de fluxos de mídia. |
| FormatLongName | String | QuickTime / MOV | Nome completo do formato de contêiner. |
| Duration | String | 17.234000 | Duração total. |
| Bitrate | String | 490.784 | Taxa de bits total. |
| FormatName | String | mov | Nome curto do formato de contêiner. Valores válidos: mov, mp4, m4a, 3gp, 3g2 e mj2. |
| FileSize | String | 1057273 | Tamanho do arquivo. |
| PipelineId | String | 88c6ca184c0e47b665e2a1267971**** | ID da fila do MPS. |
| Input | Object | Informações sobre a entrada do job. |
|
| Object | String | video_01.mp4 | Nome do objeto do oss usado como arquivo de mídia de entrada. |
| Location | String | oss-cn-shanghai | Região do oss onde o arquivo de entrada reside. |
| Bucket | String | exampleBucket | Nome do bucket do oss onde o arquivo de entrada está armazenado. |
| MNSMessageResult | Object | Mensagem enviada pelo Message Service (MNS) para notificar o usuário sobre o resultado do job. |
|
| MessageId | String | 123 | ID da mensagem de sucesso retornada quando o job é bem-sucedido. |
| ErrorMessage | String | The resource operated "%s" cannot be found. | Mensagem de erro retornada quando o job falha. Este parâmetro não é retornado se o job for bem-sucedido. |
| ErrorCode | String | InvalidParameter.ResourceNotFound | Código de erro retornado se o job falhar. Este parâmetro não é retornado se o job for bem-sucedido. |
Parâmetros de callback
Quando o status do job de transcodificação muda, o MPS envia uma mensagem para a fila MNS especificada. Para mais informações sobre como especificar uma fila MNS para receber callbacks, consulte o tópico UpdatePipeline.~~188374~~ A mensagem de callback é uma string JSON que contém os parâmetros descritos na tabela a seguir.
{
"Type": "Transcode",
"State": "Success",
"JobId": "39f8e0bc005e4f309379701645f4****",
"UserData": "{\"key\":\"value\"}",
"RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}
|
Parâmetro |
Tipo |
Descrição |
|
Type |
String |
Valor fixo como Transcode, indicando job de transcodificação. |
|
JobId |
String |
ID exclusivo do job. |
|
State |
String |
Status atual do job. O valor é o mesmo que o valor do parâmetro State retornado na operação QueryJobList. |
|
UserData |
String |
Dados do usuário especificados para o job na operação SubmitJobs. |
Exemplos
Solicitações de exemplo
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryJobList
&JobIds=bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd****
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryJobListResponse>
<NonExistJobIds>d1ce4d3efcb549419193f50f1fcd****</NonExistJobIds>
<RequestId>197ADF44-104C-514C-9F92-D8924CB34E2A</RequestId>
<JobList>
<CreationTime>2014-01-10T12:00:00Z</CreationTime>
<Percent>100</Percent>
<FinishTime>2014-01-10T12:20:25Z</FinishTime>
<State>TranscodeSuccess</State>
<JobId>31fa3c9ca8134fb4b0b0f7878301****</JobId>
<Code>InvalidParameter.NullValue</Code>
<Message>The specified parameter "%s" cannot be null.</Message>
<Output>
<Video>
<Bufsize>6000</Bufsize>
<Degrain>5</Degrain>
<BitrateBnd>
<Max>1000</Max>
<Min>300</Min>
</BitrateBnd>
<PixFmt>yuv420p</PixFmt>
<Pad>1280:800:0:140</Pad>
<Codec>H.264</Codec>
<Height>720</Height>
<Qscale>15</Qscale>
<Crop>1280:800:0:140</Crop>
<Bitrate>500</Bitrate>
<Maxrate>3000</Maxrate>
<MaxFps>60</MaxFps>
<Profile>high</Profile>
<Crf>26</Crf>
<Gop>250</Gop>
<Width>1280</Width>
<Fps>25</Fps>
<Preset>medium</Preset>
<ScanMode>interlaced</ScanMode>
<ResoPriority>1</ResoPriority>
</Video>
<TransConfig>
<IsCheckAudioBitrate>false</IsCheckAudioBitrate>
<TransMode>onepass</TransMode>
<IsCheckReso>false</IsCheckReso>
<IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
<AdjDarMethod>none</AdjDarMethod>
<IsCheckVideoBitrate>false</IsCheckVideoBitrate>
<IsCheckResoFail>false</IsCheckResoFail>
<IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
</TransConfig>
<Encryption>
<Type>hls-aes-128</Type>
<Key>encryptionkey128</Key>
<KeyType>Base64</KeyType>
<Id>31fa3c9ca8134f9cec2b4b0b0f78****</Id>
<KeyUri>https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/</KeyUri>
<SkipCnt>3</SkipCnt>
</Encryption>
<WaterMarkList>
<Type>Image</Type>
<ReferPos>TopRight</ReferPos>
<Dx>100</Dx>
<Width>50</Width>
<Height>50</Height>
<InputFile>
<Object>example-logo-****.png</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket</Bucket>
</InputFile>
<WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a12****</WaterMarkTemplateId>
<Dy>100</Dy>
</WaterMarkList>
<WaterMarkConfigUrl>http://example.com/configure</WaterMarkConfigUrl>
<DeWatermark>{"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}</DeWatermark>
<M3U8NonStandardSupport>
<TS>
<SizeSupport>true</SizeSupport>
<Md5Support>true</Md5Support>
</TS>
</M3U8NonStandardSupport>
<Priority>6</Priority>
<Audio>
<Profile>aaclow</Profile>
<Codec>aac</Codec>
<Samplerate>44100</Samplerate>
<Qscale>15</Qscale>
<Channels>2</Channels>
<Volume>
<Method>auto</Method>
<Level>-20</Level>
</Volume>
<Bitrate>128</Bitrate>
</Audio>
<AudioStreamMap>0:a:0</AudioStreamMap>
<MergeList>
<Start>01:59:59.999</Start>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<MergeURL>http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv</MergeURL>
<Duration>01:59:59.999</Duration>
</MergeList>
<SuperReso>
<IsHalfSample>true</IsHalfSample>
</SuperReso>
<UserData>testid-001</UserData>
<ExtendData>testid-002</ExtendData>
<OutSubtitleList>
<Map>0:v:0</Map>
<OutSubtitleFile>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<Object>example.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>exampleBucket</Bucket>
</OutSubtitleFile>
<Success>true</Success>
<Message>The specified parameter "%s" cannot be null.</Message>
</OutSubtitleList>
<VideoStreamMap>0</VideoStreamMap>
<OutputFile>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<Object>example-output.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket</Bucket>
</OutputFile>
<Rotate>90</Rotate>
<Container>
<Format>mp4</Format>
</Container>
<Clip>
<TimeSpan>
<Seek>01:59:59.999</Seek>
<Duration>01:00:59.999</Duration>
</TimeSpan>
</Clip>
<MergeConfigUrl>https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8</MergeConfigUrl>
<OpeningList>
<openUrl>http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4</openUrl>
<Start>0</Start>
<Width>-1</Width>
<Height>-1</Height>
</OpeningList>
<MuxConfig>
<Webp>
<Loop>0</Loop>
</Webp>
<Gif>
<FinalDelay>0</FinalDelay>
<DitherMode>bayer</DitherMode>
<Loop>0</Loop>
<IsCustomPalette>false</IsCustomPalette>
</Gif>
<Segment>
<Duration>20</Duration>
</Segment>
</MuxConfig>
<TailSlateList>
<Start>00000.00</Start>
<BgColor>White</BgColor>
<IsMergeAudio>true</IsMergeAudio>
<Width>-1</Width>
<Height>-1</Height>
<BlendDuration>0</BlendDuration>
<TailUrl>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv</TailUrl>
</TailSlateList>
<TemplateId>S00000001-200010</TemplateId>
<SubtitleConfig>
<ExtSubtitleList>
<CharEnc>auto</CharEnc>
<FontName>"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"</FontName>
<Input>
<Object>example-output.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket-****</Bucket>
</Input>
</ExtSubtitleList>
<SubtitleList>
<Map>0:a:0</Map>
</SubtitleList>
</SubtitleConfig>
<Properties>
<Width>720</Width>
<Height>1280</Height>
<SourceLogos>
<Source>example</Source>
</SourceLogos>
<Duration>17</Duration>
<Fps>30</Fps>
<Bitrate>490</Bitrate>
<FileFormat>mp4</FileFormat>
<Streams>
<VideoStreamList>
<Index>0</Index>
<Timebase>1/15360</Timebase>
<AvgFPS>30.0</AvgFPS>
<PixFmt>yuv420p</PixFmt>
<Sar>1:1</Sar>
<Lang>eng</Lang>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<Height>1280</Height>
<NumFrames>30</NumFrames>
<Bitrate>421.117</Bitrate>
<CodecTagString>avc1</CodecTagString>
<HasBFrames>2</HasBFrames>
<Profile>high</Profile>
<StartTime>0.000000</StartTime>
<NetworkCost>
<PreloadTime>8</PreloadTime>
<AvgBitrate>300</AvgBitrate>
<CostBandwidth>10</CostBandwidth>
</NetworkCost>
<Dar>9:16</Dar>
<CodecName>h264</CodecName>
<Width>720</Width>
<Duration>17.233333</Duration>
<Fps>30.0</Fps>
<CodecTag>0x31637661</CodecTag>
<CodecTimeBase>1/60</CodecTimeBase>
<Level>31</Level>
<colorTransfer>bt709</colorTransfer>
<colorPrimaries>bt709</colorPrimaries>
<bitsPerRawSample>8</bitsPerRawSample>
</VideoStreamList>
<AudioStreamList>
<Timebase>1/32000</Timebase>
<Index>1</Index>
<SampleFmt>fltp</SampleFmt>
<ChannelLayout>mono</ChannelLayout>
<Lang>und</Lang>
<Samplerate>32000</Samplerate>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<Channels>1</Channels>
<NumFrames>50</NumFrames>
<Bitrate>64.136</Bitrate>
<CodecTagString>mp4</CodecTagString>
<StartTime>0.064000</StartTime>
<CodecName>aac</CodecName>
<Duration>17.223562</Duration>
<CodecTag>0x6134706d</CodecTag>
<CodecTimeBase>1/32000</CodecTimeBase>
</AudioStreamList>
<SubtitleStreamList>
<Index>1</Index>
<Lang>eng</Lang>
</SubtitleStreamList>
</Streams>
<Format>
<StartTime>-0.064000</StartTime>
<NumPrograms>0</NumPrograms>
<Size>1057273</Size>
<NumStreams>2</NumStreams>
<FormatLongName>QuickTime / MOV</FormatLongName>
<Duration>17.234000</Duration>
<Bitrate>490.784</Bitrate>
<FormatName>mov</FormatName>
</Format>
<FileSize>1057273</FileSize>
</Properties>
</Output>
<PipelineId>88c6ca184c0e47b665e2a1267971****</PipelineId>
<Input>
<Object>video_01.mp4</Object>
<Location>oss-cn-shanghai</Location>
<Bucket>exampleBucket</Bucket>
</Input>
<MNSMessageResult>
<MessageId>123</MessageId>
<ErrorMessage>The resource operated "%s" cannot be found.</ErrorMessage>
<ErrorCode>InvalidParameter.ResourceNotFound</ErrorCode>
</MNSMessageResult>
</JobList>
</QueryJobListResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"NonExistJobIds" : [ "d1ce4d3efcb549419193f50f1fcd****" ],
"RequestId" : "197ADF44-104C-514C-9F92-D8924CB34E2A",
"JobList" : [ {
"CreationTime" : "2014-01-10T12:00:00Z",
"Percent" : 100,
"FinishTime" : "2014-01-10T12:20:25Z",
"State" : "TranscodeSuccess",
"JobId" : "31fa3c9ca8134fb4b0b0f7878301****",
"Code" : "InvalidParameter.NullValue",
"Message" : "The specified parameter \"%s\" cannot be null.",
"Output" : {
"Video" : {
"Bufsize" : "6000",
"Degrain" : "5",
"BitrateBnd" : {
"Max" : "1000",
"Min" : "300"
},
"PixFmt" : "yuv420p",
"Pad" : "1280:800:0:140",
"Codec" : "H.264",
"Height" : "720",
"Qscale" : "15",
"Crop" : "1280:800:0:140",
"Bitrate" : "500",
"Maxrate" : "3000",
"MaxFps" : "60",
"Profile" : "high",
"Crf" : "26",
"Gop" : "250",
"Width" : "1280",
"Fps" : "25",
"Preset" : "medium",
"ScanMode" : "interlaced",
"ResoPriority" : "1"
},
"TransConfig" : {
"IsCheckAudioBitrate" : "false",
"TransMode" : "onepass",
"IsCheckReso" : "false",
"IsCheckVideoBitrateFail" : "false",
"AdjDarMethod" : "none",
"IsCheckVideoBitrate" : "false",
"IsCheckResoFail" : "false",
"IsCheckAudioBitrateFail" : "false"
},
"Encryption" : {
"Type" : "hls-aes-128",
"Key" : "encryptionkey128",
"KeyType" : "Base64",
"Id" : "31fa3c9ca8134f9cec2b4b0b0f78****",
"KeyUri" : "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt" : "3"
},
"WaterMarkList" : [ {
"Type" : "Image",
"ReferPos" : "TopRight",
"Dx" : "100",
"Width" : "50",
"Height" : "50",
"InputFile" : {
"Object" : "example-logo-****.png",
"Location" : "oss-cn-hangzhou",
"Bucket" : "example-bucket"
},
"WaterMarkTemplateId" : "88c6ca184c0e47098a5b665e2a12****",
"Dy" : "100"
} ],
"WaterMarkConfigUrl" : "http://example.com/configure",
"DeWatermark" : "{\"0\":[{\"l\":10,\"t\":10,\"w\":10,\"h\":10},{\"l\":100,\"t\":0.1,\"w\":10,\"h\":10}],\"128000\":[],\"250000\":[{\"l\":0.2,\"t\":0.1,\"w\":0.01,\"h\":0.05}]}",
"M3U8NonStandardSupport" : {
"TS" : {
"SizeSupport" : true,
"Md5Support" : true
}
},
"Priority" : "6",
"Audio" : {
"Profile" : "aaclow",
"Codec" : "aac",
"Samplerate" : "44100",
"Qscale" : "15",
"Channels" : "2",
"Volume" : {
"Method" : "auto",
"Level" : "-20"
},
"Bitrate" : "128"
},
"AudioStreamMap" : "0:a:0",
"MergeList" : [ {
"Start" : "01:59:59.999",
"RoleArn" : "acs:ram::<your uid>:role/<your role name>",
"MergeURL" : "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
"Duration" : "01:59:59.999"
} ],
"SuperReso" : {
"IsHalfSample" : "true"
},
"UserData" : "testid-001",
"ExtendData" : "testid-002",
"OutSubtitleList" : [ {
"Map" : "0:v:0",
"OutSubtitleFile" : {
"RoleArn" : "acs:ram::<your uid>:role/<your role name>",
"Object" : "example.flv",
"Location" : "oss-cn-hangzhou",
"Bucket" : "exampleBucket"
},
"Success" : true,
"Message" : "The specified parameter "%s" cannot be null."
} ],
"VideoStreamMap" : "0",
"OutputFile" : {
"RoleArn" : "acs:ram::<your uid>:role/<your role name>",
"Object" : "example-output.flv",
"Location" : "oss-cn-hangzhou",
"Bucket" : "example-bucket"
},
"Rotate" : "90",
"Container" : {
"Format" : "mp4"
},
"Clip" : {
"TimeSpan" : {
"Seek" : "01:59:59.999",
"Duration" : "01:00:59.999"
}
},
"MergeConfigUrl" : "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
"OpeningList" : [ {
"openUrl" : "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
"Start" : "0",
"Width" : "-1",
"Height" : "-1"
} ],
"MuxConfig" : {
"Webp" : {
"Loop" : "0"
},
"Gif" : {
"FinalDelay" : "0",
"DitherMode" : "bayer",
"Loop" : "0",
"IsCustomPalette" : "false"
},
"Segment" : {
"Duration" : "20"
}
},
"TailSlateList" : [ {
"Start" : "00000.00",
"BgColor" : "White",
"IsMergeAudio" : true,
"Width" : "-1",
"Height" : "-1",
"BlendDuration" : "0",
"TailUrl" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
} ],
"TemplateId" : "S00000001-200010",
"SubtitleConfig" : {
"ExtSubtitleList" : [ {
"CharEnc" : "auto",
"FontName" : "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input" : {
"Object" : "example-output.flv",
"Location" : "oss-cn-hangzhou",
"Bucket" : "example-bucket-****"
}
} ],
"SubtitleList" : [ {
"Map" : "0:a:0"
} ]
},
"Properties" : {
"Width" : "720",
"Height" : "1280",
"SourceLogos" : [ {
"Source" : "example"
} ],
"Duration" : "17",
"Fps" : "30",
"Bitrate" : "490",
"FileFormat" : "mp4",
"Streams" : {
"VideoStreamList" : [ {
"Index" : "0",
"Timebase" : "1/15360",
"AvgFPS" : "30.0",
"PixFmt" : "yuv420p",
"Sar" : "1:1",
"Lang" : "eng",
"CodecLongName" : "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Height" : "1280",
"NumFrames" : "30",
"Bitrate" : "421.117",
"CodecTagString" : "avc1",
"HasBFrames" : "2",
"Profile" : "high",
"StartTime" : "0.000000",
"NetworkCost" : {
"PreloadTime" : "8",
"AvgBitrate" : "300",
"CostBandwidth" : "10"
},
"Dar" : "9:16",
"CodecName" : "h264",
"Width" : "720",
"Duration" : "17.233333",
"Fps" : "30.0",
"CodecTag" : "0x31637661",
"CodecTimeBase" : "1/60",
"Level" : "31",
"colorTransfer" : "bt709",
"colorPrimaries" : "bt709",
"bitsPerRawSample" : "8"
} ],
"AudioStreamList" : [ {
"Timebase" : "1/32000",
"Index" : "1",
"SampleFmt" : "fltp",
"ChannelLayout" : "mono",
"Lang" : "und",
"Samplerate" : "32000",
"CodecLongName" : "AAC (Advanced Audio Coding)",
"Channels" : "1",
"NumFrames" : "50",
"Bitrate" : "64.136",
"CodecTagString" : "mp4",
"StartTime" : "0.064000",
"CodecName" : "aac",
"Duration" : "17.223562",
"CodecTag" : "0x6134706d",
"CodecTimeBase" : "1/32000"
} ],
"SubtitleStreamList" : [ {
"Index" : "1",
"Lang" : "eng"
} ]
},
"Format" : {
"StartTime" : "-0.064000",
"NumPrograms" : "0",
"Size" : "1057273",
"NumStreams" : "2",
"FormatLongName" : "QuickTime / MOV",
"Duration" : "17.234000",
"Bitrate" : "490.784",
"FormatName" : "mov"
},
"FileSize" : "1057273"
}
},
"PipelineId" : "88c6ca184c0e47b665e2a1267971****",
"Input" : {
"Object" : "video_01.mp4",
"Location" : "oss-cn-shanghai",
"Bucket" : "exampleBucket"
},
"MNSMessageResult" : {
"MessageId" : "123",
"ErrorMessage" : "The resource operated "%s" cannot be found.",
"ErrorCode" : "InvalidParameter.ResourceNotFound"
}
} ]
}
Códigos de erro
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.