← Cloudflare Stream / stream / viewing-videos

Zobrazení náhledových obrázků

Případ použití 1: Generování náhledového obrázku za běhu

Náhledový obrázek videa lze vygenerovat pomocí speciálního odkazu, ve kterém zadáte čas videa, ze kterého chcete náhled získat.

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

Příklad náhledového obrázku vygenerovaného z ukázkového videa

Pomocí poster parametr dotazu v embed URL adrese můžete nastavit náhledový obrázek na libovolný čas ve vašem videu. Pokud podepsané URL adresy jsou vyžadovány, musíte místo ID videí použít podepsanou adresu URL.

<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>

Podporované atributy URL jsou:

time (výchozí 0s, konfigurovatelný) čas videa, například 8m, 5m2s
height (výchozí 640)
width (výchozí 640)
fit (výchozí crop) určující, jak postupovat, když požadovaná výška a šířka neodpovídají původně nahranému souboru; hodnota musí být jedna z těchto:
- crop oříznout části videa, které se nevejdou do zadané velikosti
- clip zachová celý snímek a zmenší velikost obrázku v rámci zadané velikosti
- scale zdeformovat obrázek tak, aby odpovídal zadané velikosti
- fill zachová celý snímek a zbytek požadované velikosti vyplní černým pozadím

Případ použití 2: Nastavení výchozího času náhledového obrázku pomocí API

Stream Player standardně nastaví náhledový obrázek na první snímek videa. Toto můžete pro jednotlivá videa změnit nastavením hodnoty "thumbnailTimestampPct" přes API:

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 je hodnota mezi 0.0 (první snímek videa) a 1.0 (poslední snímek videa). Pokud chcete, aby náhledový obrázek odpovídal snímku v polovině videa, můžete nastavit thumbnailTimestampPct na hodnotu 0.5. Použití relativních hodnot tímto způsobem vám umožní nastavit výchozí náhledový obrázek i v případě, že se délka vašich videí nebo videí vašich uživatelů liší.

Případ použití 3: Generování animovaných náhledových obrázků

Stream podporuje animované GIFy jako náhledové obrázky. Zobrazení animovaných náhledů se nezapočítává do fakturovaných doručených minut ani do zhlédnutých minut v Stream Analytics.

Animované GIF náhledy

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

Příklad animovaného gifu, generovaného na vyžádání z Cloudflare Stream

Podporované atributy URL pro animované náhledy jsou:

time (výchozí 0s) času videa, například 8m, 5m2s
height (výchozí 640)
width (výchozí 640)
fit (výchozí crop) určující, jak postupovat, když požadovaná výška a šířka neodpovídají původně nahranému souboru; hodnota musí být jedna z těchto:
- crop oříznout části videa, které se nevejdou do zadané velikosti
- clip zachová celý snímek a zmenší velikost obrázku v rámci zadané velikosti
- scale zdeformovat obrázek tak, aby odpovídal zadané velikosti
- fill zachová celý snímek a zbytek požadované velikosti vyplní černým pozadím
duration (výchozí 5s)
fps (výchozí 8)