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

    プレーヤーリポジトリ

    このトピックでは、Player 管理 API が配信システム API を使用して Brightcove プレーヤーの情報を保存および管理する方法について説明します。

    概要

    プレーヤーをCDNに公開するために、Player ManagementAPIは配信システムAPI。Delivery System APIを使用すると、そのコンテンツがホストされるgitリポジトリを作成できます。 player.brightcove.net。プレーヤーが作成されると、Brightcoveは舞台裏でリポジトリを作成します。パブリッシャーから直接要求された場合でも、Brightcoveプレーヤーの更新がリリースされた場合でも、プレーヤーが再公開されるたびに、対応するコミットがあり、そのリポジトリにプッシュされます。

    Gitリポジトリは、とりわけ、時間の経過に伴う変更の履歴を提供します。プレーヤーのデバッグ中に、このリポジトリのコピーを取得して、変更履歴を自分で調べることができると非常に便利な場合があります。最初に、コマンドラインツールcurlやChromeプラグインPostmanを使用して、プレーヤーに関する一般的な情報を取得する方法を学習します。次に、作成と公開のためにプレーヤーの履歴を表示する方法を学習します。

    プレイヤー情報

    コマンドラインに慣れている人は、プレイヤー情報を取得するためにcurlを使用したいと思うでしょうが、GUIに慣れている人は、Postmanオプションを選択します。

    カールを使用する

    curlと環境変数の設定に慣れていない場合は、の最初の2つのセクションをお読みください。ステップバイステップ:プレーヤー管理。次の環境変数が設定されていることを確認してください。

    • メール
    • ACCOUNT_ID
    • PLAYER_ID

    次に、次のcurlステートメントを使用して、プレーヤーに関する情報を取得できます。

          curl \
            --header "Content-Type: application/json" \
            --user $EMAIL \
            --request GET \
            https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds/default

    APIは、次のような応答を返します。

          {
            "branches": {
              "master": {
                "video_cloud": true,
                "updated_at": "2015-02-23T18:36:39.323Z"
              },
              "preview": {
                "video_cloud": true,
                "updated_at": "2015-02-23T18:36:39.323Z"
              }
            },
            "publish_request": {
              "comment": "Player publish request",
              "author": "mboles@brightcove.com",
              "status": "COMPLETE",
              "requested_at": "2015-02-26T16:29:33.207Z",
              "queue_msg_id": "33533986-10d3-4585-8dcd-7ea52f3d2879",
              "errorCode": null,
              "errorMessage": null,
              "buildLog": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/logs/33533986-10d3-4585-8dcd-7ea52f3d2879.log",
              "retries": 0,
              "elapsed_time": 12
            },
            "name": "MySamplePlayer",
            "id": "default",
            "url": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/index.html",
            "embed_code": "<iframe src='//players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
            "embed_in_page": "http://players.brightcove.net/1507807800001/0d92f482-49d9-44e6-ba1d-e2360dab838a_default/in_page.embed",
            "repository_url": "https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default",
            "preview_url": "http://preview-players.brightcove.net/v1/accounts/1507807800001/players/0d92f482-49d9-44e6-ba1d-e2360dab838a/master/embeds/default/preview/index.html",
            "preview_embed_code": "<iframe src='//preview-players.brightcove.net/v1/accounts/1507807800001/players/0d92f482-49d9-44e6-ba1d-e2360dab838a/master/embeds/default/preview/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
          }

    Postmanを使用する

    Postmanは、APIと対話するためのより使いやすいUIを提供します。Postmanに慣れていない場合は、 HTTPリクエストにPostmanを使用する基本的な理解のためのドキュメント。Postmanを使用する場合、環境変数は作成しません。代わりに、URLに適切な値を使用してURLの場所を作成します。たとえば、以下は、アカウントとプレーヤーIDを含むPostmanで使用するための適切なURLを示しています。

          https://players.api.brightcove.com/v2/accounts/1507807800001/players/6aac508a-741e-41a2-bc7a-5805644cf089/embeds/default

    Postmanを使用するには、次の手順を実行します。

    1. フォームの上部にURLを入力します。
    2. HTTPメソッドをに設定します取得する
    3. を使用してヘッダーを作成しますコンテンツタイプおよび対応する値アプリケーション/ json
    4. クリック送信ボタン。
    5. プロンプトが表示されたら、Studioの資格情報を入力します。

    その後、応答が返されます。見やすくするために、必ずクリックしてください可愛いそしてJSON応答のすぐ上にあるボタン。

    郵便配達の例
    郵便配達の例

    プレイヤー履歴

    このセクションでは、gitコマンドを使用します。gitの非常に簡単なチュートリアルについては、 Gitの概要資料。

    まず、プレーヤーリポジトリのクローンを作成します。プレイヤーIDの名前で、発行したディレクトリにディレクトリが作成されます。git cloneコマンド。

    1. ターミナル/コマンドプロンプトを開き、フォルダを作成する場所に移動します。
    2. 次に、次の形式でプレーヤーリポジトリのURLを作成します。
            https://repos.api.brightcove.com/v1/accounts/ACCOUNT_ID/repos/PLAYER_ID_default

      例:

            https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
    3. コマンドプロンプトで、プレーヤーリポジトリのクローンを作成するディレクトリを作成または移動します。
    4. そのディレクトリに移動したら、次のgitコマンドを入力して、プレーヤーリポジトリのクローンを作成し、自分のアカウントとプレーヤーIDを置き換えます。
            git clone https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
      キーを押し、Return/Enter キーを押します。
    5. 応答では、次のようなものが表示されます。
            '0d92f482-49d9-44e6-ba1d-e2360dab838a_default'へのクローン作成...
            リモート:オブジェクトのカウント:39、完了。
            リモート:オブジェクトの圧縮:100%(31/31)、完了。
            リモート:合計39(デルタ13)、再利用0(デルタ0)
            オブジェクトの開梱:100%(39/39)、完了。
            接続を確認しています...完了しました。
    6. コマンドライン(またはファイルマネージャー)で、複製されたプレーヤーディレクトリを見つけて、目的の場所に複製されたことを確認します。次のように名前が付けられます。
            {player_id}_default
    7. コマンドラインで、ディレクトリを前の手順で見つけたクローンプレーヤーリポジトリディレクトリに変更します。
    8. 次のコマンドを入力します。
            gitログ
      キーを押し、Return/Enter キーを押します。
    9. 次のような応答が表示されます。
            コミットb4ed1c2e3d429cc41b704fd44bebdc31f661a95c
            作者:bc86ece6-b3d-4d78-a67d-93b503dc1c2e < mboles@brightcove.com >
            日付:   2015年2月26日木曜日16:29:43 + 0000
            
                プレイヤー公開リクエスト
            
            コミット6c854213b2b2597225c36212dc8be545fcf2c104
            作者:bc86ece6-b3d-4d78-a67d-93b503dc1c2e < mboles@brightcove.com >
            日付:   2015年2月26日木曜日16:28:13 + 0000
            
                プレイヤー公開リクエスト
            
            コミット7f78d49cb678259351f83a94e655f88607de077f
            著者:6b112bd1-987c-41a2-84ac-f9dd8302b567 <mboles@brightcove.com>
            日付:   2015年2月23日月曜日18:36:49 + 0000
            
                作成されたプレーヤー
    10. コミットIDは、より詳細な情報を取得するために使用されます。詳細については、コミット情報を参照してください。

    コミット情報

    以下を使用して、プレーヤーのコミットに関するさまざまな情報を収集できます。もちろん、前のセクションで示したように、プレーヤー履歴の応答から取得できる特定のコミットIDを置き換える必要があります。

    • 単一のコミットに関する詳細を表示する(公開リクエスト)
            git show e6e14ecda8e7790bf7d91e5e794507e776eef770
    • コミット間の違いを表示する(リクエストを公開する)
            git diff e6e14ecda8e7790bf7d91e5e794507e776eef770 64a28431b3727d798510343caacb263c2829572d
    • 各コミットで変更されたファイルを表示する
            git log --name-status