サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    リモートアセット

    このトピックでは、CMS API を使用して、ビデオ、レンディション、マニフェスト、画像、WebVTT テキストトラックなどのリモートアセットを Video Cloud に追加する方法について説明します。このトピックでは、ビデオを設定してから、リモートアセットを追加、更新、削除する方法について説明します。

    概要

    リモートアセットは主に資産運用、以下に示すいくつかの例外を除きます。アセットのGET操作は、取り込んだアセットとリモートアセットの両方に使用できることに注意してください。

    認証

    ワークフロー

    リモートアセットを設定する手順は次のとおりです。

    <img class = "bcls-image--no-border" alt = "リモートアセットワークフロー" src = "/assets/images/cms/managing-videos/remote-assets-workflow.svg" "/>
    リモートアセットワークフロー

    次のセクションでは、これらの各ステップについて説明します。

    ビデオを作成する

    リモートアセットを追加する前に、POSTリクエストを使用してVideoCloudメディアライブラリにビデオオブジェクトを作成する必要があります。

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
          
          

    リクエストの本文に、動画名を最小限に含むJSONオブジェクトを含めますが、追加のメタデータを含めることもできます。

          {
            "name": "My Remote Video",
            "description": "A short description of the video",
            "tags": ["remote", "fall_campaign"],
            "reference_id": "myUniqueReferenceID"
          }
          
          

    ビデオの作成操作の詳細については、を参照してください。 APIリファレンス

    レンディションを追加する

    次に、以下にPOSTリクエストを送信して、1つ以上のフルレングスのリモートビデオレンディションを追加します。

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
          
          

    リクエスト本文のJSONには、最小限のリモートURLが含まれている必要がありますが、レンディションの他のメタデータが含まれている場合があります。

          {
            "video_duration": 31487,
            "name": "RA - Great Blue Heron",
            "remote_url": "//learning-services-media.brightcove.com/videos/mp4/greatblueheron.mp4",
            "encoding_rate": 983000,
            "frame_height": 360,
            "size": 3887659,
            "frame_width": 640,
            "video_codec": "h264",
            "video_container": "MP4",
            "progressive_download": true
          }
          
          

    1. このエンドポイントは、フルレングスのビデオレンディション(通常は.mp4または.movファイル)を追加する場合にのみ使用してください。HLSやDASHなどのセグメント化されたストリームを追加するには、次のセクションで説明するマニフェストエンドポイントを使用してください。
    2. Video Cloudはリモートビデオファイルを検査しないため、追加のメタデータを提供すると、Video Cloudはこの情報をStudio(またはメタデータを表示するようにプレーヤーを構成している場合はBrightcoveプレーヤー)に表示できます。

      レンディションの追加操作の詳細については、 APIリファレンス

    3. リモートアセットのレンディションには、video_codec そしてvideo_container 正しく動作するフィールド。
    4. MP4レンディションしなければならない持っている"progressive_download": true Brightcoveプレーヤーで正しく機能するように設定されたフィールド
    5. 混合アセットは許可されていません-取り込んだビデオにリモートレンディションを追加することはできません
    6. CDNまたはその他のリモートリポジトリがHTTP配信とHTTPS配信の両方をサポートしている場合は、リモートアセットのURLをプロトコルに依存しないURL上記の例に示すように(つまり、「http://my.domain/path / ...」の代わりに「//my.domain/path / ...」を使用します)

    マニフェストを追加する

    DASHやHLSレンディションなどのリモートセグメントタイプを追加するには、ビデオを作成してからマニフェストを追加するだけでよいことに注意してください。ない前のセクションで説明したように、「レンディションを追加」する必要があります。

    フルレングスのレンディションを追加することに加えて、マニフェストタイプのエンドポイントにPOSTリクエストを行うことで、HLS、HDS、ISMなどのセグメント化されたレンディションのマニフェストを追加することもできます。

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
          
          

    リクエスト本文のJSONで、リモートURLと名前を指定します(オプション)。

          {
            "remote_url": "http://learning-services-media.brightcove.com/avideo/hls/chickadee/chickadee.m3u8",
            "name": "chickadee_hls"
          }
          
          

    マニフェストの追加操作の使用の詳細については、APIリファレンスの関連セクションを参照してください。

    ポスター/サムネイルを追加

    これらのエンドポイントにPOSTリクエストを行うことで、リモートのポスターとサムネイルを動画に追加できます。

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
          
          

    リクエスト本文のJSONには、画像のリモートURLを含める必要があり、必要に応じて名前を追加できます。

          {
            "remote_url": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
          }
          
          

    操作の詳細については、APIリファレンスを参照してください。

    テキストトラックを追加する

    テキストトラックを使用して、キャプション、チャプター、およびその他の時間ベースのメタデータをビデオに追加できます。

    レンディションや画像とは異なり、テキストトラックは、リモートアセットビデオでも、VideoCloudシステムに取り込まれたビデオと同じように扱われます。実際にテキストトラックをビデオに追加するには、StudioのメディアモジュールまたはCMS APIビデオ操作の更新

    リモートを摂取したものと交換する

    Dynamic Ingest APIにリクエストを送信することで、リモートアセットビデオを取り込んだものに置き換えることができます。

          https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
          
          

    最も単純なリクエスト本文は次のようになります。

          {
            "master": {
              "url": "http://host/master.mp4"
            }
          }
          
          

    を参照してください動的取り込みAPIリファレンス追加のオプションと情報については。

    リモートアセットビデオの一般的な用途の1つは、ライブストリーミングイベントで使用するプレースホルダービデオを作成することです。イベントが完了したら、「ライブ」ビデオを、ライブストリームに使用したのと同じプレーヤーに表示されるイベントのビデオオンデマンド録画に置き換えることができます。これは、上記の方法を使用して行うことができますが、リモートアセットビデオをVideoCloudに取り込まれるものに変換するためにも使用できます。

    アセットを変更する

    ビデオのリモートアセットの追加に加えて、アセット情報の取得、更新、および削除の操作もあります。これらの操作では、上記のエンドポイントを使用しますが、GET、PATCH、またはDELETEリクエストを使用します。更新および削除リクエストの場合、リクエストURLにアセットID(POSTおよびGETリクエストへの応答に含まれる)を追加する必要があります。

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
          
          

    を参照してくださいAPIリファレンス取得、更新、および削除操作の詳細については。

    制約事項

  • リモートアセットでは、SSAI はサポートされていません。
  • DRM は、プレーヤーをカスタマイズして DRM ライセンスサーバーと通信できる場合にのみサポートされます。これは、プラグインを通じて Brightcove Player で可能です。他のプレイヤーについては、プレーヤーのドキュメントを参照する必要があります。
  • 分析:Brightcove Analytics システムは、動画再生時間など、システム生成の動画メタデータに依存します。リモートアセットの分析データは、このメタデータを提供できない限り、リモートアセットの分析データのリッチは低くなります。
  • 再生保証:Video Cloud に取り込まれたすべての動画を Brightcove Player で再生できます。これは、ほぼすべてのリモートアセットに当てはまりますが、動画が再生されないエッジケースもあります。例えば、DASHとHLSには、まだサポートしていないいくつかの高度な機能があります。BrightCove 以外のプレーヤーの場合は、そのプレーヤーが動画形式を完全にサポートしていることを確認する必要があります。