Cette rubrique explique comment utiliser le SDK de téléversement côté serveur pour C ou C++ afin de téléverser des fichiers multimédias vers ApsaraVideo VOD.
Processus de téléversement
Le SDK de téléversement 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éversement. La suite décrit les étapes de base pour utiliser le SDK de téléversement côté serveur pour C ou C++ :
Effectuez les configurations décrites dans la section Prérequis.
Intégrez le SDK de téléversement côté serveur pour C ou C++. Pour plus d'informations, consultez la section Intégrer le SDK de téléversement côté serveur pour C ou C++.
-
Configurez les informations de téléversement pour implémenter la logique de téléversement.
Pour savoir comment téléverser des fichiers audio ou vidéo, consultez la section Scénario 1 : Téléverser des fichiers audio et vidéo.
Pour savoir comment téléverser des images, consultez la section Scénario 2 : Téléverser des images.
Pour savoir comment téléverser des ressources multimédias auxiliaires, consultez la section Scénario 3 : Téléverser 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éversement, 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 d'éviter les risques de sécurité liés à la divulgation de la paire de clés 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 de clés 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 de clés AccessKey de compte Alibaba Cloud dispose d'autorisations sur toutes les opérations API. Utilisez la paire de clés AccessKey d'un utilisateur RAM pour appeler des opérations API ou effectuer des opérations de maintenance courantes.
N'intégrez pas directement votre ID de clé AccessKey et votre secret de clé AccessKey dans le code de votre projet. En cas de divulgation, 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 y accéder via Security Token Service (STS). Pour plus d'informations, consultez la page Obtenir un jeton STS.
Intégrer le SDK de téléversement côté serveur pour C ou C++
Le SDK de téléversement 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 en fonction de vos besoins professionnels.
Pour plus d'informations sur les répertoires du SDK de téléversement côté serveur pour C ou C++ et sur les exemples de code, consultez la section Répertoires.
Cette rubrique décrit comment installer le SDK de téléversement 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 : | Non applicable |
apr | Non applicable | Exemple de code : |
|
apr-util | Gère l'utilisation de la mémoire et les problèmes interplateformes. | 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éversement côté serveur pour C ou C++, vous devez télécharger et installer le SDK Object Storage Service (OSS) pour C ou C++. | Non applicable | 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éversement pour C ou C++ | Téléverse des fichiers multimédias. | Non applicable |
|
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éversement de vidéos. Pour plus d'informations sur les paramètres, consultez la page CreateUploadVideo. |
CreateUploadImageRequest | Classe de requête pour le téléversement d'images. Pour plus d'informations sur les paramètres, consultez la page CreateUploadImage. |
CreateUploadAttachedMediaRequest | Classe de requête pour le téléversement 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éversement. Les éléments suivants décrivent les paramètres.
|
uploadLocalVideo | Opération API utilisée pour téléverser des vidéos locales. |
uploadWebVideo | Opération API utilisée pour téléverser des vidéos en ligne. |
uploadLocalImage | Opération API utilisée pour téléverser des images locales. |
uploadWebImage | Opération API utilisée pour téléverser des images en ligne. |
uploadLocalAttachedMedia | Opération API utilisée pour téléverser des ressources multimédias auxiliaires locales. |
uploadWebAttachedMedia | Opération API utilisée pour téléverser des ressources multimédias auxiliaires en ligne. |
uploadLocalM3u8 | Opération API utilisée pour téléverser des vidéos M3U8 locales. |
uploadWebM3u8 | Opération API utilisée pour téléverser 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éversement de vidéos.
| |
uploadImage.cpp
|
Exemple de code pour le téléversement d'images.
| |
uploadAttachedMedia.cpp
|
Exemple de code pour le téléversement de ressources multimédias auxiliaires.
|
Scénario 1 : Téléverser des fichiers audio et vidéo
Fichiers audio et vidéo standards
ApsaraVideo VOD vous permet de téléverser des fichiers audio ou vidéo selon l'une des méthodes suivantes :
Utilisez le téléversement multipartie pour téléverser un fichier local. Vous pouvez téléverser un fichier d'une taille maximale de 48,8 To. La reprise de téléversement 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 téléverser un fichier en ligne. Vous pouvez téléverser un fichier d'une taille maximale de 48,8 To. Avant de téléverser des fichiers en ligne, vous devez les télécharger sur un disque local. Assurez-vous que le disque local dispose d'un espace suffisant. Pour plus d'informations, consultez la fonction testUploadWebVideo dans l'exemple de code suivant.