ApsaraVideo VOD:Télécharger des fichiers multimédias

Scénarios

• Téléchargement depuis la console : idéal pour une validation rapide ou l'exportation temporaire d'un petit nombre de fichiers.

• Téléchargement via une API : adapté au traitement automatisé par lots de fichiers.

• Téléchargement hors ligne via un SDK de lecteur : conçu pour les scénarios d'applications personnalisées.

Scénario 1 : Téléchargement depuis la console

Télécharger un seul fichier

La console est idéale pour télécharger quelques fichiers afin de valider rapidement ou tester.

1. Connectez-vous à la console ApsaraVideo VOD.

2. Dans le volet de navigation de gauche, choisissez Media Files > Audio/Video.

3. Repérez le fichier cible, cliquez sur Manage dans la colonne Actions, sélectionnez l'onglet Video URL ou Audio URL, puis cliquez sur Copy pour la définition souhaitée.

4. Collez l'URL copiée dans un navigateur ou un outil de téléchargement pour lancer le téléchargement.

Télécharger plusieurs fichiers

Utilisez la fonctionnalité d'exportation par lots pour exporter les informations relatives aux ressources multimédias de plusieurs fichiers.

1. Connectez-vous à la console ApsaraVideo VOD.

2. Dans le volet de navigation de gauche, choisissez Media Files, puis sélectionnez Audio/Video ou Image.

3. Utilisez le filtre ou la fonctionnalité de recherche pour localiser et sélectionner les fichiers à exporter.

4. Cliquez sur l'icône située dans le coin supérieur droit pour exporter les informations relatives aux ressources multimédias.

5. Collez les URL des ressources multimédias dans un navigateur ou un outil de téléchargement pour lancer le téléchargement.

Scénario 2 : Téléchargement via une API

Obtenir les URL de téléchargement

Utilisez les API suivantes pour obtenir les URL de téléchargement des fichiers source, des fichiers transcodés et des vignettes.

Obtenir les URL de téléchargement par lots

Télécharger les fichiers

L'exemple de SDK Python suivant automatise le téléchargement. D'autres exemples sont disponibles sur le Portail OpenAPI.

1. Préparez l'environnement.

   Installez le SDK VOD pour Python.

   pip install aliyun-python-sdk-vod

2. Obtenez l'URL de téléchargement.

   Appelez l'opération GetMezzanineInfo pour récupérer les informations sur le fichier source.

   import json
   from aliyunsdkcore.client import AcsClient
   from aliyunsdkvod.request.v20170321 import GetMezzanineInfoRequest
   
   # Initialize the client
   # Replace with your AccessKey ID, AccessKey secret, and region ID
   client = AcsClient('YOUR_ACCESS_KEY_ID', 'YOUR_ACCESS_KEY_SECRET', 'cn-shanghai')
   
   # 1. Create a request
   request = GetMezzanineInfoRequest()
   request.set_accept_format('json')
   request.set_VideoId("YOUR_VIDEO_ID") # Replace with your video ID
   request.set_OutputType("oss")  # Recommended: Returns the OSS storage address for lower cost
   request.set_AuthTimeout(3600)  # Set the URL validity period to 1 hour (3600 seconds)
   
   # 2. Send the request and get the response
   response = client.do_action_with_exception(request)
   result = json.loads(response)
   
   # 3. Parse the download URL
   download_url = result['Mezzanine']['FileURL']
   print(f"Source file download URL: {download_url}")
   
   # (Optional) Use the requests library to download the file
   import requests
   print("Starting file download...")
   file_response = requests.get(download_url, stream=True)
   if file_response.status_code == 200:
       with open('downloaded_video.mp4', 'wb') as f:
           for chunk in file_response.iter_content(chunk_size=8192):
               f.write(chunk)
       print("File downloaded successfully: downloaded_video.mp4")
   else:
       print(f"Download failed, status code: {file_response.status_code}")
       print(f"Error message: {file_response.text}")

Scénario 3 : Téléchargement hors ligne via un SDK de lecteur

VOD prend en charge la mise en cache des vidéos localement sur les appareils mobiles pour une lecture hors ligne selon deux modes : le téléchargement standard et le téléchargement sécurisé.

• Téléchargement standard : la vidéo n'est pas chiffrée et peut être copiée et lue par n'importe quel lecteur. Convient au contenu public ou aux scénarios où les droits d'auteur sont peu restrictifs.

• Téléchargement sécurisé : la vidéo est chiffrée et ne peut être lue que par un SDK ApsaraVideo Player intégré avec la clé correspondante. Convient aux cours payants et au contenu sensible aux droits d'auteur.

Étapes

1. Configurez le mode de téléchargement.

   1. Connectez-vous à la console ApsaraVideo VOD. Accédez à Configuration Management > CDN Configuration > Download Settings.

   2. Sélectionnez le téléchargement standard ou sécurisé. Pour le téléchargement sécurisé, générez et stockez la clé de chiffrement de manière sécurisée sur cette page.

2. Intégrez le SDK du lecteur.

   Intégrez le SDK ApsaraVideo Player dans votre projet Android ou iOS : Intégration du SDK Android, Intégration du SDK iOS.

3. Finalisez le téléchargement de la vidéo.

   Intégrez le module de téléchargement de vidéos dans votre projet Android ou iOS : Téléchargement de vidéos pour Android, Téléchargement de vidéos pour iOS.

Facturation

Les URL de téléchargement se répartissent en deux catégories :

• Adresse de stockage

  • Sans nom de domaine accéléré, les téléchargements utilisent directement l'adresse de stockage et engendrent des frais de trafic sortant.

• Adresse accélérée :

  • Si vous configurez un nom de domaine accéléré, les URL de téléchargement deviennent des URL accélérées, offrant des téléchargements plus rapides et entraînant des frais liés au service d'accélération.

  • Si vous configurez des listes noires et listes blanches, des restrictions telles que la protection contre le hotlinking par Referer et les listes noires IP s'appliquent, conformément aux règles de lecture en ligne.

FAQ

Pourquoi ne puis-je pas lire la vidéo téléchargée ?

Si la sortie transcodée utilise le chiffrement (tel que le chiffrement HLS), le fichier téléchargé reste chiffré. Utilisez le SDK ApsaraVideo Player pour le déchiffrer et le lire. Consultez la section Chiffrement vidéo.

Comment télécharger de nombreux fichiers multimédias ?

Utilisez SearchMedia - Recherche d'informations multimédias avec pagination pour récupérer les URL des fichiers, puis suivez le Scénario 2 : Téléchargement via API pour effectuer le téléchargement.