プレイヤーの拡張機能を追加する

プレイヤーの拡張機能を使用すると、ロゴなどのブランディング要素を組み込むためにビデオプレイヤーを変更し、視聴者に提示する追加オプションをカスタマイズできます。

プレイヤーの拡張機能は、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": "オプションのビデオタイトル",
        "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ダッシュボードを介してプレイヤーのプロパティを更新する

1. Cloudflareダッシュボード ↗にログインし、アカウントを選択します。
2. Stream > Videosを選択します。
3. 編集するビデオをリストから選択します。
4. Public Detailsタブを選択します。
5. Public Detailsから、設定したいプロパティのテキストフィールドに情報を入力します。
6. 完了したら、Saveを選択します。