ApsaraVideo VOD:Obtenir les URL de lecture

Obtenir les URL via des notifications d'événements

Vous recevez des notifications d'événements lorsqu'un flux vidéo est transcodé vers une définition spécifique (StreamTranscodeComplete) ou lorsque tous les flux transcodés sont générés (TranscodeComplete). Ces notifications contiennent les URL de lecture. Enregistrez ces URL sur votre serveur et renvoyez-les aux clients lors des demandes de lecture.

Notes d'utilisation

• Les URL de lecture obtenues via les notifications d'événements sont des URL statiques. Si la signature d'URL est activée, vous devez générer vous-même une URL signée.

• Si vous désactivez ou supprimez un ancien domaine, remplacez-le par le nouveau domaine lors de la récupération des URL de lecture enregistrées.

• Si le chiffrement vidéo est configuré, l'URL de lecture renvoyée pointe vers un flux chiffré que le lecteur doit déchiffrer avant la lecture.

Obtenir les URL via des appels API/SDK

Lorsque vous téléchargez un fichier multimédia dans ApsaraVideo VOD, un VideoId lui est attribué. Appelez l'opération GetPlayInfo avec le VideoId pour récupérer l'URL de lecture.

Notes d'utilisation

• Par défaut, cette opération renvoie uniquement le dernier flux transcodé pour chaque définition et format. Lors de l'appel à l'API GetPlayInfo, définissez ResultType sur Multiple pour récupérer tous les flux terminés de la vidéo.

• Si vous avez activé la cryptographie propriétaire Alibaba Cloud, la vidéo ne peut être lue qu'avec le lecteur ApsaraVideo Player. Par défaut, l'API GetPlayInfo ne renvoie pas les flux chiffrés de manière privée. Définissez ResultType sur Multiple pour récupérer tous les flux terminés, y compris ceux qui sont chiffrés.

• Si vous avez activé le chiffrement HLS, l'API renvoie par défaut le flux standard chiffré en priorité pour la lecture.

• Si vous avez configuré le stockage hiérarchisé pour vos fichiers multimédias, cette API se comporte comme suit :

  • Par défaut, l'API renvoie les flux de lecture pour la classe de stockage Standard. Pour les niveaux non standard tels que Archive, l'API ne renvoie aucun flux de lecture. Si le fichier source se trouve dans un niveau non standard, l'API renvoie les flux transcodés mais pas le flux vidéo source.

  • Définissez le champ StorageClass dans le paramètre PlayConfig pour demander des flux depuis un niveau de stockage non standard spécifié.

• Pendant la période de validité, une URL de lecture n'est pas limitée à un appareil spécifique. Plusieurs appareils (PC, appareils mobiles, SDK ApsaraVideo Player, etc.) peuvent utiliser la même URL de lecture pour lire la vidéo simultanément, et le lecteur ne restreint pas la réutilisation de l'URL.

Flux de travail

Le diagramme suivant illustre le flux de travail pour récupérer et lire une vidéo via un domaine accéléré par CDN.

1. Le client envoie une demande à votre serveur d'application pour obtenir une URL de lecture.

2. Le serveur appelle GetPlayInfo en utilisant le SDK serveur pour obtenir l'autorisation de lecture.

3. ApsaraVideo VOD renvoie l'URL de lecture au serveur.

4. Le serveur renvoie l'URL de lecture au client.

5. Le lecteur client demande la ressource multimédia en fonction de l'URL de lecture renvoyée.

6. Si la ressource n'est pas mise en cache sur le nœud de bordure CDN ou si le cache a expiré, le CDN effectue une extraction depuis l'origine du bucket OSS.

7. Le bucket OSS renvoie la ressource au nœud de bordure CDN, qui met ensuite la ressource en cache.

8. Le nœud de bordure CDN sert la ressource multimédia au client.