ApsaraVideo VOD:Upload from clients

Méthode 1 : URL de téléchargement et information d'identification (recommandé)

Cette méthode offre une configuration plus simple, une sécurité accrue grâce au contrôle des autorisations par vidéo et des paramètres de réponse plus flexibles. Elle convient à la majorité des scénarios de téléchargement côté client.

Étape 1 : Obtenir l'URL de téléchargement et l'information d'identification

Le client envoie une requête HTTP à votre AppServer avec les métadonnées du média (telles que Title, FileName, CateId et Tags). Votre AppServer utilise ses clés AK/SK pour appeler CreateUploadVideo sur VOD, qui renvoie trois valeurs clés : UploadAuth (jeton de téléchargement temporaire), UploadAddress (chemin OSS cible, encodé en Base64) et VideoId (identifiant unique du média). Votre AppServer transmet ces éléments au client.

Étape 2 : Construire les paramètres de téléchargement et télécharger directement vers OSS

Le client initialise le SDK de téléchargement avec UploadAuth, UploadAddress et VideoId, ainsi qu'avec le chemin du fichier local. Le SDK analyse automatiquement UploadAddress pour obtenir l'endpoint OSS et la clé d'objet, puis télécharge le fichier directement vers OSS. Ce processus prend en charge le téléchargement multipartie et la reprise après interruption. Les fichiers transitent directement du client vers OSS sans passer par votre serveur.

Étape 3 : Résultat du téléchargement

Une fois le téléchargement terminé par OSS, le SDK déclenche le rappel onUploadSucceed, qui contient le VideoId. VOD détecte automatiquement la fin du téléchargement et lance les pipelines de transcodage et de traitement en fonction de votre TemplateGroupId ou WorkflowId configuré. Vous pouvez également configurer des rappels d'événements (HTTP ou MNS) pour recevoir les notifications d'événement FileUploadComplete.

Méthode 2 : Jeton STS

Étape 1 : Obtenir les informations d'identification temporaires STS

Le client demande des informations d'identification temporaires à votre AppServer. Votre AppServer utilise ses clés AK/SK pour appeler AssumeRole sur STS, obtenant ainsi un ensemble limité dans le temps de AccessKeyId, AccessKeySecret et SecurityToken (validité : 900 à 3 600 secondes), qui sont renvoyés au client.

Étape 2 : Obtenir les informations d'identification de téléchargement et télécharger (géré automatiquement par le SDK)

Le client initialise le SDK de téléchargement avec le jeton STS. Le SDK transmet automatiquement le jeton STS pour appeler CreateUploadVideo (avec Title, FileName et d'autres paramètres), obtient UploadAuth, UploadAddress et VideoId, puis exécute automatiquement le téléchargement multipartie. L'ensemble du processus est transparent pour le développeur — aucun appel manuel à l'API VOD n'est nécessaire.

Étape 3 : Résultat du téléchargement

Identique à la méthode 1 — le SDK déclenche onUploadSucceed avec le VideoId, et VOD traite le fichier automatiquement.

Téléchargement multipartie

Le téléchargement multipartie divise les fichiers volumineux en parties plus petites et les télécharge en parallèle. Cela améliore à la fois la vitesse et la fiabilité du téléchargement pour les grands fichiers multimédias, car une panne de réseau ne nécessite de retenter que les parties échouées plutôt que de retélécharger l'intégralité du fichier. Le téléchargement multipartie est activé par défaut dans tous les SDK de téléchargement côté client et ne nécessite aucune configuration supplémentaire.

Reprise après interruption

La reprise après interruption permet au SDK de continuer un téléchargement interrompu à partir de la dernière partie téléchargée avec succès, au lieu de recommencer depuis le début. Lorsqu'une déconnexion réseau, une mise en arrière-plan de l'application ou une mise en veille de l'appareil interrompt un téléchargement, le SDK stocke les données de point de contrôle en interne. Une fois la connexion rétablie et l'application reprise, le SDK reprend automatiquement le téléchargement à partir du point de contrôle sans intervention du développeur.

Contrôle du téléchargement

Le SDK de téléchargement fournit des API programmatiques pour démarrer, arrêter, mettre en pause et reprendre des téléchargements individuels. Cela s'avère utile lorsque vous devez respecter les actions initiées par l'utilisateur, comme l'annulation d'un téléchargement lorsque l'utilisateur quitte la page, ou gérer la concurrence des téléchargements dans des scénarios par lots. Vous contrôlez entièrement le cycle de vie du téléchargement via des appels de méthodes du SDK.

Rappels de progression

Le SDK expose des rappels de progression granulaires qui indiquent le pourcentage de données téléchargées pour chaque fichier. Utilisez ces rappels pour mettre à jour les barres de progression, afficher les vitesses de téléchargement ou déclencher une logique conditionnelle, telle que la désactivation de certains éléments d'interface utilisateur pendant un téléchargement en cours. Les rappels de progression sont émis à intervalles réguliers pendant le téléchargement, offrant une visibilité en temps réel sur l'état du transfert.

Changement de réseau

Les clients mobiles passent fréquemment d'un réseau Wi-Fi à un réseau cellulaire. Le SDK prend en charge la mise en pause et la reprise des téléchargements pour gérer ces transitions. Pour éviter de consommer des données mobiles, appelez la méthode de pause lorsque l'appareil bascule sur un réseau mobile et appelez la méthode de reprise lorsque le Wi-Fi est rétabli. Votre application doit implémenter la logique de détection de transition réseau.

Téléchargement par lots

Le SDK gère une file d'attente de téléchargement qui permet d'ajouter, de supprimer, d'annuler, de reprendre et de parcourir plusieurs fichiers. Vous pouvez vider l'intégralité de la file d'attente ou manipuler des entrées individuelles. Le téléchargement par lots est utile dans les scénarios où les utilisateurs sélectionnent plusieurs fichiers multimédias à la fois, comme lors du téléchargement d'une galerie photo, et le SDK les planifie séquentiellement ou en parallèle en fonction des ressources disponibles.

Prise en charge des métadonnées

Lors de l'obtention des informations d'identification de téléchargement, vous pouvez joindre des métadonnées à l'actif multimédia en cours de téléchargement. Les champs de métadonnées pris en charge incluent Title, Tags, CateId, CoverURL, TemplateGroupId et WorkflowId. La définition des métadonnées à l'étape des informations d'identification garantit que l'actif multimédia est immédiatement associé à la catégorie, aux tags et au flux de traitement corrects dès la fin du téléchargement, éliminant ainsi le besoin d'un appel API séparé pour mettre à jour les propriétés du média.

Conformité en matière de confidentialité

Le SDK de téléchargement côté client est conçu pour être intégré dans des applications distribuées via les magasins d'applications. Le SDK ne collecte aucune donnée personnelle. Pour les exigences de conformité lors de la distribution d'applications avec des intégrations de SDK, reportez-vous à l'Accord de service.

Facturation

L'utilisation du SDK de téléchargement côté client est gratuite. Les coûts sont associés aux ressources ApsaraVideo VOD consommées pendant et après le téléchargement :