Oracle Cloud Infrastructureドキュメント

アセットの取得

メディア・ストリームのプレイリストに配布するコンテンツを追加します。

アセット(コンテンツ)は、配布チャネルに取り込まれ(追加)、パッケージング構成を使用してストリーミングされます。取込み操作を実行するには、アセット・パブリッシャが、アセットが取り込まれるコンパートメントに対するMEDIA_WORKFLOW_JOB_CREATE権限を持っている必要があります。

アセット・パブリッシャ(またはアセットをディストリビューション・チャネルに取り込むロール)には、次の権限が必要です。
  • リージョン内のオブジェクト・ストレージの場所からプライマリ・プレイリスト(m3u8)を読み取ります。
  • バケット、プレイリスト、およびチャネル内のレンダリングされたファイルを読み取ります。
ノート

メディア・ストリームは、HLSプレイリストのみを収集できます。OCI Media Streamsを使用してコンテンツを配信するには、OCI Media Flowを使用してHLSプレイリストを作成します。
    1. ナビゲーション・メニューを開き、「アナリティクスとAI」をクリックします。「メディア・サービス」で、「メディア・ストリーム」をクリックします。
    2. 「分散チャネル」リスト・ページで、アセットの取込み先となる分散チャネルを含むコンパートメントを選択します。
    3. アセットを取り込むチャネルの名前をクリックします。
    4. 「分散チャネルの詳細」ページの「リソース」で、「プレイリスト・アセット」をクリックします。
    5. 「プレイリスト・アセットの取得」をクリックします。
    6. 「プレイリスト・アセットの取込み」パネルで、コンテンツを含むコンパートメント内のバケットを選択します。必要なバケットが表示されない場合は、コンパートメントの変更が必要になる場合があります。
    7. ファイルの選択このオブジェクトは、取り込むアセットのすべての可変ビットレート(VBR)レンディションを含むHLSプライマリ・プレイリスト(m3u8)です。有効なHLSコンテンツのみを選択して取り込むことができます。コンテンツがMP4などの形式の場合は、ファイルをHLS形式に変換します。詳細は、OCI Media Flowを参照してください。
    8. (オプション)アセットにタグを適用するには、「拡張オプションの表示」をクリックします。
      タグ付けとは、テナンシ内のリソースを整理およびトラッキングできるメタデータ・システムです。リソースを作成する権限がある場合、それにフリーフォーム・タグを追加する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限が必要です。タグ付けの一般情報は、リソース・タグおよびタグ付けの概要を参照してください。
    9. 「作成」をクリックします。
      プレイリストが作成されます。
      「プレイリスト・アセットの詳細」ページの「詳細」タブの「プレイリスト情報」セクションで、「取込みジョブのステータス」が「受入れ済」に設定されます。取込みジョブが完了したら、「パッケージング」リストからパッケージ名を選択できます。
    10. プレビューURLをコピーし、サポートされているブラウザまたはアプリケーションでURLを再生します。

  • CLIを使用したアセットの取込みには、取込み用のメディア・アセットIDが必要です。

    コンソールを使用して、既存のメディア・アセットIDを表示し、アセットの取込みを続行することも、createコマンドを使用して、オブジェクト・ストレージ・バケットのHLSメディアに基づいてCLIで新しいメディアを作成することもできます: 

    oci media-services media-asset create [OPTIONS]

    createコマンドの必須パラメータは次のとおりです。

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

    メディア・アセットIDの作成後、アセットを取り込むことができます。

    アセットを取り込むには、ingest-stream-distribution-channel-asset-metadata-entry-detailsコマンドを使用します:

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

    ingest-stream-distribution-channel-asset-metadata-entry-detailsコマンドの必須パラメータは次のとおりです。

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

    stream-distribution-channelのすべてのコマンドを取得するには:

    oci media-services stream-distribution-channel -h

    ingest-stream-distribution-channel-asset-metadata-entry-detailsコマンドのヘルプを取得するには:

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

    CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

  • アセットを取り込むには、IngestStreamDistributionChannel操作を使用します。

    アセットが正常に取り込まれた後、プレビューURLを手動で作成できます。詳細は、プレビューURLの作成を参照してください。