概述
為了發表 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 管理。 確保設置了以下環境變量:
- 帳戶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
- 在響應中,您應該看到類似以下內容:
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
- 您應該看到類似於以下內容的響應:
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