GetPlayInfo - - Centre de documentation Alibaba Cloud

Obtient l'URL de lecture d'un fichier média (vidéo ou audio) par identifiant audio ou vidéo. Après avoir intégré le SDK Alibaba Cloud Player (pour la lecture basée sur URL) ou un lecteur tiers, vous pouvez utiliser l'URL pour la lecture audio et vidéo.

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.

ice:GetPlayInfo

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MediaId	string	Non	L'identifiant de la ressource média. Remarque Au moins l'un des paramètres MediaId et InputURL doit être spécifié.	86434e152b7d4f20be480574439fe***
InputURL	string	Non	L'URL d'entrée (InputURL) spécifiée lors de l'enregistrement de la ressource média. Pour plus d'informations, consultez RegisterMediaInfo. Remarque Au moins l'un des paramètres MediaId et InputURL doit être spécifié.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 or vod://**20b48fb04483915d4f2cd8ac**
AuthTimeout	integer	Non

É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.	****11-DB8D-4A9A-875B-275798****
MediaBase	object	Les informations sur la ressource média.
CreationTime	string	L'heure de création.	2021-09-22T10:07:31+08:00
Status	string	L'état de la ressource. Valeurs valides : Init : le fichier source n'est pas prêt. Preparing : le fichier source est en cours de préparation, par exemple en cours de téléchargement ou de composition. PrepareFail : la préparation du fichier source a échoué, par exemple échec de l'obtention des informations du fichier source. Normal : le fichier source est prêt.	Normal
MediaId	string	L'identifiant de la ressource média.	2eea77a61c7b4ddd95bec34a6f65b***
CoverURL	string	L'URL de la couverture.	https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg
Title	string	Le titre.	testTitle
MediaType	string	Le type de fichier média. Valeurs valides : video : vidéo. audio : audio uniquement.	video
MediaTags	string	Les balises. Un maximum de 16 balises est pris en charge. Séparez les balises multiples par des virgules (,). Chaque balise peut comporter jusqu'à 32 octets. L'encodage UTF-8 est utilisé.	test,ccc
CateId	integer	L'identifiant de la catégorie. Vous pouvez obtenir l'identifiant de la catégorie en utilisant les méthodes suivantes : Connectez-vous à la console IMS et choisissez Gestion des ressources média > Gestion des catégories pour afficher l'identifiant de la catégorie. Lorsque vous créez une catégorie en appelant l'opération de création de catégorie, l'identifiant de la catégorie est la valeur de CateId dans la réponse. Lorsque vous interrogez une catégorie en appelant l'opération d'obtention de catégorie, l'identifiant de la catégorie est la valeur de CateId dans la réponse.	4220
Description	string	La description du contenu.	desc
PlayInfoList	array<object>	Les informations de lecture audio ou vidéo (informations de flux).
	object	Les informations audio ou vidéo détaillées.
CreationTime	string	L'heure de création. L'heure suit le format : yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-05-10T02:28:49Z
Status	string	L'état du flux média. Valeurs valides : Normal : normal. Invisible : invisible.	Normal
NarrowBandType	string	Le type Narrowband HD. Valeurs valides : 0 : normal. 1.0 : Narrowband HD 1.0. 2.0 : Narrowband HD 2.0. Ce paramètre prend effet uniquement lorsque la définition d'un modèle de transcodage intégré Narrowband HD 1.0 est configurée. Pour plus d'informations, consultez Configuration du modèle de transcodage - Définition.	0
Height	integer	La hauteur du flux média. Unité : px.	1080
Bitrate	string	Le débit binaire du flux média. Unité : Kbps.	20
ModificationTime	string	L'heure de modification. L'heure suit le format : yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-05-13T11:39:41.714+08:00
WatermarkId	string	L'identifiant du filigrane associé au flux média actuel.	5bed88672b1e2520ead228935ed51***
Encrypt	integer	Indique si le flux média est chiffré. Valeurs valides : 0 : non chiffré. 1 : chiffré.	0
Definition	string	La définition du flux vidéo. Valeurs valides : FD : basse définition. LD : définition standard. SD : haute définition. HD : ultra-haute définition. OD : qualité d'origine. 2K : 2K. 4K : 4K. SQ : qualité sonore standard. HQ : haute qualité sonore. AUTO : débit binaire adaptatif.	HD
EncryptType	string	Le type de chiffrement du flux média. Valeurs valides : AliyunVoDEncryption : chiffrement vidéo Alibaba Cloud. HLSEncryption : chiffrement standard HLS. Remarque Si le type de chiffrement est AliyunVoDEncryption, seul le SDK Alibaba Cloud Player peut être utilisé pour la lecture.	AliyunVoDEncryption
StreamType	string	Le type de flux média. Si le flux média est une vidéo, la valeur est video. Si le flux média est uniquement audio, la valeur est audio.	video
Size	integer	La taille du flux média. Unité : octets.	418112
Width	integer	La largeur du flux média. Unité : px.	1024
Fps	string	La fréquence d'images du flux média. Unité : images par seconde.	25
Duration	string	La durée du flux média. Unité : secondes.	9.0464
PlayURL	string	L'URL de lecture du flux vidéo.	https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4
Format	string	Le format du flux média. Si le fichier média est une vidéo, les valeurs valides sont mp4 et m3u8. Si le fichier média est uniquement audio, la valeur est mp3.	mp4
HDRType	string	Le type HDR du flux média. Valeurs valides : HDR HDR10 HLG DolbyVision HDRVivid SDR+	HDR
BitDepth	integer	La profondeur de couleur.	8
FileURL	string	L'URL OSS du fichier.	http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg
TransTemplateType	string	Le type de modèle de transcodage. Valeurs valides : Normal : modèle normal. AudioTranscode : transcodage audio. Remux : conversion d'encapsulation. NarrowBandV1 : Narrowband HD 1.0. NarrowBandV2 : Narrowband HD 2.0. UHD : amélioration audio et vidéo (ultra-haute définition).	Normal
StreamTags	string	La balise de flux qui identifie le type de traitement de transcodage.	"{\"ims.audioServiceType\": \"AudioEnhancement\"}"
JobId	string	L'identifiant de la tâche.	36c9d38e70bf43ed9f7f8f48d6356***

Exemples

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaBase": {
    "CreationTime": "2021-09-22T10:07:31+08:00",
    "Status": "Normal",
    "MediaId": "2eea77a61c7b4ddd95bec34a6f65b***",
    "CoverURL": "https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg",
    "Title": "testTitle",
    "MediaType": "video",
    "MediaTags": "test,ccc",
    "CateId": 4220,
    "Description": "desc"
  },
  "PlayInfoList": [
    {
      "CreationTime": "2022-05-10T02:28:49Z",
      "Status": "Normal",
      "NarrowBandType": "0",
      "Height": 1080,
      "Bitrate": "20",
      "ModificationTime": "2022-05-13T11:39:41.714+08:00",
      "WatermarkId": "5bed88672b1e2520ead228935ed51***",
      "Encrypt": 0,
      "Definition": "HD",
      "EncryptType": "AliyunVoDEncryption",
      "StreamType": "video",
      "Size": 418112,
      "Width": 1024,
      "Fps": "25",
      "Duration": "9.0464",
      "PlayURL": "https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4",
      "Format": "mp4",
      "HDRType": "HDR",
      "BitDepth": 8,
      "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg",
      "TransTemplateType": "Normal",
      "StreamTags": "\"{\\\"ims.audioServiceType\\\": \\\"AudioEnhancement\\\"}\"",
      "JobId": "36c9d38e70bf43ed9f7f8f48d6356***"
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.