Chargez des fichiers multimédias depuis vos serveurs d'applications vers les compartiments Object Storage Service (OSS) alloués à ApsaraVideo VOD. ApsaraVideo VOD met à disposition des kits de développement logiciel (SDK) de chargement côté serveur pour les langages de programmation courants, ainsi que des démos. Ces SDK intègrent la logique d'obtention des URL de chargement et des informations d'identification. Une configuration minimale suffit avant de lancer les chargements. Cette rubrique décrit les cas d'utilisation, le processus de chargement et l'utilisation des SDK de chargement côté serveur.
Cas d'utilisation
Utilisez les SDK de chargement côté serveur pour automatiser les chargements ou transférer de grands volumes de fichiers vidéo ou de médias en ligne. Pour charger des médias en ligne, téléchargez-les d'abord sur un serveur d'application, puis transférez-les vers ApsaraVideo VOD depuis ce serveur.
Fonctionnalité | Description | Remarques |
Langages de programmation | Java, Python, PHP, C et C++ sont pris en charge. | Pour les autres langages, utilisez les SDK OSS. Pour plus d'informations, consultez Charger des fichiers multimédias à l'aide des SDK OSS. |
Fichiers multimédias pris en charge | Pour connaître les formats de fichiers multimédias pris en charge, consultez Chargement de médias. Vous pouvez charger des fichiers locaux et des fichiers en ligne. Les fichiers en ligne sont chargés via leurs URL. |
Remarque Pour charger des fichiers multimédias via des URL, encodez ces dernières afin d'éviter les échecs de chargement liés à la présence de caractères spéciaux. |
Adresses de stockage | Utilisez l'adresse de stockage par défaut ou spécifiez-en une autre. | Vous pouvez modifier l'adresse de stockage par défaut. Pour plus d'informations, consultez Gérer les compartiments de stockage. Le chargement via URL n'est disponible que dans la région Chine (Shanghai). Lors de l'appel à l'API pour obtenir une URL de chargement et des informations d'identification, définissez l'adresse de stockage via le paramètre StorageLocation. |
Chargement via réseau interne | Si vous déployez le script de chargement sur une instance Elastic Compute Service (ECS), indiquez sa région dans la logique de chargement. Si la région de l'instance ECS correspond à celle du stockage ApsaraVideo VOD, les fichiers sont automatiquement transférés via le réseau interne. Cela accélère le chargement et réduit la consommation de trafic Internet. | Les appels à l'API ApsaraVideo VOD doivent être effectués via des noms de domaine publics. Déployez le script de chargement sur une instance ECS disposant d'un accès à Internet. |
Gestion des ressources multimédias | Configurez les métadonnées des médias, telles que les titres, les tags, les catégories et les vignettes. | Lors de l'appel à l'opération pour obtenir une URL de chargement et des informations d'identification, configurez les métadonnées via les paramètres Title, Tags, CateId et CoverURL. |
Transcodage audio et vidéo | Appliquez un modèle de transcodage ou un workflow aux fichiers audio et vidéo chargés. Il est également possible de charger des fichiers audio et vidéo sans les transcoder. | Configurez le transcodage via les paramètres TemplateGroupId et WorkflowId lors de l'appel à l'opération pour obtenir une URL de chargement et des informations d'identification. |
Contrôle du chargement | Configurez la barre de progression du chargement et utilisez les rappels de progression par défaut ou personnalisés. La reprise sur erreur n'est prise en charge que par le SDK de chargement côté serveur pour Java. Les SDK pour les autres langages ne proposent pas cette fonctionnalité. | La configuration de la barre de progression n'est pas disponible pour les fichiers M3U8. |
Notifications d'événements | Configurez des rappels pour recevoir des notifications concernant les événements de chargement. Pour la liste des notifications prises en charge, consultez Chargement de médias. | Pour savoir comment configurer les rappels, consultez Configurer les rappels. |
Autorisation de chargement | Accordez l'autorisation de chargement via un identifiant de chargement. Dans ce cas, initialisez l'instance de chargement à l'aide d'une paire AccessKey associée à un compte Alibaba Cloud ou à un utilisateur RAM autorisé. Vous pouvez également utiliser un jeton Security Token Service (STS) pour accorder l'autorisation. Initialisez alors l'instance de chargement avec ce jeton STS. | Si vous optez pour un jeton STS, déployez un service dédié à l'obtention de ces jetons. |
Accélération du chargement | Cette fonctionnalité doit être activée au préalable. soumettre un ticket pour l'activer. | Une fois activée, configurez cette option en définissant |
ApsaraVideo VOD propose les opérations API suivantes pour obtenir les URL de chargement et les informations d'identification :
Processus de chargement
Les SDK de chargement côté serveur intègrent la logique d'obtention des URL de chargement et des informations d'identification, ainsi que la logique de chargement OSS. Une configuration minimale suffit avant de lancer les transferts. Le schéma ci-dessous illustre le processus complet.
Processus de chargement
Intégrez le SDK de chargement côté serveur à votre serveur d'application et finalisez les paramètres de chargement. Configurez notamment la paire AccessKey, le chemin du fichier, l'adresse de stockage, les informations sur la ressource multimédia, les options de transcodage et les paramètres de contrôle du chargement.
-
Le serveur d'application utilise le SDK de chargement côté serveur pour appeler une opération API et récupérer l'URL de chargement, les informations d'identification et les détails de la ressource multimédia.
RemarqueVous pouvez également construire manuellement une requête HTTP ou HTTPS pour obtenir l'URL et les informations d'identification. Toutefois, cette méthode implique la génération d'une signature et peut engendrer des erreurs. ApsaraVideo VOD fournit les opérations liées aux URL de chargement et aux informations d'identification suivantes :
-
ApsaraVideo VOD renvoie l'URL de chargement, les informations d'identification et l'ID du média au serveur d'application.
RemarqueApsaraVideo VOD génère les ID de média lors de la fourniture des URL de chargement et des informations d'identification. Ces ID sont essentiels pour la gestion du cycle de vie et le traitement des médias.
Pour une vidéo, l'ID du média est retourné dans le paramètre
VideoId.Pour une image, l'ID du média est retourné dans le paramètre
ImageId.Pour une ressource multimédia auxiliaire, l'ID du média est retourné dans le paramètre
MediaId.Conservez les ID de média renvoyés, car ils seront nécessaires pour les tâches ultérieures, telles que la gestion des ressources multimédias, la lecture audio/vidéo et le traitement des médias.
Le serveur d'application lance le chargement en s'appuyant sur la logique OSS intégrée au SDK de chargement côté serveur.
-
Le client OSS renvoie le résultat du chargement.
RemarqueVous avez également la possibilité de configurer un rappel à l'avance pour écouter le résultat du chargement.
Références
La procédure d'intégration et d'utilisation des SDK de chargement côté serveur varie selon le langage de programmation. Consultez les rubriques suivantes pour plus de détails :
Différences entre les SDK de chargement côté serveur et les SDK d'exploitation côté serveur
Les SDK de chargement côté serveur et les SDK d'exploitation côté serveur fournis par ApsaraVideo VOD sont distincts. Les SDK de chargement intègrent toute la logique de transfert : il suffit de les intégrer pour lancer les chargements. Les SDK d'exploitation couvrent l'ensemble des fonctionnalités d'ApsaraVideo VOD. Pour le chargement, ils se limitent à l'obtention de l'URL et des informations d'identification. Si vous utilisez ces derniers, vous devez développer vous-même la logique de chargement : obtenir l'URL et les informations d'identification auprès d'ApsaraVideo VOD, décoder les valeurs encodées en Base64, puis utiliser OSS pour transférer les fichiers. Pour plus d'informations sur les SDK d'exploitation côté serveur d'ApsaraVideo VOD, consultez Référence des SDK serveur.