Documentation sur Oracle Cloud Infrastructure

Ingestion d'une ressource

Ajoutez le contenu que vous souhaitez distribuer dans les listes de lecture dans Media Streams.

Les ressources (contenu) sont ingérées (ajoutées) dans un canal de distribution et diffusées en continu à l'aide d'une configuration d'emballage. Pour exécuter l'opération d'ingestion, l'éditeur de ressource doit disposer de l'autorisation MEDIA_WORKFLOW_JOB_CREATE sur le compartiment dans lequel la ressource est ingérée.

Les éditeurs de ressource (ou les rôles qui ingèrent des ressources dans un canal de distribution) doivent avoir les droits suivants :
  • Lisez la liste de lecture principale (m3u8) à partir de l'emplacement de stockage d'objets dans la région.
  • Lisez le seau, la liste de lecture et tous les fichiers rendus dans le canal.
Note

Les flux de médias en continu ne peuvent ingérer que des listes de lecture HLS. Pour utiliser le service de flux de médias en continu pour OCI pour diffuser votre contenu, créez une liste de lecture HLS à l'aide du service de flux de médias pour OCI.
    1. Ouvrez le menu de navigation et cliquez sur Analyse et intelligence artificielle. Sous Services de médias, cliquez sur Flux de médias en continu.
    2. Dans la page de liste Canaux de distribution, sélectionnez le compartiment qui contient le canal de distribution pour lequel vous voulez ingérer les ressources.
    3. Cliquez sur le nom du canal dans lequel vous voulez ingérer les ressources.
    4. Dans la page Détails du canal de répartition, sous Ressources, cliquez sur Liste de lecture des ressources.
    5. Cliquez sur Ingérer une ressource de liste de lecture.
    6. Dans le panneau Ingérer la ressource de liste de lecture, sélectionnez le seau dans le compartiment qui contient le contenu. Si vous ne voyez pas le seau souhaité, vous pouvez avoir besoin de le modifier.
    7. Sélectionner le fichier. Cet objet est votre liste de lecture principale HLS (m3u8) avec tous les rendus de débit variable (VBR) de la ressource que vous voulez ingérer. Vous ne pouvez sélectionner que du contenu HLS valide à ingérer. Si le contenu est dans des formats tels que MP4, convertissez les fichiers au format HLS. Pour plus d'informations, consultez le service de flux de médias OCI.
    8. (Facultatif) Pour appliquer des marqueurs à la ressource, cliquez sur Afficher les options avancées.
      Le marquage est un système de métadonnées qui vous permet d'organiser les ressources de votre location et d'en assurer le suivi. Si vous êtes autorisé à créer une ressource, vous êtes également autorisé à ajouter des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour des informations générales sur le marquage, voir Marqueurs de ressource et Aperçu du marquage.
    9. Cliquez sur Créer.
      La playlist est créée.
      Dans la page Détails de la ressource de liste de lecture, dans la section Informations sur la liste de lecture de l'onglet Détails, le statut de la tâche d'ingestion est réglé à Accepté. Une fois la tâche d'ingestion terminée, vous pouvez sélectionner le nom de l'ensemble dans la liste Emballage.
    10. Copiez l'URL de prévisualisation et lisez-la dans un navigateur ou une application pris en charge.

  • L'ingestion de ressources à l'aide de l'interface de ligne de commande nécessite un ID ressource de média pour l'ingestion.

    Vous pouvez utiliser la console pour voir les ID ressources de média existantes et poursuivre l'ingestion des ressources ou vous pouvez en créer une nouvelle dans l'interface de ligne de commande en fonction du média HLS dans votre seau de stockage d'objets à l'aide de la commande create : 

    oci media-services media-asset create [OPTIONS]

    Les paramètres requis pour la commande create sont les suivants :

    • --compartment id [text]
    • --type [text]: <use the type PLAYLIST for the HLS media>
    • --namespace-name [text]
    • --bucket-name [text]
    • --object-name [text]: <name of the primary HLS or m3u8 file>

    Une fois l'ID ressource multimédia créé, vous pouvez ingérer la ressource.

    Pour ingérer une ressource, utilisez la commande ingest-stream-distribution-channel-asset-metadata-entry-details :

    oci media-services stream-distribution-channel ingest-stream-distribution-channel-asset-metadata-entry-details [OPTIONS]

    Les paramètres requis pour la commande ingest-stream-distribution-channel-asset-metadata-entry-details sont les suivants :

    • --media-asset-id [text]
    • --stream-distribution-channel-id [text]
    • --compartment-id [text]

    Pour obtenir toutes les commandes pour stream-distribution-channel :

    oci media-services stream-distribution-channel -h

    Pour obtenir de l'aide sur la commande ingest-stream-distribution-channel-asset-metadata-entry-details :

    oci media-services stream-distribution-channel ingest-stream-distribution-channel-asset-metadata-entry-details -h

    Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Pour ingérer une ressource, utilisez l'opération IngestStreamDistributionChannel.

    Une fois la ressource ingérée avec succès, vous pouvez créer manuellement une URL de prévisualisation. Pour plus de détails, voir Création d'une URL de prévisualisation.