Documentation Oracle Cloud Infrastructure

Inclusion d'une ressource

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

Les actifs (contenu) sont ingérés (ajoutés) dans un canal de distribution et diffusés en continu à l'aide d'une configuration de packaging. Pour exécuter l'opération d'inclusion, l'éditeur de ressource doit disposer du droit d'accès MEDIA_WORKFLOW_JOB_CREATE sur le compartiment dans lequel la ressource est ingérée.

Les éditeurs d'actifs (ou les rôles qui ingèrent des actifs dans un canal de distribution) doivent disposer des droits suivants :
  • Lisez la liste de lecture principale (m3u8) à partir de l'emplacement Object Storage de la région.
  • Lisez le bucket, la liste de lecture et tous les fichiers rendus dans le canal.
Remarque

Media Streams ne peut inclure que des listes de lecture HLS. Pour utiliser OCI Media Streams afin de diffuser votre contenu, créez une liste de lecture HLS à l'aide d'OCI Media Flow.
    1. Ouvrez le menu de navigation et cliquez sur Analytics et IA. Sous Services de support, cliquez sur Flux de support.
    2. Sur la page de liste Canaux de distribution, sélectionnez le compartiment contenant le canal de distribution pour lequel inclure les ressources.
    3. Cliquez sur le nom du canal dans lequel vous voulez ingérer les ressources.
    4. Sur la page Détails du canal de distribution, sous Ressources, cliquez sur Ressources de liste de lecture.
    5. Cliquez sur Ingest Playlist Asset.
    6. Dans le panneau Ingérer une ressource de liste de lecture, sélectionnez le bucket dans le compartiment contenant le contenu. Si vous ne voyez pas le bucket souhaité, vous devrez peut-être le modifier.
    7. Sélectionner le fichier. Cet objet est votre liste de lecture principale HLS (m3u8) avec tous les rendus VBR (Variable Bitrate) de la ressource à ingérer. Vous ne pouvez sélectionner que du contenu HLS valide à inclure. Si le contenu est dans un format tel que MP4, convertissez les fichiers au format HLS. Pour plus de détails, reportez-vous à OCI Media Flow.
    8. (Facultatif) Pour appliquer des balises à la ressource, cliquez sur Afficher les options avancées.
      Le balisage est un système de métadonnées permettant d'organiser et de suivre les ressources dans la location. Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui ajouter des balises à format libre. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Pour obtenir des informations générales sur le balisage, reportez-vous à Balises de ressource et à Présentation de Tagging.
    9. Cliquez sur Créer.
      La playlist est créée.
      Sur 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 du travail d'inclusion est défini sur Accepté. Une fois le travail d'inclusion terminé, vous pouvez sélectionner le nom du package dans la liste Packaging.
    10. Copiez l'URL d'aperçu et lisez l'URL dans un navigateur ou une application pris en charge.

  • L'ingestion de ressources à l'aide de la CLI nécessite un ID de ressource multimédia pour l'ingestion.

    Vous pouvez utiliser la console pour visualiser les ID de ressource de média existants et procéder à l'ingestion de ressource, ou vous pouvez en créer un dans l'interface de ligne de commande en fonction du média HLS dans votre bucket de stockage d'objet à 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 de 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]

    Afin d'obtenir toutes les commandes pour stream-distribution-channel, exécutez la commande suivante :

    oci media-services stream-distribution-channel -h

    Afin d'obtenir de l'aide pour la commande ingest-stream-distribution-channel-asset-metadata-entry-details, exécutez la commande suivante :

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

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

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

    Une fois la ressource ingérée, vous pouvez créer manuellement une URL d'aperçu. Pour plus de détails, voir Création d'une URL d'aperçu.