Interroge plusieurs tâches de transcodage simultanément à partir de leurs identifiants.
Notes d'utilisation
Par défaut, les tâches retournées sont triées par ordre décroissant selon CreationTime.
Cette opération permet d'interroger jusqu'à 10 tâches de transcodage en une seule fois.
Si le paramètre JobIds n'est pas défini, le code d'erreur
InvalidParameterest retourné.
Limites QPS
Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Les requêtes dépassant cette limite sont rejetées, ce qui peut entraîner des interruptions de service. Nous vous recommandons de tenir compte de cette limite lors de vos appels. Pour plus d'informations, consultez Limite QPS.
Débogage
Paramètres de requête
| Paramètre | Type | Obligatoire | Exemple | Description |
| Action | String | Yes | QueryJobList | Opération à effectuer. Définissez la valeur sur QueryJobList. |
| JobIds | String | No | bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd**** | Identifiants des tâches de transcodage. Séparez les multiples ID par des virgules (,). Vous pouvez interroger un maximum de 10 tâches simultanément. Connectez-vous à la console ApsaraVideo Media Processing (MPS) et cliquez sur Tasks dans le volet de navigation de gauche pour obtenir ces identifiants. Vous pouvez également les récupérer via la réponse de l'opération SubmitJobs. Remarque Si le paramètre JobIds n'est pas défini, le code d'erreur InvalidParameter est retourné. |
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| NonExistJobIds | Array of String | d1ce4d3efcb549419193f50f1fcd**** | Liste des identifiants de tâches inexistants. Ce paramètre est absent de la réponse si tous les ID interrogés existent. |
| RequestId | String | 197ADF44-104C-514C-9F92-D8924CB34E2A | Identifiant de la requête. |
| JobList | Array of Job | Liste des tâches de transcodage. |
|
| Job | |||
| CreationTime | String | 2014-01-10T12:00:00Z | Date de création de la tâche. |
| Percent | Long | 100 | Progression du transcodage. |
| FinishTime | String | 2014-01-10T12:20:25Z | Heure de fin de la tâche de transcodage. |
| State | String | TranscodeSuccess | État de la tâche. Valeurs valides :
|
| JobId | String | 31fa3c9ca8134fb4b0b0f7878301**** | Identifiant de la tâche. |
| Code | String | InvalidParameter.NullValue | Code d'erreur retourné en cas d'échec du transcodage. Ce paramètre n'est pas présent si la tâche réussit. |
| Message | String | The specified parameter "%s" cannot be null. | Message retourné en cas d'échec de la tâche. Ce paramètre n'est pas présent si la tâche réussit. |
| Output | Object | Sortie de la tâche. |
|
| Video | Object | Configuration vidéo. |
|
| Bufsize | String | 6000 | Taille du tampon.
|
| Degrain | String | 5 | Niveau de l'algorithme indépendant de réduction du bruit. |
| BitrateBnd | Object | Plage de débit binaire moyen de la vidéo. |
|
| Max | String | 1000 | Débit binaire maximal. |
| Min | String | 300 | Débit binaire minimal. |
| PixFmt | String | yuv420p | Format de pixel pour l'encodage couleur vidéo. Les formats standard tels que yuv420p et yuvj420p sont pris en charge. |
| Pad | String | 1280:800:0:140 | Bandes noires à ajouter à la vidéo.
|
| Codec | String | H.264 | Codec utilisé.
|
| Height | String | 720 | Hauteur de la vidéo.
|
| Qscale | String | 15 | Niveau de contrôle qualité de la vidéo. |
| Crop | String | 1280:800:0:140 | Mode de recadrage. Deux modes sont disponibles :
|
| Bitrate | String | 500 | Débit binaire moyen de la vidéo. Unité : Kbit/s. |
| Maxrate | String | 3000 | Débit binaire maximal de la vidéo. Unité : Kbit/s. |
| MaxFps | String | 60 | Fréquence d'images maximale. |
| Profile | String | high | Profil du codec. Valeurs valides : baseline, main et high. Remarque En présence de définitions multiples, il est recommandé de définir ce paramètre sur baseline pour la définition la plus basse afin d'assurer une lecture fluide sur les appareils d'entrée de gamme. Utilisez main ou high pour les autres définitions.
|
| Crf | String | 26 | Facteur de taux constant.
|
| Gop | String | 250 | Intervalle maximal entre les images clés ou nombre maximal d'images dans un groupe d'images. Unité : secondes.
|
| Width | String | 1280 | Largeur de la vidéo.
|
| Fps | String | 25 | Fréquence d'images.
|
| Preset | String | medium | Algorithme vidéo prédéfini. Valeur par défaut : medium. Valeurs valides :
|
| ScanMode | String | interlaced | Mode de balayage. Valeurs valides :
|
| ResoPriority | String | 1 | Priorité de la ressource. |
| TransConfig | Object | Configuration générale du transcodage. Remarque Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de transcodage sélectionné. |
|
| IsCheckAudioBitrate | String | false | Indique si le débit binaire audio est vérifié. Lorsque cette fonctionnalité est activée et que le système détecte un débit audio sortant supérieur à celui de l'entrée, le débit audio original est conservé après transcodage. Dans ce cas, le paramètre Bitrate est ignoré. Ce paramètre a une priorité inférieure à IsCheckAudioBitrateFail.
|
| TransMode | String | onepass | Mode de transcodage.
|
| IsCheckReso | String | false | Indique si la résolution est vérifiée. Si la résolution de sortie dépasse celle d'entrée (en largeur ou en hauteur), le système aligne la résolution de sortie sur celle d'entrée.
|
| IsCheckVideoBitrateFail | String | false | Indique si le débit binaire vidéo est contrôlé. Si le débit vidéo sortant dépasse celui de l'entrée, le transcodage échoue sans être exécuté. Ce paramètre prévaut sur IsCheckVideoBitrate.
|
| AdjDarMethod | String | none | Méthode d'ajustement de la résolution. Valeur par défaut : none. Valeurs valides : rescale, crop, pad et none. |
| IsCheckVideoBitrate | String | false | Indique si le débit binaire vidéo est vérifié. Si le débit sortant dépasse celui de l'entrée, le système considère que le débit sortant équivaut au débit entrant.
|
| IsCheckResoFail | String | false | Indique si la résolution est vérifiée. Si la résolution de sortie dépasse celle d'entrée (en largeur ou en hauteur), une erreur de transcodage est retournée.
|
| IsCheckAudioBitrateFail | String | false | Indique si le débit binaire audio est contrôlé. Si le débit audio sortant dépasse celui de la source média, le transcodage échoue sans être exécuté. Cette valeur prévaut sur IsCheckAudioBitrate.
|
| Encryption | Object | Configuration de chiffrement. Seules les sorties au format M3U8 sont prises en charge. |
|
| Type | String | hls-aes-128 | Type de chiffrement. Valeur valide : hls-aes-128. |
| Key | String | encryptionkey128 | Clé utilisée pour chiffrer la vidéo. |
| KeyType | String | Base64 | Méthode de chiffrement de la clé. Valeurs valides : Base64 et KMS. Remarque Par exemple, si la clé est encryptionkey128, la valeur peut être Base64("encryptionkey128") ou KMS(Base64("encryptionkey128"), selon la méthode de chiffrement employée. |
| Id | String | 31fa3c9ca8134f9cec2b4b0b0f78**** | Identifiant de chiffrement. |
| KeyUri | String | https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ | URL permettant de demander la clé. Cette URL est encodée en Base64. |
| SkipCnt | String | 3 | Nombre d'images non chiffrées au début de la vidéo. Laisser ces images en clair permet d'accélérer le démarrage de la lecture. |
| WaterMarkList | Array of WaterMark | Liste des filigranes. |
|
| WaterMark | |||
| Type | String | Image | Type de filigrane. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. Pour plus d'informations, consultez Détails des paramètres. Valeurs valides :
|
| ReferPos | String | TopRight | Position du filigrane. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. Valeurs valides :
|
| Dx | String | 100 | Décalage horizontal de l'image du filigrane par rapport à la vidéo de sortie. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. Valeur par défaut : 0. La valeur peut être un entier ou un décimal.
|
| Width | String | 50 | Largeur du filigrane. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. La valeur peut être un entier ou un décimal.
|
| Height | String | 50 | Hauteur de l'image du filigrane. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. La valeur peut être un entier ou un décimal.
|
| InputFile | Object | Fichier source du filigrane. Vous pouvez utiliser une image PNG ou un fichier MOV comme source. |
|
| Object | String | example-logo-****.png | Nom de l'objet Object Storage Service (OSS) utilisé comme fichier source. |
| Location | String | oss-cn-hangzhou | Région OSS où réside le fichier source. |
| Bucket | String | example-bucket | Nom du bucket OSS contenant le fichier source. |
| WaterMarkTemplateId | String | 88c6ca184c0e47098a5b665e2a12**** | Identifiant du modèle de filigrane. |
| Dy | String | 100 | Décalage vertical de l'image du filigrane par rapport à la vidéo de sortie. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de filigrane. La valeur peut être un entier ou un décimal.
|
| WaterMarkConfigUrl | String | http://example.com/configure | URL du fichier de configuration du filigrane. |
| 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}]} | Configuration du floutage des filigranes. La valeur doit être un objet JSON. Pour plus d'informations, consultez Détails des paramètres. |
| M3U8NonStandardSupport | Object | Configuration de prise en charge non standard pour M3U8. La valeur doit être un objet JSON. Pour plus d'informations, consultez Détails des paramètres. |
|
| TS | Object | Configuration de prise en charge non standard M3U8 pour les fichiers TS. La valeur doit être un objet JSON. Pour plus d'informations, consultez Détails des paramètres. |
|
| SizeSupport | Boolean | true | Indique si la taille du fichier TS doit être incluse dans le fichier M3U8. Valeurs valides :
|
| Md5Support | Boolean | true | Indique si la valeur md5 du fichier TS doit être incluse dans le fichier M3U8. Valeurs valides :
|
| Priority | String | 6 | Priorité de la tâche dans la file d'attente MPS associée.
|
| Audio | Object | Configuration audio. Remarque Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de transcodage sélectionné. |
|
| Profile | String | aaclow | Profil de codec du fichier audio. Valeurs valides lorsque Codec est aac : aaclow, aache, aachev2, aacld et aaceld. |
| Codec | String | aac | Format d'encodage et de décodage audio.
|
| Samplerate | String | 44100 | Taux d'échantillonnage.
Remarque Si le conteneur vidéo est FLV et le codec audio MP3, vous ne pouvez pas définir ce paramètre sur 32000, 48000 ou 96000. Si le codec audio est MP3, la valeur 96000 est interdite. |
| Qscale | String | 15 | Niveau de contrôle qualité de l'audio. |
| Channels | String | 2 | Nombre de canaux audio.
|
| Volume | Object | Configuration du volume. |
|
| Method | String | auto | Méthode d'ajustement du volume. Valeurs valides :
|
| Level | String | -20 | Plage d'ajustement du volume. Valeur par défaut : -20db. |
| Bitrate | String | 128 | Débit binaire audio du fichier de sortie.
|
| AudioStreamMap | String | 0:a:0 | Numéro de séquence du flux audio.
|
| MergeList | Array of Merge | Configuration de fusion. Quatre URL peuvent être fusionnées au maximum. |
|
| Merge | |||
| Start | String | 01:59:59.999 | Point de départ temporel du clip.
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN (Alibaba Cloud Resource Name) du rôle utilisé pour l'autorisation par délégation. |
| MergeURL | String | http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv | URL OSS du clip.
|
| Duration | String | 01:59:59.999 | Durée du clip.
|
| SuperReso | Object | Indique que la résolution de la vidéo source est utilisée. |
|
| IsHalfSample | String | true | Indique s'il faut récupérer les paramètres liés au taux d'échantillonnage. Valeurs valides :
|
| UserData | String | testid-001 | Données personnalisées. |
| ExtendData | String | testid-002 | Champs personnalisés. |
| OutSubtitleList | Array of OutSubtitle | Liste des sous-titres de sortie. |
|
| OutSubtitle | |||
| Map | String | 0:v:0 | Piste vidéo. Format : |
| OutSubtitleFile | Object | Détails du fichier de sortie. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN du rôle utilisé pour l'autorisation par délégation. |
| Object | String | example.flv | Nom de l'objet OSS utilisé comme fichier de sortie. |
| Location | String | oss-cn-hangzhou | Identifiant de la région OSS où réside le fichier de sortie. |
| Bucket | String | exampleBucket | Bucket OSS contenant le fichier de sortie. |
| Success | Boolean | true | Indique si la tâche a réussi. Valeurs valides :
|
| Message | String | The specified parameter "%s" cannot be null. | Message d'erreur retourné si la création de la tâche échoue. Ce paramètre est absent si la tâche est créée avec succès. |
| VideoStreamMap | String | 0 | Numéro de séquence du flux vidéo. Ce numéro correspond à l'index du flux vidéo dans la liste, commençant à 0. Si le paramètre correspondant n'est pas défini dans la requête, le flux vidéo par défaut est sélectionné. |
| OutputFile | Object | Informations relatives au fichier de sortie. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN du rôle utilisé pour l'autorisation par délégation. |
| Object | String | example-output.flv | Nom de l'objet OSS utilisé comme fichier de sortie. |
| Location | String | oss-cn-hangzhou | Identifiant de la région OSS où réside le fichier de sortie. |
| Bucket | String | example-bucket | Bucket OSS contenant le fichier de sortie. |
| Rotate | String | 90 | Angle de rotation de la vidéo. |
| Container | Object | Configuration du conteneur. |
|
| Format | String | mp4 | Format du conteneur.
|
| Clip | Object | Informations sur le clip média. |
|
| TimeSpan | Object | Plage temporelle du clip. |
|
| Seek | String | 01:59:59.999 | Instant de début du clip.
Ou
|
| Duration | String | 01:00:59.999 | Durée du clip.
Ou
|
| MergeConfigUrl | String | https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8 | URL du fichier de configuration de fusion. Vous ne pouvez spécifier qu'un seul des paramètres MergeList ou MergeConfigUrl.
|
| OpeningList | Array of Opening | Liste des séquences d'introduction. La valeur est un objet JSON. |
|
| Opening | |||
| openUrl | String | http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4 | URL OSS de la séquence d'introduction vidéo. |
| Start | String | 0 | Délai avant le lancement de la séquence d'introduction.
|
| Width | String | -1 | Largeur de la séquence d'introduction.
|
| Height | String | -1 | Hauteur de la séquence d'introduction.
|
| MuxConfig | Object | Configuration de transmuxing. Si ce paramètre est spécifié dans la requête, sa valeur remplace celle du paramètre correspondant dans le modèle de transcodage sélectionné. |
|
| Webp | Object | Configuration de transmuxing pour WebP. |
|
| Loop | String | 0 | Nombre de boucles. |
| Gif | Object | Configuration de transmuxing pour GIF. |
|
| FinalDelay | String | 0 | Durée de pause de la dernière image. Unité : centisecondes. |
| DitherMode | String | bayer | Algorithme de tramage des couleurs de la palette. Valeurs valides : sierra et bayer. |
| Loop | String | 0 | Nombre de boucles. |
| IsCustomPalette | String | false | Indique si une palette personnalisée est utilisée. Valeurs valides :
|
| Segment | Object | Configuration de segmentation. La valeur est un objet JSON. |
|
| Duration | String | 20 | Longueur du segment. Unité : secondes. |
| TailSlateList | Array of TailSlate | Liste des séquences de fin. |
|
| TailSlate | |||
| Start | String | 00000.00 | Instant de lecture de la séquence de fin. |
| BgColor | String | White | Couleur des bandes ajoutées à la séquence de fin si ses dimensions sont inférieures à celles de la partie principale. Valeur par défaut : White. Pour plus d'informations, consultez Couleurs d'arrière-plan. |
| IsMergeAudio | Boolean | true | Indique s'il faut fusionner le contenu audio de la séquence de fin. Valeurs valides :
|
| Width | String | -1 | Largeur de la séquence de fin. Valeurs valides : valeurs dans l'intervalle (0, 4096), -1 et full.
|
| Height | String | -1 | Hauteur de la séquence de fin.
|
| BlendDuration | String | 0 | Durée de transition entre la fin de la partie principale et le début de la séquence de fin. Lors de cette transition, la dernière image de la partie principale s'estompe tandis que la première image de la séquence de fin apparaît progressivement. Unité : secondes. Valeur par défaut : 0. |
| TailUrl | String | http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv | URL OSS de la séquence de fin. |
| TemplateId | String | S00000001-200010 | Identifiant du modèle. |
| SubtitleConfig | Object | Configuration des sous-titres. |
|
| ExtSubtitleList | Array of ExtSubtitle | Liste des sous-titres externes. |
|
| ExtSubtitle | |||
| CharEnc | String | auto | Jeu de caractères utilisé par le sous-titre externe.
Remarque Si vous définissez ce paramètre sur auto, le jeu de caractères détecté peut ne pas correspondre au jeu réel. Nous vous recommandons de choisir une autre valeur. |
| FontName | String | "WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" | Police des sous-titres incrustés convertis à partir de sous-titres externes. Valeur par défaut : SimSum. Pour plus d'informations, consultez Polices. |
| Input | Object | Fichier de sous-titres source.
|
|
| Object | String | example-output.flv | Nom de l'objet OSS utilisé comme fichier média source. |
| Location | String | oss-cn-hangzhou | Identifiant de la région OSS où réside le fichier source. |
| Bucket | String | example-bucket-**** | Nom du bucket OSS contenant le fichier source. |
| SubtitleList | Array of Subtitle | Liste des sous-titres. |
|
| Subtitle | |||
| Map | String | 0:a:0 | Piste audio. Format : |
| Properties | Object | Propriétés du média. |
|
| Width | String | 720 | Largeur de la vidéo. |
| Height | String | 1280 | Hauteur de la vidéo. |
| SourceLogos | Array of SourceLogo | Mots-clés de couche non moteur. |
|
| SourceLogo | |||
| Source | String | example | Mot-clé. |
| Duration | String | 17 | Durée. |
| Fps | String | 30 | Fréquence d'images. |
| Bitrate | String | 490 | Débit binaire. |
| FileFormat | String | mp4 | Format du fichier média source. |
| Streams | Object | Flux médias contenus dans le fichier source. |
|
| VideoStreamList | Array of VideoStream | Liste des flux vidéo. |
|
| VideoStream | |||
| Index | String | 0 | Numéro de séquence du flux vidéo. Cette valeur indique la position du flux parmi l'ensemble des flux vidéo. |
| Timebase | String | 1/15360 | Base de temps. |
| AvgFPS | String | 30.0 | Fréquence d'images moyenne. |
| PixFmt | String | yuv420p | Format de pixel. |
| Sar | String | 1:1 | Rapport d'aspect d'échantillonnage (SAR) du flux vidéo. |
| Lang | String | eng | Langue du flux de sous-titres. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO 639. |
| CodecLongName | String | H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 | Nom complet du format d'encodage. |
| Height | String | 1280 | Hauteur du flux vidéo en pixels. |
| NumFrames | String | 30 | Nombre total d'images. |
| Bitrate | String | 421.117 | Débit binaire. |
| CodecTagString | String | avc1 | Chaîne de balise du format d'encodage. |
| HasBFrames | String | 2 | Indique si le flux vidéo contient des images bidirectionnelles (B-frames). |
| Profile | String | high | Profil du codec. |
| StartTime | String | 0.000000 | Heure de début. |
| NetworkCost | Object | Bande passante réseau consommée. |
|
| PreloadTime | String | 8 | Temps de préchargement. |
| AvgBitrate | String | 300 | Débit binaire moyen. |
| CostBandwidth | String | 10 | Bande passante maximale consommée. |
| Dar | String | 9:16 | Rapport d'aspect d'affichage (DAR). |
| CodecName | String | h264 | Nom court du format d'encodage. |
| Width | String | 720 | Largeur de la vidéo en pixels. |
| Duration | String | 17.233333 | Durée. |
| Fps | String | 30.0 | Fréquence d'images. |
| CodecTag | String | 0x31637661 | Balise du format d'encodage. |
| CodecTimeBase | String | 1/60 | Base de temps du codec. |
| Level | String | 31 | Niveau du codec. |
| colorTransfer | String | bt709 | Configuration de transfert colorimétrique. |
| colorPrimaries | String | bt709 | Couleurs primaires. |
| bitsPerRawSample | String | 8 | Nombre de bits binaires utilisés par chaque échantillon ou pixel. |
| AudioStreamList | Array of AudioStream | Liste des flux audio. |
|
| AudioStream | |||
| Timebase | String | 1/32000 | Base de temps. |
| Index | String | 1 | Numéro de séquence du flux audio. Cette valeur indique la position du flux parmi l'ensemble des flux audio. |
| SampleFmt | String | fltp | Format d'échantillonnage. |
| ChannelLayout | String | mono | Disposition de sortie des canaux audio. |
| Lang | String | und | Langue du flux de sous-titres. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO 639. |
| Samplerate | String | 32000 | Taux d'échantillonnage. |
| CodecLongName | String | AAC (Advanced Audio Coding) | Nom complet du format d'encodage. |
| Channels | String | 1 | Nombre de canaux audio. |
| NumFrames | String | 50 | Nombre total d'images. |
| Bitrate | String | 64.136 | Débit binaire. |
| CodecTagString | String | mp4 | Chaîne de balise du format d'encodage. |
| StartTime | String | 0.064000 | Heure de début. |
| CodecName | String | aac | Nom court du format d'encodage. |
| Duration | String | 17.223562 | Durée. |
| CodecTag | String | 0x6134706d | Balise du format d'encodage. |
| CodecTimeBase | String | 1/32000 | Base de temps du codec. |
| SubtitleStreamList | Array of SubtitleStream | Liste des flux de sous-titres. |
|
| SubtitleStream | |||
| Index | String | 1 | Numéro de séquence du flux de sous-titres. Ce paramètre indique la position du flux parmi l'ensemble des flux de sous-titres. |
| Lang | String | eng | Langue du flux de sous-titres. Pour plus d'informations, consultez Définition des langues FFmpeg et ISO 639. |
| Format | Object | Informations de format. |
|
| StartTime | String | -0.064000 | Heure de début. |
| NumPrograms | String | 0 | Nombre total de flux programme. |
| Size | String | 1057273 | Taille du fichier. |
| NumStreams | String | 2 | Nombre total de flux médias. |
| FormatLongName | String | QuickTime / MOV | Nom complet du format de conteneur. |
| Duration | String | 17.234000 | Durée totale. |
| Bitrate | String | 490.784 | Débit binaire total. |
| FormatName | String | mov | Nom court du format de conteneur. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2. |
| FileSize | String | 1057273 | Taille du fichier. |
| PipelineId | String | 88c6ca184c0e47b665e2a1267971**** | Identifiant de la file d'attente MPS. |
| Input | Object | Informations sur l'entrée de la tâche. |
|
| Object | String | video_01.mp4 | Nom de l'objet OSS utilisé comme fichier média source. |
| Location | String | oss-cn-shanghai | Région OSS où réside le fichier source. |
| Bucket | String | exampleBucket | Nom du bucket OSS contenant le fichier source. |
| MNSMessageResult | Object | Message envoyé par Message Service (MNS) pour notifier l'utilisateur du résultat de la tâche. |
|
| MessageId | String | 123 | Identifiant du message de succès retourné lorsque la tâche aboutit. |
| ErrorMessage | String | The resource operated "%s" cannot be found. | Message d'erreur retourné lorsque la tâche échoue. Ce paramètre est absent si la tâche réussit. |
| ErrorCode | String | InvalidParameter.ResourceNotFound | Code d'erreur retourné si la tâche échoue. Ce paramètre est absent si la tâche réussit. |
Paramètres de rappel
Lorsque l'état de la tâche de transcodage change, MPS envoie un message à la file d'attente MNS spécifiée. Pour savoir comment configurer une file d'attente MNS pour recevoir les rappels, consultez la rubrique UpdatePipeline.~~188374~~ Le message de rappel est une chaîne JSON contenant les paramètres décrits dans le tableau suivant.
{
"Type": "Transcode",
"State": "Success",
"JobId": "39f8e0bc005e4f309379701645f4****",
"UserData": "{\"key\":\"value\"}",
"RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}
|
Paramètre |
Type |
Description |
|
Type |
String |
La valeur est fixée à Transcode, indiquant une tâche de transcodage. |
|
JobId |
String |
Identifiant unique de la tâche. |
|
State |
String |
État actuel de la tâche. La valeur correspond à celle du paramètre State retourné par l'opération QueryJobList. |
|
UserData |
String |
Données utilisateur spécifiées pour la tâche lors de l'opération SubmitJobs. |
Exemples
Exemples de requêtes
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryJobList
&JobIds=bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd****
&<Common request parameters>
Exemples de réponses réussies
Format 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>
Format 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"
}
} ]
}
Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez Codes d'erreur du service.