サポートに連絡する| システムステータス
ページコンテンツ

    TVE でBrightcoveプレーヤーを使用する

    This topic provides information on Video Cloud’s TVEアドビプライムタイムインテグレーションの TV エブリエヴー (TVE) ソリューションを使用します。以下の手順は、値の不要な重複を削除し、個々のカスタムフィールドに基づいて Adobe Pass クライアントが必要とする XML リクエスト値を自動的に生成することで、ビデオメタデータの入力と管理を簡素化します。

    アカウント構成

    TVE で Video Cloud を使用するには、ブライトコーブサポートによるアカウント設定が必要です。TVE を使用する場合は、ブライトコーブのサポートにお問い合わせください。

    必須フィールド

    この統合では、アカウントに次のカスタムフィールドのいずれかを作成することをお勧めします。下の名前は 内部 フィールドの名前-表示名に好きなものを使用できます。

    • bcadobepassrequestorid
    • bcadobepasstitle
    • bcadobepassreferenceid
    • bcadobepassrating
    • bcadobepassratingscheme

    次のセクションでは、これらのフィールドが存在する場合の使用方法と、そうでない場合はどの値が代わりに使用されるかについて説明します。

    resourceIDrequestorIDフィールドとフィールドの自動生成

    ユーザーが TVE 対応のアカウントから Playback API 経由で動画を取得すると、API bcadobepassrequestoridは次のルールに従っての値を返します。

    • bcadobepassrequestoridのカスタムフィールド値がビデオに存在する場合、API はビデオレベルの値を返します。
    • bcadobepassrequestoridフィールドに値が設定されていない場合、API はアカウント設定に保存されているリクエスタ ID 値を返します。

     

    ユーザーが TVE 対応のアカウントから Playback API 経由で動画を取得すると、API bcadobepassresourceidは次のルールに従っての値を返します。

    • bcadobepassresourceidのカスタム項目値が動画に存在する場合、API は項目レベルの値を返します
    • bcadobepassresourceidフィールドに値が設定されていない場合、API は以下に示すフィールドと XML 形式に基づいて計算された値を返します。

    bcadobepassresourceid生成されたフィールドは、アドビが指定した MRSS 形式に従い、Comcast とのほとんどすべての統合で使用する必要があります。

    <rss version='2.0' xmlns:media='http://search.yahoo.com/mrss/'>
    <channel>
    <title>channel</title>
    <item><title>item-title</title>
    <guid>guid</guid>
    <media:rating scheme='urn:rating-scheme'>rating</media:rating></item>
    </channel>
    </rss>
    

    MRSS に含まれる値は、次の規則に基づいている必要があります。

    TVE RSS フィールズ
    RSS XML フィールド ビデオクラウドフィールド
    channel
    • 存在する場合は、bcadobepassrequestorid
    • 存在しない場合は、アカウント設定で設定された値を使用します
    item-title
    • 存在する場合は、bcadobepasstitle
    • 存在しない場合は、name
    guid
    • 存在する場合は、bcadobepassreferenceid
    • 存在しない場合は、reference_id
    rating
    • 存在する場合は、bcadobepassrequestorid
    • bcadobepassratingbcadobepassratingschemeとの両方が存在する場合のみ送信する
    rating-scheme
    • 存在する場合は、bcadobepassrating
    • bcadobepassratingbcadobepassratingschemeとの両方が存在する場合のみ送信する

    プレーヤーの構成

    次のコードは、TVE 用の Brightcove Player を設定するためのモデルを提供します。

    <!doctype html>
    <html>
    <head>
      <title>TVE Example</title>
    </head>
    <body>
      <!-- Make sure your player doesn't have a video associated with it
      and don't use data-video-id to assign one. We'll request a video
      from the catalog by hand, detect that it's TVE content, trigger TVE
      authentication and then load the video into the player. -->
      <video-js id="tve-player"
        data-account="account1234"
        data-player="player-id"
        class="video-js"
        controls>
      </video-js>
      <script src="//players.brightcove.net/account1234/player-id_default/index.min.js"></script>
      <script>
      var player = videojs.getPlayer('tve-player');
      player.ready(function() {
        player.catalog.getVideo('ref:tve-video', function(error, video) {
          if (error) {
            // showErrorMessage() would be defined by you somewhere else
            // in the page
            return showErrorMessage(error);
          }
          // You can tell whether a video is TVE protected by checking to
          // see if the video sources contain URLs. If they don't, you need
          // to authenticate your viewer and re-request the video with their
          // TVE credentials.
          if (video.sources && video.sources[0].src) {
            // This is not a TVE video so it can be played back immediately
            return player.catalog.load(video);
          }
          // From here on, we're definitely dealing with a TVE video.
          // You need to provide an implementation for authenticateWithTVE()
          // to get a TVE token. See the documentation from your TVE provider
          // for details on how to do that.
          autenticateWithTVE(function(error, tveToken) {
            if (error) {
              return showErorMessage(error);
            }
            // Now that we have the token, we can re-request the video and get playable URLs.
            player.catalog.tveToken = tveToken;
            player.catalog.getVideo('ref:tve-video', function(error, video) {
              if (error) {
                return showErrorMessage(error);
              }
              player.catalog.load(video);
            });
          });
        });
      });
      </script>
    </body>
    </html>

    認証なしのリクエストに対する応答

    以下は、TVE 認証が提供されていない場合の再生 API からの応答の例です。ご覧のように、ビデオソースは使用できませんが、プレーヤーがコンテンツのプレビューを表示できるように、他のビデオメタデータが存在します。

    {
      "sources": [
    
        ],
      "description": "The short description can be used to give more information about your video and will appear in many standard Brightcove Player templates.",
      "poster_sources": [
        {
          "src": "http://f1.media.brightcove.com/8/96980657001/96980657001_207574837001_commonRedpoll-still.jpg?pubId=3840518800001&videoId=3843070012001"
        },
        {
          "src": "https://f1.media.brightcove.com/8/96980657001/96980657001_207574837001_commonRedpoll-still.jpg?pubId=3840518800001&videoId=3843070012001"
        }
      ],
      "tags": [
        "sample"
      ],
      "cue_points": [
    
      ],
    "errors": [
          {
            "error_subcode": "TVE_AUTH",
            "error_code": "SOURCES_RESTRICTED",
            "message": "Video sources are restricted by access policy.",
            "restricted_fields": [
              "sources"
            ]
          }
        ],
        "custom_fields": {
        "bcadobepassresourceid": "
        
        
            
            anotherRefId
            XXX
            ",
        "bcadobepassrequestorid": "asdfasf",
        "bcadobepassrating": "XXX",
        "bcadobepassreferenceid": "anotherRefId",
        "bcadobepasstitle": "PassTitle",
        "bcadobepassratingscheme": "TV-14"
      },
      "account_id": "3840518800001",
      "name": "Sample Video 2",
      "reference_id": null,
      "long_description": null,
      "duration": 29960,
      "economics": "AD_SUPPORTED",
      "published_at": "2014-10-16T16:35:24.520Z",
      "text_tracks": [
    
      ],
      "updated_at": "2017-05-26T01:48:41.396Z",
      "thumbnail": "http://f1.media.brightcove.com/8/96980657001/96980657001_180424037001_commonRedpoll-thumbnail.jpg?pubId=3840518800001&videoId=3843070012001",
      "poster": "http://f1.media.brightcove.com/8/96980657001/96980657001_207574837001_commonRedpoll-still.jpg?pubId=3840518800001&videoId=3843070012001",
      "offline_enabled": false,
      "link": null,
      "id": "3843070012001",
      "ad_keys": null,
      "thumbnail_sources": [
        {
          "src": "http://f1.media.brightcove.com/8/96980657001/96980657001_180424037001_commonRedpoll-thumbnail.jpg?pubId=3840518800001&videoId=3843070012001"
        },
        {
          "src": "https://f1.media.brightcove.com/8/96980657001/96980657001_180424037001_commonRedpoll-thumbnail.jpg?pubId=3840518800001&videoId=3843070012001"
        }
      ],
      "created_at": "2014-10-16T16:35:24.520Z"
    }

    ページの最終更新日30 Sep 2021