Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Personnalisation des chemins dans les manifestes HLS Lorsque vous créez un groupe de sortie HLS dans un MediaLive canal standard, vous pouvez configurer des manifestes personnalisés. Notez que vous ne pouvez pas configurer de manifestes personnalisés dans un groupe MediaPackage de sortie, ni dans un groupe de sortie HLS si le système en aval l'est MediaPackage. MediaPackage fonctionne uniquement avec les chemins par défaut. Vous pouvez personnaliser le manifeste principal en modifiant les chemins d'accès aux manifestes enfants. Vous pouvez également personnaliser chaque manifeste enfant en modifiant les chemins d'accès aux fichiers multimédia. En règle générale, vous n'avez besoin de modifier la syntaxe que si le système en aval a des exigences particulières de chemin d'accès. Akamai vous demande CDNs généralement de modifier la syntaxe. **Note** Dans cette section sur les manifestes HLS, il est supposé que vous connaissez les étapes générales de la création d'un canal, comme décrit dans [Création d'un canal de bout en bout](creating-channel-scratch.md). Les champs clés de la console qui se rapportent à cette fonctionnalité se trouvent dans la section Groupe d'**emplacements** du **groupe de sortie HLS** de la page **Créer un canal**. Pour consulter l'étape à laquelle vous remplissez ces champs, veuillez consulter [Procédure](creating-hls-output-group.md#hls-create-procedure). **Topics** + [Procédure pour configurer des chemins d'accès personnalisés](hls-custom-manifests-procedure.md) + [Comment fonctionnent les manifestes](hls-manifests-how-work.md) + [Règles pour les chemins d'accès personnalisés](hls-custom-paths-rules.md) + [Conseils pour la configuration des chemins personnalisés](hls-custom-paths-guidance.md) + [Exemples de chemins personnalisés](hls-custom-paths-examples.md) # Procédure pour configurer des chemins d'accès personnalisés La personnalisation des chemins du manifeste implique de travailler avec les champs suivants : + **Groupe de sortie HLS — Emplacement** — Champs du **manifeste URL de base** + **Groupe de sortie HLS — Emplacement** — Champs de **contenu URL de base** **Pour configurer des chemins personnalisés dans les manifestes** 1. Parlez au système en aval pour savoir si des chemins personnalisés sont requis. Les manifestes principaux peuvent avoir besoin de chemins personnalisés vers les manifestes enfants, les manifestes enfants peuvent avoir besoin de chemins personnalisés vers les fichiers multimédias, ou les manifestes principaux et enfants peuvent avoir besoin de chemins personnalisés. Consultez [Comment fonctionnent les manifestes](hls-manifests-how-work.md). 1. Concevez les tracés en prêtant attention à la [syntaxe et aux règles de construction des tracés](hls-destinations-design-step.md#hls-syntax-http). Consultez ce [guide pour les différents systèmes en aval](hls-custom-paths-guidance.md). Veuillez consulter [ces exemples](hls-custom-paths-examples.md). 1. Remplissez l'un de ces champs ou les deux dans la section **Emplacement** de la page Groupe de sortie HLS : + **Manifeste d'URL de base A** **et manifeste d'URL de base B.** Pour un canal à pipeline unique, remplissez uniquement le champ A. Pour un canal standard, remplissez les champs A et B. + **Contenu de l'URL de base A** **et contenu de l'URL de base B.** Pour un canal à pipeline unique, remplissez uniquement le champ A. Pour un canal standard, remplissez les champs A et B. # Comment fonctionnent les manifestes Les sections suivantes décrivent le mode de MediaLive gestion des chemins de manifeste. ## Fonctionnement des chemins de manifeste par défaut Les manifestes MediaLive créés incluent des informations sur les chemins d'accès à d'autres fichiers, en particulier : + Le contenu à l'intérieur du manifeste principal inclut un chemin d'accès à chaque manifeste enfant. Par défaut, la syntaxe de ce chemin est la suivante : ``` baseFilename nameModifier extension ``` Par exemple : ``` curling-high.m3u8 ``` Le chemin est relatif à l'emplacement du manifeste principal. + Le contenu de chaque manifeste enfant inclut un chemin d'accès à ses fichiers multimédias. Par défaut, la syntaxe de ce chemin est la suivante : ``` baseFilename nameModifier optionalSegmentModifier counter extension ``` Par exemple : ``` curling-high-000001.ts ``` Le chemin est relatif à l'emplacement du manifeste enfant. ## Fonctionnement des chemins personnalisés Si les chemins par défaut à l'intérieur des manifestes ne conviennent pas à la façon dont le système en aval gère les trois ensembles de fichiers, vous pouvez remplir les champs *URL de base* : + Complétez les champs du **manifeste de l'URL de base** afin MediaLive de créer des chemins personnalisés vers les manifestes enfants. + Complétez les champs de **contenu de l'URL de base** MediaLive afin de créer des chemins personnalisés vers les fichiers multimédia. Lorsque vous personnalisez les chemins d'accès, la syntaxe change. + Lorsque vous remplissez les champs de **manifeste de l'URL de base**, la syntaxe du chemin d'accès du manifeste enfant (à l'intérieur du manifeste principal) est la suivante : ``` baseURLManifest baseFilename nameModifier extension ``` Par exemple : ``` http://viewing/sports/curling-high.m3u8 ``` + Lorsque vous remplissez les champs de **contenu de l'URL de base**, la syntaxe des chemins d'accès aux fichiers multimédias (à l'intérieur des manifestes enfants) est la suivante : ``` baseURLContent baseFilename nameModifier optionalSegmentModifier counter extension ``` Par exemple : ``` http://viewing/media/sports/curling-high-000001.ts ``` ## Comment MediaLive construit ces chemins Les chemins personnalisés vers les manifestes enfants sont construits comme suit : + Vous remplissez les champs **de manifeste URL** de base, les champs de **contenu URL de base** ou les deux. Par exemple : ``` http://198.51.100/sports/viewing/ ``` Notez la barre oblique à la fin de la valeur. + MediaLive ajoute cette valeur au chemin [par défaut](#hls-default-manifest-paths). Par exemple : ``` http://198.51.100/sports/viewing/curling-high.m3u8 ``` # Règles pour les chemins d'accès personnalisés Après avoir configuré la personnalisation des manifestes dans un groupe de sortie MediaLive HLS, vous devez partager les règles suivantes avec votre interlocuteur au niveau du système en aval. En règle générale, il est de la responsabilité du système en aval de s'assurer que le chemin personnalisé fonctionne dans son environnement. MediaLive ne valide en aucun cas les valeurs. Par conséquent : + Si le protocole est spécifié (facultatif), il doit être identique au protocole que vous avez spécifié dans les champs **URL de destination**. + Le **Manifeste URL de base** et les champs **Contenu URL de base** pour le même pipeline peuvent avoir la même valeur ou des valeurs différentes. Ils peuvent être identiques ou différents dans n'importe quelle partie (le domaine, le chemin). + Les valeurs peuvent donner lieu à un chemin relatif ou à un chemin absolu. + Un chemin relatif vers le manifeste enfant est toujours relatif à l'emplacement du manifeste principal. + Un chemin relatif vers les fichiers multimédias est toujours relatif à l'emplacement du manifeste enfant. + Les chemins doivent se terminer par une barre oblique. # Conseils pour la configuration des chemins personnalisés Le contenu du chemin personnalisé dans une sortie HLS doit être adapté au système situé en aval de MediaLive. Voici quelques conseils pour l'utilisation des champs *URL de base* pour différents systèmes en aval. **Configuration des chemins personnalisés si vous contrôlez le système en aval** Vous pouvez contrôler le système en aval. Par exemple, les systèmes en aval peuvent être Amazon S3 ou ceux MediaStore qui envoient du contenu à Amazon CloudFront. Votre gestion des fichiers HLS peut nécessiter que vous déplaciez un ou plusieurs ensembles de fichiers. Dans ce cas, vous pouvez remplir ces champs *URL de base* pour correspondre aux chemins d'accès de l'emplacement final des fichiers. **Configuration des chemins personnalisés si le packager en aval est MediaPackage** Si le package en aval l'est MediaPackage, laissez les champs **de l'URL de base** vides. MediaPackage n'utilise pas ces informations. **Configuration des chemins personnalisés si vous utilisez un système tiers en aval** Si vous utilisez un système tiers en aval, le système en aval doit vous indiquer s'il faut remplir ces champs **URL de base**. # Exemples de chemins personnalisés Vous trouverez ci-dessous des exemples des différentes manières de personnaliser les manifestes dans un groupe de sortie MediaLive HLS. Dans tous ces exemples, supposons ce qui suit : + Dans le manifeste principal, le chemin d'accès par défaut aux manifestes enfants est ce chemin relatif : ``` curling-high.m3u8 ``` + Dans le manifeste enfant, le chemin d'accès par défaut aux fichiers multimédias est le chemin relatif suivant : ``` curling-high-000001.ts ``` **Example 1** Le système en aval va déplacer les fichiers depuis l'emplacement où ils MediaLive sont envoyés. Le système en aval déplace les fichiers de telle sorte que les manifestes enfants se trouvent toujours au même emplacement relatif que les manifestes parents et que les fichiers multimédia se trouvent toujours au même emplacement relatif que les manifestes enfants. Par conséquent, vous n'avez pas besoin de personnaliser les chemins d'accès. Les chemins par défaut fonctionneront toujours après le déplacement. **Example 2** Vous voulez que le manifeste principal et les manifestes enfants incluent des chemins absolus vers leurs fichiers respectifs. Vous configurez comme suit : + Remplissez le champ **Manifeste de l'URL de base A** pour spécifier ce chemin absolu : ``` http://198.51.100/sports/viewing/ ``` À l'intérieur du manifeste principal, le chemin vers le manifeste enfant sera maintenant le suivant : ``` http://198.51.100/sports/viewing/curling-high.m3u8 ``` + Remplissez le champ **Contenu de l'URL de base** pour spécifier ce chemin absolu : ``` http://203.0.113.55/sports/viewing/ ``` À l'intérieur des manifestes enfants, les chemins d'accès aux fichiers multimédias seront désormais les suivants : ``` http://203.0.113.55/sports/viewing/curling-high-000001.ts ``` Cet exemple montre que le domaine des deux ensembles de fichiers peut être différent. **Example 3** Vous souhaitez que le manifeste parent inclue des chemins absolus vers les manifestes enfants. Mais vous souhaitez que les manifestes enfants incluent des chemins d'accès aux fichiers multimédias qui sont relatifs au manifeste enfant. Dans ce cas, vous personnalisez le chemin d'accès aux manifestes enfants, mais vous continuez à utiliser les chemins d'accès par défaut aux fichiers multimédias. + Vous remplissez le champ **Manifeste de l'URL de base A** pour spécifier ce chemin absolu : À l'intérieur du manifeste principal pour le pipeline A, le chemin d'accès au manifeste enfant sera désormais le suivant : ``` http://198.51.100/sports/viewing/curling-high.m3u8 ``` + Vous ne remplissez pas le champ **Contenu de l'URL de base A**. À l'intérieur des manifestes enfant, les chemins d'accès aux fichiers multimédias seront toujours la valeur par défaut : ``` curling-high-000001.ts ```