GetMezzanineInfo - - Centre de documentation Alibaba Cloud

Obtient les informations sur le fichier source d'un fichier audio ou vidéo, notamment l'URL du fichier, la résolution et le débit binaire.

Description de l'opération

Vous ne pouvez obtenir les informations complètes sur le fichier source qu'après le transcodage d'un flux vidéo ou audio.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vod:GetMezzanineInfo

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VideoId	string	Non	L'identifiant audio ou vidéo. Vous pouvez obtenir cet identifiant en utilisant l'une des méthodes suivantes :	1f1a6fc03ca04814031b8a6559e****
AuthTimeout	integer	Non	La période de validité de la signature pour FileURL (URL du fichier source). Unité : secondes. Valeur par défaut : 3600. La valeur minimale est 1.	3600
OutputType	string	Non	Le type d'URL de sortie. Valeurs valides :	oss
AdditionType	string	Non	Le type d'informations supplémentaires. Séparez les valeurs multiples par des virgules (,). Par défaut, seules les informations de base sont renvoyées. Valeurs valides :	video
ReferenceId	string	Non	L'identifiant personnalisé. Seules les lettres minuscules, les lettres majuscules, les chiffres, les traits d'union (-) et les traits de soulignement (_) sont pris en charge. La valeur doit comporter entre 6 et 64 caractères et être unique au niveau de l'utilisateur.	123-123

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4AF6-D7393642CA58****
Mezzanine	object	Les informations sur le fichier.
CreationTime	string	L'heure de création du fichier. L'heure est au format yyyy-MM-ddTHH:mm:ssZ (UTC).	2017-11-14T09:15:50Z
Status	string	L'état du fichier. Valeurs valides :	Normal
FileURL	string	L'URL du fichier source.	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1**.mp4
VideoId	string	L'identifiant de la vidéo.	1f1a6fc03ca04814031b8a6559e****
Height	integer	La hauteur du fichier. Unité : px.	540
Bitrate	string	Le débit binaire du fichier. Unité : Kbps.	771.2280
FileName	string	Le nom du fichier.	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
OutputType	string	Le type d'URL de sortie. Valeurs valides :	oss
PreprocessStatus	string	L'état du prétraitement. Valeurs valides :	UnPreprocess
Width	integer	La largeur du fichier. Unité : px.	960
Size	integer	La taille du fichier. Unité : octets.	4096477
Duration	string	La durée du fichier. Unité : secondes.	42.4930
Fps	string	La fréquence d'images du fichier, en images par seconde.	25.0000
AudioStreamList	array<object>	Les informations sur le flux audio.
	object	Les détails du flux audio.
Index	string	The sequence number of the audio stream, which identifies the position of the audio stream in the overall media stream.	0
Timebase	string	The time base.	0.000000
SampleFmt	string	The sample format.	fltp
SampleRate	string	The sample rate.	44100
ChannelLayout	string	The channel layout. Valid values: mono: mono. stereo: stereo.	mono
Lang	string	The language.	und
CodecLongName	string	The full name of the codec.	AAC (Advanced Audio Coding)
Channels	string	The number of sound channels.	1
NumFrames	string	The total number of frames.	1
Bitrate	string	The bitrate.	62.885
CodecTagString	string	The codec tag string.	mp4a
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2017-01-11T12:00:00Z
CodecName	string	The short name of the codec.	aac
Duration	string	The duration.	3.227574
CodecTag	string	The codec tag.	0x6134706d
CodecTimeBase	string	The codec time base.	1/44100
VideoStreamList	array<object>	Les informations sur le flux vidéo.
	object	Les détails du flux vidéo.
Timebase	string	The time base.	0.000000
Index	string	The sequence number of the video stream, which identifies the position of the video stream in the overall media stream.	1
AvgFPS	string	The average frame rate.	30.0
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language.	und
Sar	string	The sample aspect ratio.	0:1
Height	string	The height of the video resolution.	320
CodecLongName	string	The full name of the codec.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	The total number of frames.	0
Bitrate	string	The file bitrate. Unit: Kbps.	500
Rotate	string	The video rotation angle. Value range: [0, 360).	90
CodecTagString	string	The codec tag string.	avc1
HasBFrames	string	Indicates whether the video stream contains B-frames.	0
Profile	string	The codec profile.	Main
StartTime	string	The start time. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2017-01-11T12:00:00Z
Dar	string	The display aspect ratio.	0:1
CodecName	string	The short name of the codec.	h264
Width	string	The width of the video resolution.	568
Duration	string	The duration.	3.166667
Fps	string	The target frame rate.	30.0
CodecTag	string	The codec tag.	0x31637661
CodecTimeBase	string	The codec time base.	1/60
Level	string	The codec level.	30
HDRType	string	The HDR type of the video stream.	HDR
StorageClass	string	La classe de stockage de la ressource multimédia. Valeurs valides :	Standard
RestoreStatus	string	L'état de restauration de la ressource multimédia. Valeurs valides :	Succès
RestoreExpiration	string	L'heure d'expiration de la restauration de la ressource multimédia.	2023-03-30T10:14:14Z
FileMD5	string

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "Width": 960,
    "Size": 4096477,
    "Duration": "42.4930",
    "Fps": "25.0000",
    "AudioStreamList": [
      {
        "Index": "0",
        "Timebase": "0.000000",
        "SampleFmt": "fltp",
        "SampleRate": "44100",
        "ChannelLayout": "mono",
        "Lang": "und",
        "CodecLongName": "AAC (Advanced Audio Coding)",
        "Channels": "1",
        "NumFrames": "1",
        "Bitrate": "62.885",
        "CodecTagString": "mp4a",
        "StartTime": "2017-01-11T12:00:00Z",
        "CodecName": "aac",
        "Duration": "3.227574",
        "CodecTag": "0x6134706d",
        "CodecTimeBase": "1/44100"
      }
    ],
    "VideoStreamList": [
      {
        "Timebase": "0.000000",
        "Index": "1",
        "AvgFPS": "30.0",
        "PixFmt": "yuv420p",
        "Lang": "und",
        "Sar": "0:1",
        "Height": "320",
        "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
        "NumFrames": "0",
        "Bitrate": "500",
        "Rotate": "90",
        "CodecTagString": "avc1",
        "HasBFrames": "0",
        "Profile": "Main",
        "StartTime": "2017-01-11T12:00:00Z",
        "Dar": "0:1",
        "CodecName": "h264",
        "Width": "568",
        "Duration": "3.166667",
        "Fps": "30.0",
        "CodecTag": "0x31637661",
        "CodecTimeBase": "1/60",
        "Level": "30",
        "HDRType": "HDR"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.