本主題說明如何選擇退出自動播放程式更新,以及將播放器設定為特定版本。
注意:本文件使用 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
重新選擇自動更新
當您準備重新加入更新時,只需應用另一個更新,設置locked
至false
然後重新發布播放器。首先,您將鎖定更改為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