支持 聯繫支持 | 系統狀況 系統狀態

Player 庫

在本主題中,您將學習如何 Player Management API 利用 Delivery System API 在以下位置存儲和維護信息 Brightcove Players.

概述

為了發表 player到CDN, Player Management API 利用 Delivery System API。 “ Delivery System API 允許您創建一個git存儲庫,其內容託管在 players.brightcove.net。 當 player 創建後,Brightcove在後台創建了一個存儲庫。 每次 player 重新發布,無論是發布者直接請求還是在Brightcove player 更新已發布,存在相應的提交並推送到該存儲庫。

除其他外,Git存儲庫提供了隨時間變化的歷史記錄。 在調試時 player,有時獲得此存儲庫的副本非常有用,因此您可以自己檢查更改歷史記錄。 首先,您將學習如何檢索有關您的常規信息 player,使用命令行工具curl和/或Chrome插件Postman。 然後,您將學習如何看待 player 創建和發布的歷史。

Player 信息

那些習慣於命令行的人很可能想要使用curl來獲取 player 信息,而那些更熟悉GUI的用戶將選擇Postman選項。

使用捲曲

如果您不熟悉curl和設置環境變量,請通讀 一步步: Player 管理。 確保設置了以下環境變量:

  • EMAIL
  • 帳戶ID
  • PLAYER_ID

然後,您可以使用以下curl語句獲取有關您的信息 player.

      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提供了更友好的UI與API進行交互。 如果您不熟悉Postman,請通讀 使用Postman進行HTTP請求 doc以獲得基本了解。 使用Postman時不創建環境變量。 而是使用URL中的適當值構建URL位置。 例如,以下顯示了一個適用於Postman的URL,其中包含帳戶和 player ID。

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

要使用郵遞員,請執行以下操作:

  1. 在表單頂部輸入URL。
  2. 將HTTP方法設置為 GET.
  3. 使用創建標題 內容類型 和相應的值 應用程序/ JSON.
  4. 點擊 發送 按鈕。
  5. 出現提示時輸入Studio憑據。

然後將返迴響應。 為了便於查看,請務必單擊 漂亮JSON 響應上方的按鈕。

郵遞員示例
郵遞員示例

Player 歷史

在本節中,您將使用git命令。 有關git的簡短教程,請參見 Git概述 文件。

您將首先克隆一個 player 回購。 將以以下名稱創建目錄 player ID,在您發布目錄的目錄中 git clone 命令。

  1. 打開終端/命令提示符,然後導航到要在其中創建文件夾的位置。
  2. 接下來,為 player 回購形式:
          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. 在命令提示符下,創建或移動到要在其中克隆目錄的目錄。 player 庫。
  4. 進入該目錄後,輸入以下git命令以克隆 player 存儲庫,替換您自己的帳戶並 player 編號:
          git clone https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
    然後按回車/ Enter。
  5. 在響應中,您應該看到類似以下內容:
          Cloning into '0d92f482-49d9-44e6-ba1d-e2360dab838a_default'...
          remote: Counting objects: 39, done.
          remote: Compressing objects: 100% (31/31), done.
          remote: Total 39 (delta 13), reused 0 (delta 0)
          Unpacking objects: 100% (39/39), done.
          Checking connectivity... done.
  6. 在命令行(或在文件管理器中)中,找到克隆的 player 目錄以確保將其克隆到所需位置; 它的名稱如下:
          {player_id}_default
  7. 在命令行上,將目錄更改為已克隆目錄 player 您在上一步中找到的存儲庫目錄。
  8. 輸入命令:
          git log
    然後按回車/ Enter。
  9. 您應該看到類似於以下內容的響應:
          commit b4ed1c2e3d429cc41b704fd44bebdc31f661a95c
          Author: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e <mboles@brightcove.com>
          Date:   Thu Feb 26 16:29:43 2015 +0000
          
              Player publish request
          
          commit 6c854213b2b2597225c36212dc8be545fcf2c104
          Author: bc86ece6-b3dd-4d78-a67d-93b503dc1c2e <mboles@brightcove.com>
          Date:   Thu Feb 26 16:28:13 2015 +0000
          
              Player publish request
          
          commit 7f78d49cb678259351f83a94e655f88607de077f
          Author: 6b112bd1-987c-41a2-84ac-f9dd8302b567 <mboles@brightcove.com>
          Date:   Mon Feb 23 18:36:49 2015 +0000
          
              Player created
  10. 提交ID將用於獲取更多詳細信息。 有關更多詳細信息,請參見提交信息。

提交信息

以下內容可用於收集有關以下內容的不同信息: player 提交。 當然,您需要替換您的特定提交ID,這些ID可以從 player 歷史響應,如上一節所示。

  • 顯示有​​關單個提交的詳細信息(發布請求)
          git show e6e14ecda8e7790bf7d91e5e794507e776eef770
  • 顯示提交之間的差異(發布請求)
          git diff e6e14ecda8e7790bf7d91e5e794507e776eef770 64a28431b3727d798510343caacb263c2829572d
  • 顯示每次提交中更改了哪些文件
          git log --name-status

頁面最後更新於12年2020月XNUMX日