選擇退出玩家自動更新

本主題說明如何選擇退出自動播放程式更新,以及將播放器設定為特定版本。

注意:本文件使用 curl 陳述式來執行使用播放程式管理 API 的作業。在 curl 語句中,您將看到 $EMAIL{account_id}{player_id}的值。您必須依這些名稱建立環境變數並指定對應的值,或提供變數的常值。

玩家自動更新

默認情況下,Brightcove自動定期更新所有播放器,以便他們可以利用新功能和修復功能,而無需客戶付出任何努力。儘管Brightcove在大多數情況下不建議您不選擇更新,但Brightcove意識到,有些客戶會不時地希望您的播放器保持完全不受干擾(例如,您已經進行了嚴格的測試以準備大型活動,而您沒有想要冒險進行任何更改)。

選擇退出自動更新

如果您發現有一段時間需要退出播放器更新,最簡單的方法是將PATCH應用於播放器的配置。以下curl語句執行此任務:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
        "player": {
            "template": {
              "locked": true
            }
        }
    }' \
    https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/configuration

這會將鎖定的設置添加到預覽播放器。PATCH最初僅影響預覽播放器,因此您需要發布播放器。您可以在Studio中或使用以下curl語句來執行此操作:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request POST \
    https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/publish

重新選擇自動更新

當您準備重新加入更新時,只需應用另一個更新,設置lockedfalse然後重新發布播放器。首先,您將鎖定更改為false:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
      "player": {
        "template": {
          "locked": false
        }
      }
        }' \
        https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/configuration

如果與當前版本不同,這會將您的預覽播放器更新為當前的播放器模板版本。您應該使用此調用返回的預覽播放器URL進行測試,以確保您的播放器仍能正常運行。一旦滿意,您就可以發布播放器以使新播放器上線:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request POST \
    https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/publish

切換到特定版本

您可能希望將播放器切換到特定版本。您可能選擇退出更新,但想要使用退出更新後的某些特定版本。為此,請使用以下curl語句,當然要替換您想要的播放器的特定版本:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
      "player": {
        "template": {
          "version": "1.14.11"
        }
      }
        }' \
        https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/configuration

請注意,您可以同時設置版本和退出更新:

    curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
      "player": {
        "template": {
          "version": "1.14.11",
          "locked": true
        }
      }
        }' \
        https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/configuration

與任何PATCH更新一樣,一旦您對更改感到滿意,就必鬚髮布播放器:

    curl \
    --header "Content-Type: application/json"cp
    --user $EMAIL \
    --request POST \
        https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/publish