支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    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日