Documentazione di Oracle Cloud Infrastructure

Inclusione di un asset

Aggiungere il contenuto che si desidera distribuire nelle playlist di Media Streams.

Gli asset (contenuti) vengono inclusi (aggiunti) in un canale di distribuzione e trasmessi in streaming utilizzando una configurazione di packaging. Per eseguire l'operazione di inclusione, il publisher dell'asset deve disporre dell'autorizzazione MEDIA_WORKFLOW_JOB_CREATE sul compartimento in cui viene incluso l'asset.

I publisher degli asset (o i ruoli che incorporano gli asset in un canale di distribuzione) devono disporre dei diritti seguenti:
  • Leggi la playlist primaria (m3u8) dalla posizione dello storage degli oggetti nell'area.
  • Leggere il bucket, la playlist e gli eventuali file di rendering nel canale.
Nota

I flussi multimediali possono includere solo playlist HLS. Per utilizzare i flussi multimediali OCI per distribuire i tuoi contenuti, crea una playlist HLS utilizzando OCI Media Flow.
    1. Aprire il menu di navigazione e fare clic su Analytics e AI. In Servizi multimediali, fare clic su Streaming multimediali.
    2. Nella pagina della lista Canali di distribuzione selezionare il compartimento che contiene il canale di distribuzione per il quale si desidera includere gli asset.
    3. Fare clic sul nome del canale in cui si desidera includere gli asset.
    4. Nella pagina Dettagli canale di distribuzione, in Risorse, fare clic su Elenca asset.
    5. Fare clic su Includi asset playlist.
    6. Nel pannello Includi asset playlist, selezionare il bucket nel compartimento che contiene il contenuto. Se non viene visualizzato il bucket desiderato, potrebbe essere necessario modificare il compartimento.
    7. Selezionare il file. Questo oggetto è la playlist principale HLS (m3u8) con tutte le rendition del bitrate variabile (VBR) dell'asset che si desidera includere. È possibile selezionare solo il contenuto HLS valido da includere. Se il contenuto è in formati quali MP4, convertire i file in formato HLS. Per ulteriori dettagli, consulta OCI Media Flow.
    8. (Facoltativo) Per applicare tag all'asset, fare clic su Mostra opzioni avanzate.
      L'applicazione di tag è un sistema di metadati che consente di organizzare e tenere traccia delle risorse nella tenancy. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per aggiungervi tag in formato libero. Per applicare una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag. Per informazioni generali sull'applicazione di tag, vedere Tag risorsa e Panoramica sull'applicazione di tag.
    9. Fare clic su Crea.
      Viene creata la playlist.
      Nella pagina Dettagli asset elenco di riproduzione, nella sezione Informazioni elenco di riproduzione della scheda Dettagli, lo stato del job di inclusione è impostato su Accettato. Al termine del job di inclusione, è possibile selezionare il nome del package dall'elenco Packaging.
    10. Copiare l'URL di anteprima e riprodurre l'URL in un browser o in un'applicazione supportati.

  • L'inclusione degli asset mediante l'interfaccia CLI richiede un ID asset multimediale per l'inclusione.

    Puoi utilizzare la console per visualizzare gli ID degli asset di supporto esistenti e procedere con l'inclusione degli asset oppure puoi crearne uno nuovo nell'interfaccia CLI in base ai supporti HLS nel bucket di storage degli oggetti utilizzando il comando create: 

    oci media-services media-asset create [OPTIONS]

    I parametri obbligatori per il comando create sono:

    • --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>

    Dopo aver creato l'ID asset multimediale, è possibile includere l'asset.

    Per includere un asset, utilizzare il comando ingest-stream-distribution-channel-asset-metadata-entry-details:

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

    I parametri richiesti per il comando ingest-stream-distribution-channel-asset-metadata-entry-details sono:

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

    Per ottenere tutti i comandi per stream-distribution-channel:

    oci media-services stream-distribution-channel -h

    Per ottenere assistenza per il comando ingest-stream-distribution-channel-asset-metadata-entry-details:

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

    Per un elenco completo dei flag e delle opzioni variabili per i comandi CLI, vedere Command Line Reference.

  • Per includere un asset, utilizzare l'operazione IngestStreamDistributionChannel.

    Dopo la corretta inclusione dell'asset, è possibile creare manualmente un URL di anteprima. Per ulteriori informazioni, vedere Creazione di un URL di anteprima.