Tous les produits
Search

Ce produit

    ApsaraVideo VOD:Paramètres de lecture courants

    Centre de documentation

    ApsaraVideo VOD:Paramètres de lecture courants

    Dernière mise à jour :Aug 10, 2026

    ApsaraVideo VOD fournit des URL de lecture adaptées à différents scénarios. Contrôlez le type d’URL de lecture en ajustant la configuration du nom de domaine, les paramètres de transcodage et les paramètres de lecture.

    Configuration du nom de domaine

    • Ajout d’un nom de domaine

    • Configuration de l’authentification par URL

      • Délai d’expiration : utilisez le paramètre AuthTimeout pour définir le délai d’expiration d’une URL accélérée par CDN. Pour savoir comment le délai d’expiration de l’URL est calculé, consultez la section « Délai d’expiration de l’URL » dans Authentification par URL.

      • Authentification secondaire :

    • Sélection parmi plusieurs noms de domaine

      Si votre serveur d’origine est configuré avec plusieurs noms de domaine, définissez le champ PlayDomain du paramètre PlayConfig afin de renvoyer une URL de lecture associée à un nom de domaine CDN spécifique. Pour plus d’informations, consultez Personnaliser la lecture multimédia à l’aide de PlayConfig.

      Pour distribuer différentes vidéos via différents noms de domaine accélérés, utilisez l’une des méthodes suivantes :

      • Méthode 1 : lors de l’appel de l’opération GetPlayInfo, spécifiez un nom de domaine accéléré différent pour chaque vidéo en utilisant le champ PlayDomain du paramètre PlayConfig. Par exemple, définissez PlayConfig={"PlayDomain":"cdn-a.example.com"} pour la vidéo A et PlayConfig={"PlayDomain":"cdn-b.example.com"} pour la vidéo B. L’opération renvoie les URL de lecture correspondant aux noms de domaine indiqués.

      • Méthode 2 : après avoir obtenu l’URL de lecture, remplacez le nom de domaine dans l’URL par le nom de domaine accéléré cible directement dans votre code. Par exemple, remplacez cdn-default.example.com dans l’URL renvoyée par cdn-b.example.com.

      Avant d’utiliser l’une ou l’autre méthode, ajoutez plusieurs noms de domaine accélérés et finalisez la configuration CNAME dans Distribution and Acceleration > Domain Name Management.

    • Accélération HTTPS

      Par défaut, l’API de lecture renvoie des URL d’images et de lecture HTTP. Pour obtenir des URL HTTPS, activez l’accélération HTTPS pour vos noms de domaine CDN. Pour plus de détails, consultez Accélération HTTPS.

    Paramètres de transcodage

    ApsaraVideo VOD vous permet de choisir si vous souhaitez transcoder les fichiers multimédias que vous téléchargez.

    • Si vous transcodez vos fichiers, le service de lecture renvoie les URL de lecture des fichiers transcodés. Le format, la définition, l’état de chiffrement et l’ID de filigrane dépendent de vos paramètres de transcodage.

    • Si vous ne transcodez pas vos fichiers, le service de lecture renvoie une URL de lecture pour le fichier source téléchargé. Seuls les fichiers MP4, FLV, M3U8, MP3 et WEBM peuvent être lus directement sans transcodage.

    Pour plus d’informations, consultez Modèles de transcodage.

    Paramètres de lecture

    Le service de lecture prend en charge trois méthodes de lecture :

    • Aperçu dans la console : aucune configuration n’est requise.

    • URL de lecture : appelez l’opération GetPlayInfo et utilisez les paramètres de lecture pour filtrer les URL de lecture renvoyées.

    • Lecteur : configurez les paramètres de lecture dans le SDK ApsaraVideo Player. Le lecteur filtre et sélectionne automatiquement une URL de lecture.

    Paramètres de l’API de lecture

    L’opération GetPlayInfo d’ApsaraVideo VOD vous permet de filtrer les résultats selon les critères suivants, adaptés à différents scénarios de lecture.

    • Définition

      Le paramètre Definition vous permet de sélectionner plusieurs définitions pour une commutation adaptative en fonction des conditions réseau. Si vous ne définissez pas ce paramètre, l’API de lecture renvoie les URL de lecture pour toutes les définitions disponibles de la vidéo spécifiée.

    • Format du fichier de sortie

      Le paramètre Formats spécifie le format de conteneur du fichier transcodé. Seuls les formats MP4, MP3 et M3U8 sont pris en charge. Vous pouvez spécifier plusieurs valeurs.

    • Type de flux de sortie

      Le paramètre StreamType indique si le flux est vidéo ou audio.

    • Type de fichier de sortie

      Le paramètre OutputType :

      • Si vous ne configurez pas de nom de domaine accéléré par CDN, l’API de lecture renvoie par défaut une URL d’origine OSS.

      • Après avoir configuré un nom de domaine accéléré par CDN, l’API de lecture renvoie par défaut une URL accélérée par CDN.

      • Vous pouvez également définir le paramètre OutputType pour obtenir soit une URL d’origine OSS, soit une URL accélérée par CDN.

    • Type de résultat de sortie

      Le paramètre ResultType : par défaut, ApsaraVideo VOD fournit une seule URL de lecture pour chaque combinaison de définition et de format. Si vous soumettez une nouvelle tâche de transcodage pour une vidéo déjà transcodée, plusieurs URL de lecture sont créées pour chaque combinaison définition-format. L’API de lecture renvoie par défaut uniquement l’URL du flux le plus récent. Pour récupérer toutes les URL de tous les flux transcodés, définissez ResultType sur Multiple.

      Important

      Si une vidéo comporte plus de 100 URL de flux de sortie, la définition de ResultType sur Multiple renvoie au maximum 100 URL de flux de sortie.

    Paramètres du lecteur

    Le SDK ApsaraVideo Player utilise un identifiant de lecture pour obtenir automatiquement une URL de lecture. Le SDK est disponible pour le Web (H5 et Flash), iOS et Android.

    • SDK ApsaraVideo Player pour le Web

      • Le lecteur H5 permet de définir le type de flux de sortie (mediaType), le format du fichier de sortie (format) et la définition (definition). Pour plus d’informations, consultez Fonctionnalités.

      • Le lecteur Flash prend en charge la lecture de fichiers vidéo uniquement. Vous pouvez définir le type de flux de sortie (mediaType) et le format du fichier de sortie (format).

    • SDK ApsaraVideo Player pour iOS

      Vous pouvez définir le format du fichier de sortie (format) et la définition préférée (quality).

    • SDK ApsaraVideo Player pour Android

      Vous pouvez définir le format du fichier de sortie (format) et la définition préférée (quality).