← Cloudflare Stream / stream / edit-videos

Stříhání videí

Vytváření klipů z videa, označované také jako „ořezávání“ nebo zkracování délky videa, umožňuje změnit počáteční a koncový bod videa tak, aby diváci viděli jen konkrétní „klip“. Pokud máte například dvacetiminutové video a chcete sdílet jen pětiminutový klip z jeho prostředka, můžete video oříznout tak, aby obsah před tímto pětiminutovým klipem a za ním zmizel.

Viz Dokumentace API pro ořez videa s dalšími informacemi.

Než budete moci video stříhat, budete potřebovat API token. Další informace o vytvoření API tokenu najdete v Vytváření API tokenů.

Chcete-li video oříznout, určete počáteční a koncový čas, který chcete ze stávajícího videa použít k vytvoření nového videa. Použijte videoUID a počáteční a koncový čas pro váš požadavek.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 20,
	"endTimeSeconds": 40
}

• clippedFromVideoUID: Jedinečný identifikátor videa použitého k vytvoření nového oříznutého videa.
• startTimeSeconds: Časové razítko z existujícího videa, které určuje, kdy nové video začíná.
• endTimeSeconds: Časové razítko z existujícího videa, které určuje, kdy nové video končí.
  
  

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts/<YOUR_ACCOUNT_ID_HERE>/stream/clip' \
--header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15
    }'

Zda je vaše video připravené k přehrání, můžete zjistit na Stream stránce v Cloudflare dashboard.

Během zpracování oříznutého videa odpověď se stavem videa zobrazuje Zařazeno do fronty. Jakmile je proces oříznutí dokončen, stav videa se změní na Připraveno a zobrazí nový název oříznutého videa a jeho novou délku.

Chcete-li dostat oznámení, jakmile bude vaše video zpracované a připravené k přehrání, můžete přihlásit se k odběru oznámení webhooku.

Při vytváření klipu z videa můžete zadat i nový název pro výsledný klip. V následujícím příkladu name pole udává nový název, který se má použít pro oříznuté video.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}

Jakmile je video oříznuté a zpracované, nově pojmenované video se zobrazí v seznamu videí ve vašem Cloudflare dashboardu.

Ke svému videu můžete přidat i vlastní vodoznak. Další informace o vodoznacích a nahrávání profilu vodoznaku najdete v Použití vodoznaků.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"watermark": {
		"uid": "4babd675387c3d927f58c41c761978fe"
	},
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}

Při vytváření klipu z videa můžete video nastavit jako soukromé a zpřístupnit ho pouze vybraným uživatelům tím, že vyžadující podepsanou adresu URL.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"requireSignedURLs": true,
	"meta": {
		"name": "signed-urls-demo.mp4"
	}
}

Po dokončení vystřižení videa můžete otevřít Cloudflare dashboard a seznam videí, kde své video najdete. Po výběru videa se Nastavení zobrazí zaškrtnutí vedle Vyžadování podepsaných URL adres.

Náhledový obrázek videa můžete zadat i pomocí procentuální hodnoty. Chcete-li převést časový údaj náhledu ze sekund na procenta, vydělte požadovaný časový údaj celkovou délkou videa. Další informace o náhledech najdete v Zobrazení náhledových obrázků.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"thumbnailTimestampPct": 0.5,
	"meta": {
		"name": "thumbnail_percentage.mp4"
	}
}