リモートアセット

概要

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

認証

ワークフロー

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

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

ビデオを作成する

リモートアセットを追加する前に、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リファレンスの関連セクションを参照してください。

• HLSマニフェストを追加する
• HDSマニフェストを追加する
• ISMマニフェストを追加する
• ISMCマニフェストを追加
• DASHマニフェストを追加する

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

これらのエンドポイントに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リファレンス取得、更新、および削除操作の詳細については。

制約事項