Player 庫

概述

為了發表 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

要使用郵遞員，請執行以下操作：

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

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

Player 歷史

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

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

打開終端/命令提示符，然後導航到要在其中創建文件夾的位置。

接下來，為 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

在命令提示符下，創建或移動到要在其中克隆目錄的目錄。 player 庫。
進入該目錄後，輸入以下git命令以克隆 player 存儲庫，替換您自己的帳戶並 player 編號：
```
      git clone https://repos.api.brightcove.com/v1/accounts/1507807800001/repos/0d92f482-49d9-44e6-ba1d-e2360dab838a_default
```
然後按回車/ Enter。

在響應中，您應該看到類似以下內容：

      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.

在命令行（或在文件管理器中）中，找到克隆的 player 目錄以確保將其克隆到所需位置；它的名稱如下：
```
      {player_id}_default
```
在命令行上，將目錄更改為已克隆目錄 player 您在上一步中找到的存儲庫目錄。
輸入命令：
```
      git log
```
然後按回車/ Enter。

您應該看到類似於以下內容的響應：

      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

提交ID將用於獲取更多詳細信息。有關更多詳細信息，請參見提交信息。

提交信息

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

顯示有關單個提交的詳細信息（發布請求）
```
      git show e6e14ecda8e7790bf7d91e5e794507e776eef770
```

顯示提交之間的差異（發布請求）

      git diff e6e14ecda8e7790bf7d91e5e794507e776eef770 64a28431b3727d798510343caacb263c2829572d

顯示每次提交中更改了哪些文件
```
      git log --name-status
```