プレーヤーの拡張を使うと、ロゴなど自社ブランディングの要素を動画プレーヤーに取り入れ、視聴者に提示する追加オプションをカスタマイズできます。
プレーヤーの拡張は、Stream Player を使う動画には自動で適用されます。独自プレーヤーを使う場合は、publicDetails プロパティで詳細を追加する必要があります。
title: 視聴者が動画にカーソルを合わせたときに表示されるタイトルです。動画のファイル名と異なる場合があります。share_link: 動画 URL をワンクリックでコピーして共有できるオプションです。埋め込み先ページの URL を設定することが多いです。channel_link: 動画プレーヤーのロゴを選んだときにユーザーが移動する URL です。logo: ロゴ画像の有効な HTTPS URL です。
次の例は、publicDetails で設定できるすべてのプロパティを含みます。
curl --location --request POST "https://api.cloudflare.com/client/v4/accounts/<$ACCOUNT_ID>/stream/<$VIDEO_UID>" \
--header "Authorization: Bearer <$SECRET>" \
--header 'Content-Type: application/json' \
--data-raw '{
"publicDetails": {
"title": "Optional video title",
"share_link": "https://my-cool-share-link.cloudflare.com",
"channel_link": "https://www.cloudflare.com/products/cloudflare-stream/",
"logo": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/94/Cloudflare_Logo.png/480px-Cloudflare_Logo.png"
}
}' | jq ".result.publicDetails"publicDetails のプロパティは任意なので、含めるプロパティを選べます。次の例では、動画に logo だけを追加します。
curl --location --request POST "https://api.cloudflare.com/client/v4/accounts/<$ACCOUNT_ID>/stream/<$VIDEO_UID>" \
--header "Authorization: Bearer <$SECRET>" \
--header 'Content-Type: application/json' \
--data-raw '{
"publicDetails": {
"logo": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/94/Cloudflare_Logo.png/480px-Cloudflare_Logo.png"
}
}'次のエンドポイントで JSON を取得することもできます。
https://customer-<ID>.cloudflarestream.com/<VIDEO_ID>/metadata/playerEnhancementInfo.json
-
Cloudflare ダッシュボードで Videos ページを開きます。
Videos を開く ↗ -
一覧から編集する動画を選びます。
-
Public Details タブを選択します。
-
Public Details で、設定するプロパティのテキスト欄に情報を入力します。
-
完了したら Save を選択します。