添加播放器增强功能

通过播放器增强功能，您可以修改视频播放器以融入品牌元素（如 logo），并自定义向观众展示的额外选项。

播放器增强功能会自动应用于使用 Stream Player 的视频，但使用自己的播放器时，您需要通过 publicDetails 属性添加这些详情。

属性

title：观众悬停在视频上时显示的标题。标题可能与视频文件名不同。
share_link：为用户提供一键复制选项，便于分享视频 URL。通常设置为您嵌入视频的页面 URL。
channel_link：用户从视频播放器选择 logo 时将跳转到的 URL。
logo：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 仪表板更新播放器属性

在 Cloudflare 仪表板中，前往 Videos 页面。
Go to Videos ↗
从列表中选择要编辑的视频。
选择 Public Details（公开详情） 选项卡。
在 Public Details（公开详情） 下，为您要设置的属性在文本字段中输入信息。
完成后，选择 Save（保存）。