Cette rubrique explique comment utiliser le SDK de téléchargement côté serveur pour C ou C++ afin de transférer des fichiers multimédias vers ApsaraVideo VOD.
Processus de téléchargement
Le SDK de téléchargement pour C ou C++ suit le processus général des SDK ApsaraVideo VOD. Pour plus d'informations, consultez la section Processus de téléchargement. La suite décrit les étapes de base pour utiliser le SDK de téléchargement côté serveur pour C ou C++ :
Effectuez les configurations décrites dans la section Prérequis.
Intégrez le SDK de téléchargement côté serveur pour C ou C++. Pour plus d'informations, consultez la section Intégrer le SDK de téléchargement côté serveur pour C ou C++.
-
Configurez les informations de téléchargement pour implémenter la logique de transfert.
Pour savoir comment transférer des fichiers audio ou vidéo, consultez la section Scénario 1 : Transférer des fichiers audio et vidéo.
Pour savoir comment transférer des images, consultez la section Scénario 2 : Transférer des images.
Pour savoir comment transférer des ressources multimédias auxiliaires, consultez la section Scénario 3 : Transférer des ressources multimédias auxiliaires.
Prérequis
ApsaraVideo VOD est activé. Pour plus d'informations, consultez la page Activer ApsaraVideo VOD.
Les paramètres système requis pour le téléchargement, y compris le chemin de stockage dans la région spécifiée et les paramètres de rappel, sont configurés. Pour plus d'informations, consultez les pages Gérer les buckets de stockage et Configurer les rappels.
Un utilisateur RAM est créé et utilisé pour accéder à ApsaraVideo VOD. Afin de prévenir les risques de sécurité liés à la divulgation de la paire AccessKey de votre compte Alibaba Cloud, nous vous recommandons de créer un utilisateur RAM et de lui accorder les autorisations nécessaires pour accéder à ApsaraVideo VOD. Vous pouvez ensuite utiliser la paire AccessKey de l'utilisateur RAM pour accéder à ApsaraVideo VOD. Pour plus d'informations, consultez la page Créer un utilisateur RAM et accorder des autorisations.
-
Configurez les variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET. Pour plus d'informations, consultez la page Configurer les variables d'environnement sous Linux, macOS et Windows.
ImportantUne paire AccessKey de compte Alibaba Cloud dispose d'autorisations sur toutes les opérations API. Utilisez la paire AccessKey d'un utilisateur RAM pour appeler des opérations API ou effectuer des tâches d'exploitation et de maintenance courantes.
N'intégrez pas directement votre AccessKey ID et votre AccessKey Secret dans le code de votre projet. En cas de fuite, toutes les ressources de votre compte seraient compromises.
Facultatif. Créez un rôle pour l'utilisateur RAM et accordez-lui les autorisations nécessaires pour accéder à ApsaraVideo VOD si vous souhaitez accéder au service via Security Token Service (STS). Pour plus d'informations, consultez la page Obtenir un jeton STS.
Intégrer le SDK de téléchargement côté serveur pour C ou C++
Le SDK de téléchargement côté serveur pour C ou C++ ne peut être installé que sur le système d'exploitation Linux.
Cet exemple utilise la version 1.0.0 du SDK. Vous pouvez utiliser d'autres versions selon les besoins de votre activité.
Pour plus d'informations sur les répertoires du SDK de téléchargement côté serveur pour C ou C++ et sur l'exemple de code, consultez la section Répertoires.
Cette rubrique explique comment installer le SDK de téléchargement côté serveur pour C ou C++ en tant qu'utilisateur non root et fournit des exemples de commandes d'installation.
Le tableau suivant décrit les packages logiciels requis, leur utilisation et des exemples d'installation.
Package logiciel | Description | Installation via YUM | Installation via des packages téléchargés depuis Internet |
CMake | Compilateur tiers. |
|
|
libcurl | Résout les problèmes de connexion réseau. |
|
|
libuuid | Génère des UUID. | Exemple de code : | S.O. |
apr | S.O. | Exemple de code : |
|
apr-util | Gère l'utilisation de la mémoire et les problèmes multiplateformes. | Exemple de code : |
|
minixml | Analyse les données renvoyées au format XML. | Exemple de code : |
|
jsoncpp | Analyse les données renvoyées au format JSON. | Exemple de code : |
|
SDK OSS | Avant d'utiliser le SDK de téléchargement côté serveur pour C ou C++, vous devez télécharger et installer le SDK Object Storage Service (OSS) pour C ou C++. | S.O. | Pour plus d'informations sur le lien de téléchargement et la procédure d'installation, consultez la page Installation (SDK C). Important Si certaines dépendances OSS ont déjà été installées, il n'est pas nécessaire de les installer à nouveau. |
SDK de téléchargement pour C ou C++ | Transfère des fichiers multimédias. | S.O. |
|
Répertoires
/VodSDK-C_1.0.0.gz/VodSDK-C_1.0.0/aliyun-c-sdk-vod/src/upload.h
Répertoire | Description |
CreateUploadVideoRequest | Classe de requête pour le téléchargement de vidéos. Pour plus d'informations sur les paramètres, consultez la page CreateUploadVideo. |
CreateUploadImageRequest | Classe de requête pour le téléchargement d'images. Pour plus d'informations sur les paramètres, consultez la page CreateUploadImage. |
CreateUploadAttachedMediaRequest | Classe de requête pour le téléchargement de ressources multimédias auxiliaires. Pour plus d'informations sur les paramètres, consultez la page CreateUploadAttachedMedia. |
UploadOptions | Structure des paramètres de téléchargement. Les éléments suivants décrivent les paramètres.
|
uploadLocalVideo | Opération API utilisée pour télécharger des vidéos locales. |
uploadWebVideo | Opération API utilisée pour télécharger des vidéos en ligne. |
uploadLocalImage | Opération API utilisée pour télécharger des images locales. |
uploadWebImage | Opération API utilisée pour télécharger des images en ligne. |
uploadLocalAttachedMedia | Opération API utilisée pour télécharger des ressources multimédias auxiliaires locales. |
uploadWebAttachedMedia | Opération API utilisée pour télécharger des ressources multimédias auxiliaires en ligne. |
uploadLocalM3u8 | Opération API utilisée pour télécharger des vidéos M3U8 locales. |
uploadWebM3u8 | Opération API utilisée pour télécharger des vidéos M3U8 en ligne. |
/VodSDK-C_1.0.0.gz/VodSDK-C_1.0.0/aliyun-c-sdk-vod/samples
|
Répertoire |
Description |
|
uploadVideo.cpp |
Exemple de code pour le téléchargement de vidéos. |
|
uploadImage.cpp |
Exemple de code pour le téléchargement d'images. |
|
uploadAttachedMedia.cpp |
Exemple de code pour le téléchargement de ressources multimédias auxiliaires. |
Scénario 1 : Télécharger des fichiers audio et vidéo
Fichiers audio et vidéo standard
ApsaraVideo VOD vous permet de télécharger des fichiers audio ou vidéo selon l'une des méthodes suivantes :
Utilisez le téléchargement multipart pour transférer un fichier local. Vous pouvez transférer un fichier dont la taille atteint 48,8 To. La reprise de téléchargement n'est pas prise en charge. Pour plus d'informations, consultez la fonction testUploadLocalVideo dans l'exemple de code.
Utilisez l'URL du fichier pour transférer un fichier en ligne. Vous pouvez transférer un fichier dont la taille atteint 48,8 To. Avant de transférer des fichiers en ligne, vous devez les enregistrer sur un disque local. Assurez-vous que l'espace disque local est suffisant. Pour plus d'informations, consultez la fonction testUploadWebVideo dans l'exemple de code ci-dessous.