このトピックでは、プレーヤーの自動更新をオプトアウトする方法と、プレーヤーを特定のバージョンに設定する方法について説明します。
注:このドキュメントでは、curl ステートメントを使用して、Player Management 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