Oracle Cloud Infrastructureドキュメント

アセットの取得

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

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

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

メディア・ストリームは、HLSプレイリストのみを収集できます。OCI Media Streamsを使用してコンテンツを配信するには、OCI Media Flowを使用してHLSプレイリストを作成します。
    1. ナビゲーション・メニューを開き、「アナリティクスとAI」を選択します。「メディア・サービス」で、「メディア・ストリーム」を選択します。
    2. 「分散チャネル」リスト・ページで、アセットを取り込む分散チャネルを含むコンパートメントを選択します。
    3. アセットを取り込むチャネルの名前を選択します。
    4. 詳細ページで、「プレイリスト・アセット」を選択します。
    5. 「プレイリスト・アセットの取込み」を選択します。
    6. 「プレイリスト・アセットの取込み」パネルで、プレイリスト・アセットの名前を入力します。
    7. 「入力ファイル」で、コンテンツを含むコンパートメント内のバケットを選択します。必要なバケットが表示されない場合は、コンパートメントの変更が必要になる場合があります。
    8. ファイルの選択このオブジェクトは、取り込むアセットのすべての可変ビットレート(VBR)レンディションを含むHLSプライマリ・プレイリスト(m3u8)です。有効なHLSコンテンツのみを選択して取り込むことができます。コンテンツがMP4などの形式の場合は、ファイルをHLS形式に変換します。詳細は、OCI Media Flowを参照してください。
    9. (オプション)「タグ」セクションで、プレイリスト・アセットに1つ以上のタグを追加します。
      リソースを作成する権限を持つ場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限を持つ必要があります。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。後でタグを適用できます。
    10. 「取込み」を選択します。
      プレイリストが作成されます。プレイリスト・アセットの詳細ページの「アセット情報」セクションで、「アセット・ジョブ・ステータスの取込み」が「受諾済」に設定されます。
    プレビュー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の作成を参照してください。