显示缩略图

可以使用特殊链接从视频中生成缩略图，您指定要从视频中获取缩略图的时间点。

https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.jpg?time=1s&height=270

在嵌入 URL 中使用 poster 查询参数，您可以将缩略图设置为视频中的任意时间点。如果需要 signed URLs，必须使用 signed URL 而非 video UID。

<iframe
  src="https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/iframe?poster=https%3A%2F%2Fcustomer-f33zs165nr7gyfy4.cloudflarestream.com%2F6b9e68b07dfee8cc2d116e4c51d6a957%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600"
  style="border: none; position: absolute; top: 0; left: 0; height: 100%; width: 100%;"
  allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;"
  allowfullscreen="true"
></iframe>

支持的 URL 属性：

• time（默认 0s，可配置）视频中的时间点，例如 8m、5m2s
• height（默认 640）
• width（默认 640）
• fit（默认 crop）说明当请求的高度和宽度与原始上传不匹配时的处理方式，应为以下之一：
  • crop 裁剪不适合给定尺寸的视频部分
  • clip 保留整个帧并在给定尺寸内缩小图像
  • scale 扭曲图像以适应给定尺寸
  • fill 保留整个帧并用黑色背景填充请求尺寸的其余部分

默认情况下，Stream Player 将缩略图设置为视频的第一帧。您可以通过 API 设置 thumbnailTimestampPct 值，按视频更改此设置：

curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-d '{"thumbnailTimestampPct": 0.5}' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>

thumbnailTimestampPct 是 0.0（视频第一帧）到 1.0（视频最后一帧）之间的值。例如，如果您希望缩略图为视频中间帧，可以将 thumbnailTimestampPct 设为 0.5。使用相对值可以在您或用户的视频时长不同时设置默认缩略图。

Stream 支持动画 GIF 作为缩略图。观看动画缩略图不计入 Stream Analytics 中的计费交付分钟数或观看分钟数。

https://customer-f33zs165nr7gyfy4.cloudflarestream.com/6b9e68b07dfee8cc2d116e4c51d6a957/thumbnails/thumbnail.gif?time=1s&height=200&duration=4s

动画缩略图支持的 URL 属性：

• time（默认 0s）视频中的时间点，例如 8m、5m2s
• height（默认 640）
• width（默认 640）
• fit（默认 crop）说明当请求的高度和宽度与原始上传不匹配时的处理方式，应为以下之一：
  • crop 裁剪不适合给定尺寸的视频部分
  • clip 保留整个帧并在给定尺寸内缩小图像
  • scale 扭曲图像以适应给定尺寸
  • fill 保留整个帧并用黑色背景填充请求尺寸的其余部分
• duration（默认 5s）
• fps（默认 8）