Inline video: pravidla a příklady

Inline video je hostovaný nebo externě vložený záznam umístěný v čtecím toku článku, který demonstruje, vysvětluje nebo dokumentuje jednu ohraničenou myšlenku. Zahrnuje viditelný štítek, promyšlený náhledový snímek, ovládací prvky přehrávání, titulky, délku trvání a úplný přepis. Bez těchto okolních slov je neoznačený přehrávač neviditelný pro každého čtenáře, který nemůže nebo se rozhodne nesledovat – a pro systémy, které extrahují text místo dekódování záznamu, je téměř prázdný.

Komentář k náhledovému snímku je specifikací pro zachycení, nikoli odkazem na aktivum. Okolní HTML demonstruje požadované pořadí čtení před dokončením mediální produkce.

Proč na tomto prvku záleží

Video snižuje náklady na vysvětlení, když pohyb, načasování, hlas nebo změna v čase nese význam. Čtenář vidí, jak se otevírá menu, jak se pohybuje fyzický produkt nebo jak mluvčí kvalifikuje závěr. Sledování vyžaduje pozornost, zvuk nebo titulky, čas a často více dat než čtení, proto jasný štítek a délka trvání umožňují čtenáři posoudit tyto náklady.

Náhledové snímky ovlivňují toto rozhodnutí ještě před přehráváním. Reprezentativní záběr slouží jako vizuální příslib toho, co záznam obsahuje. Náhodný záběr se zavřenýma očima, načítacím kolečkem nebo nesouvisejícím titulkem působí nedbale a nutí čtenáře spustit přehrávání, aby zjistil, o čem video je. Náhledový snímek by měl odhalit stav, osobu, objekt nebo výsledek, který video skutečně vysvětluje.

Strojová extrahovatelnost je schopnost softwaru získat význam obsahové jednotky bez reprodukce její prezentace. Holý iframe obvykle odhalí jen málo víc než URL poskytovatele. Označený prvek odhalí název, shrnutí, délku trvání, datum, náhledový snímek, titulky, přepis a stabilní identifikátor. Vyhledávací, překladové, přístupnostní a vyhledávací systémy pak mohou ohraničenému vysvětlení porozumět.

Přepis je tedy součástí prvku, nikoli volitelným stažením. Uchovává mluvená tvrzení, změny mluvčích, smysluplné zvuky a vizuální akce v pořadí dokumentu. Titulky podporují zážitek z přehrávání; přepis podporuje stránku. Řiďte se sdílenými pravidly pro psaní prvků pro sémantickou prioritu, direktivní syntaxi a mapování těla. Tato stránka má přednost tam, kde vyžaduje přepis, náhledový snímek, délku trvání a pole přístupnosti specifická pro video.

Kdy jej použít

Použijte inline video, když časově podmíněný důkaz učiní ohraničený bod srozumitelnějším než statické obrázky a próza. Vhodné případy zahrnují operaci v rozhraní, fyzickou techniku, viditelný přechod, odborné vysvětlení, chování produktu závislé na pohybu nebo zaznamenaný výsledek, jehož podání je důkazem.

Před pořízením záznamu použijte test nahrazení. Pokud jeden snímek obrazovky a dvě věty vysvětlí bod stejně dobře, použijte je: načítají se rychleji, rychleji se procházejí a stojí méně při aktualizaci. Video si své místo zaslouží, když posloupnost, tempo, pohyb, hlas nebo pozorované chování mění porozumění.

Mezi hraniční případy patří:

• Dlouhý webcast v nesouvisejícím odstavci: odkažte na vyhrazenou stránku s videem nebo použijte celou sekci pro vložení videa. Inline prvek musí sloužit místnímu argumentu, nikoli importovat hodinu sousedního tématu.
• Tichá smyčková dekorace: to je motion design, nikoli redakční video. Odstraňte ji nebo s ní nakládejte jako s dekorativním médiem s chováním pro omezený pohyb.
• Záznam obrazovky použitý místo instrukcí: napište kroky a cílový stav textem. Video je může demonstrovat, ale nesmí být jediným způsobem, jak úlohu dokončit.
• Citace zákazníka vyjmutá z kontextu: krátký klip může podpořit případovou studii pouze tehdy, jsou-li uvedeni mluvčí, vztah, datum záznamu, schválení a okolní tvrzení.
• Video, jehož jedinou hodnotou je osobnost: použijte jej pouze tehdy, když je hlas, podání nebo autorita mluvčího relevantní. Nenuťte čtenáře sledovat, jak přednášející čte text, který je již na stránce.
• Několik srovnatelných klipů: použijte galerii nebo vyhrazenou mediální sekci, když je úkolem výběr mezi záznamy. Neřaďte inline přehrávače za sebou.

Kam jej umístit

Umístěte video bezprostředně za odstavec, který pojmenovává, co se čtenář naučí nebo uvidí. Název, délku trvání a shrnutí uveďte před přehrávač. Přepis umístěte přímo za něj, sbalený pouze tehdy, když zůstává úplný text v HTML bez kódu přehrávání.

V postupu umístěte přehrávač za napsanou sekvenci akcí a před řešení problémů. Čtenář by měl být schopen jednat bez sledování a poté použít záznam k potvrzení pohybu nebo stavu rozhraní. V argumentu nebo případové studii uveďte tvrzení před záznamem a jeho omezení interpretujte po něm.

Neumísťujte jej vedle jiného přehrávače, automaticky přehrávané animace, velké výzvy k akci, formuláře nebo kalkulačky. Konkurující si ovládací prvky vytvářejí nejasné zaměření. Neumísťujte jej dovnitř buňky tabulky, položky seznamu, rámečku, karty, karuselu, panelu accordionu nebo klikatelné karty. Přepis může používat ovládací prvek zveřejnění; celé video nesmí.

Název, shrnutí, náhledový snímek, přehrávač, délku trvání, ovládací prvek přepisu a autorský kredit ponechte v jedné hranici figure. Zdrojová poznámka může bezprostředně následovat. Nikdy neoddělujte přehrávač od jeho přepisu reklamou, propagací nebo nesouvisející sekcí.

Anatomie

1. Viditelný název: Pojmenovává úlohu, ukázku, událost nebo tvrzení specifickým HTML textem.
2. Shrnutí: Vysvětluje v jedné větě, co čtenář uvidí a proč na tom záleží.
3. Délka trvání: Udává náklady na sledování před přehráním v minutách a sekundách.
4. Náhledový snímek: Zobrazuje reprezentativní, schválený snímek, aniž by sám o sobě předstíral, že je tlačítkem.
5. Ovládání přehrávače: Poskytuje přehrávání, pauzu, vyhledávání, hlasitost, celou obrazovku, rychlost přehrávání a přístup k titulkům.
6. Titulky: Synchronizují dialog, změny mluvčích a smysluplné neřečové audio s přehráváním.
7. Přepis: Reprodukuje úplnou smysluplnou sekvenci jako volitelný, prohledávatelný HTML text.
8. Vizuální popisy: Zaznamenávají smysluplné akce na obrazovce nebo změny, které vyprávění neuvádí.
9. Autorský kredit a zdroj: Identifikuje mluvčího, tvůrce, datum záznamu nebo původ důkazu, je-li to relevantní.

Název není název souboru a shrnutí není „Podívejte se na video níže.“ Každé musí zůstat užitečné, i když je zkopírováno bez přehrávače.

Příklady provedení

Všechny varianty sdílejí stejný obsahový kontrakt. Mění se způsob doručení; označování, titulky, kvalita přepisu, souhlas s přehráváním a pořadí čtení se nemění.

Hostovaná ukázka

Použijte first-party HTML5 přehrávač pro krátký záznam produktu nebo procesu, pokud organizace kontroluje kódování, titulky, výběr náhledového snímku a dostupnost.

Externí vložení s ohledem na soukromí

Použijte externí platformu, pokud je vyžadováno její doručení, analytika nebo zavedený kanál. Načtěte poskytovatele pouze po udělení souhlasu tam, kde to politika vyžaduje, identifikujte poskytovatele před aktivací a zachovejte místní přepis, i když poskytovatel záznam odstraní.

Krátký klip rozhraní

Použijte stručný klip pro jednu změnu stavu, kterou je obtížné sdělit statickými obrázky. Stále potřebuje ovládací prvky, mechanismus pauzy, smysluplný textový popis a přepis; nepřeměňujte jej na automaticky se opakující GIF.

Klip s rozhovorem nebo důkazem

Použijte klip vedený mluvčím, když záleží na autorství, formulaci nebo pozorovaném svědectví. Uveďte jméno a roli osoby v HTML, zveřejněte úpravy a přepište jak řeč, tak materiální vizuální důkazy.

Parametry

Tato pole tvoří přenosný obsahový kontrakt. Šířka, okraj, stín, styl tlačítka přehrávání a chování při zlomu náleží vykreslovacímu modulu.

První nadpis v těle se mapuje na title; první odstavec na summary; zbytek těla na transcript. Časové úseky v přepisu jsou volitelné pro souvislé vysvětlení jedním mluvčím a doporučené pro postupy, změny mluvčích a záznamy delší než dvě minuty. Pole autoplay, loop a audio na pozadí jsou záměrně nepřítomna.

Syntaxe a příklady kódu

Každý zápis zachovává stejný název, shrnutí, metadata média, titulky a přepis. Uvedené domény popisují kontrakt a nejsou referencemi na produkční aktiva.

Přenositelná direktiva Markdown

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}

## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
:::

Hugo shortcode

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
{{< /inline-video >}}

Toto je zamýšlený kontrakt adaptéru, nikoli tvrzení, že lokální shortcode existuje. Používá pouze pojmenované parametry. Dokud není zaregistrován vykreslovací modul, používejte sémantické HTML figure, video, track a transcript, které zachovává stejná pole.

WordPress blok

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>Filter pages that need review</h2>
<p>See how to apply the Needs review filter and verify the resulting work queue.</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>Read the transcript</summary><p><strong>00:00–00:18 — Open the report.</strong> From Audit, open Freshness.</p><p><strong>00:19–00:54 — Apply the filter.</strong> Open Status and choose Needs review.</p><p><strong>00:55–01:30 — Verify the queue.</strong> Confirm that every visible row has the expected status.</p></details>
<!-- /wp:amicited/inline-video -->

Pokud registrovaný WordPress blok není k dispozici, použijte nativní bloky Video, Heading, Paragraph a Details. Nevkládejte iframe a nevynechávejte lokální přepis.

Příklady

Dobře: ohraničená ukázka s alternativou čtení

Filtrování stránek, které potřebují revizi · 1:30

Video ukazuje jeden úkol: otevření reportu freshness, použití filtru stavu a kontrola počtu výsledků. Jeho náhledový snímek zobrazuje otevřený filtr, titulky přesně identifikují popisky rozhraní a třídílný přepis zaznamenává každou akci a kontrolu úspěchu. Přehrávání začíná až po aktivaci.

Toto funguje, protože čtenář může odhadnout hodnotu a časovou náročnost, sledovat se zvukem, sledovat s titulky nebo splnit stejný úkol z přepisu. Záznam přidává důkaz o pohybu a změně stavu, aniž by se stal jedinou instrukcí.

Špatně: neoznačený přehrávač

Podívejte se na toto Třetí stranou vložený iframe se automaticky načte pod nadpisem. Jeho náhledový snímek je černý rámeček, není uvedena délka trvání, titulky jsou generované poskytovatelem a nebyly zkontrolovány a stránka neobsahuje žádný přepis ani shrnutí.

Špatná verze nutí každého nesledujícího čtenáře hádat. Extraktorům neposkytuje žádné téma, žádá čtenáře citlivé na soukromí, aby kontaktovali poskytovatele před volbou přehrávání, nenabízí trvalý text, když záznam zmizí, a může prezentovat nesprávné titulky jako fakt. Napravte to konkrétním názvem a shrnutím, promyšleným náhledovým snímkem, délkou trvání, načítáním s ohledem na souhlas, zkontrolovanými titulky, úplným lokálním přepisem a napsaným úkolem nebo tvrzením mimo přehrávač.

Značení schema a přístupnost

Inline video automaticky nevytváří nárok na schema. Použijte VideoObject pouze tehdy, když stránka viditelně poskytuje přesné hodnoty name, description, thumbnailUrl, uploadDate, duration a contentUrl nebo embedUrl pro přístupný záznam. Nikdy nevymýšlejte pole, abyste uspokojili validátor, nebo neoznačujte dekorativní klip jako primární video.

Relevantní video může podpořit způsobilý Article, HowTo nebo Product, pokud stránka samostatně splňuje podmínky. Jeho přepis nemůže ospravedlnit tvrzení nebo kroky, které na viditelné stránce chybí.

Přístupnost začíná před přehráváním. Označte figure, zobrazte název a délku trvání v textu a zajistěte, aby ovládací prvky fungovaly s klávesnicí a měly viditelné zaměření. Nikdy nespouštějte automatické přehrávání. Zajistěte pauzu, vyhledávání, hlasitost, rychlost, titulky a celou obrazovku. Neuzamčete zaměření v přehrávači třetí strany; po zavření celé obrazovky jej vraťte na spouštěcí ovládací prvek.

Titulky musí být synchronizované, s interpunkcí a zkontrolované proti záznamu. Identifikujte mluvčí, když hlas není zřejmý, a zahrňte smysluplné zvuky, jako je „[oznamovací tón]“, pokud ovlivňují porozumění. Zvukový popis je vyžadován, když smysluplná vizuální informace není uvedena v hlavním audiu; samotný popisný přepis nečiní časovaný zážitek z přehrávání rovnocenným.

Přepis musí být skutečné HTML v logickém pořadí – nikoli canvas, obsah pouze pro přehrávání, skrytý text nebo stažení pouze jako PDF. Ovládací prvky zveřejnění potřebují přístupný název a rozbalený stav. Přehrávač a přepis musí fungovat při 200% zoomu a úzkých šířkách bez horizontálního posouvání na úrovni stránky.

Pravidla psaní

Slova kolem přehrávače určují, zda je video obsahovým prvkem nebo nevysvětleným objektem:

• Napište konkrétní název o 4–12 slovech. Pojmenujte úlohu, ukázku, mluvčího, událost nebo zjištění; nikdy nepoužívejte samostatně „Video,“ „Podívejte se na toto“ nebo „Dozvědět se více“.
• Napište jednu shrnující větu o 15–35 slovech, která čtenáři sdělí, co se děje a proč na tom záleží. Neopakujte název.
• Udržujte inline záznamy zaměřené a běžně do pěti minut. Tvrdé maximum je 20 minut; delší záznamy patří na vyhrazenou stránku nebo vyžadují redakční segmentaci.
• Uveďte délku trvání před přehráním. Použijte M:SS pro viditelný text a ISO 8601, například PT1M30S, ve strukturovaných polích.
• Zvolte náhledový snímek, který reprezentuje téma při běžné velikosti zobrazení. Vyhněte se prázdným rámům, kolečkům, náhodným výrazům, klamavým tlačítkům přehrávání, drobnému textu rozhraní a neschváleným osobním nebo zákaznickým údajům.
• Zkontrolujte titulky proti finálnímu sestřihu. Opravte jména, názvy produktů, čísla, doménovou terminologii, interpunkci, změny mluvčích a smysluplné zvuky.
• Přepište všechen smysluplný mluvený obsah a vizuální prvky. Shrnutí, názvy kapitol a automaticky generované soubory titulků nenahrazují přepis.
• Používejte krátké odstavce přepisu, označení mluvčích tam, kde je to potřeba, a časové úseky kolem fází postupu nebo změn tématu. Nevytvářejte citace z parafrázované řeči.
• Uveďte úpravy, které by mohly změnit interpretaci. Nesestřihávejte svědectví, experiment nebo ukázku tak, aby posloupnost implikovala nepodložený výsledek.
• Udržujte základní instrukce, ceny, varování, podmínky způsobilosti, důkazy a výzvy k akci mimo záznam. Čtenář nesmí být nucen prohledávat časovou osu, aby našel důležitý fakt.
• Nikdy neumísťujte automatické přehrávání, blikající obsah, audio na pozadí, konverzní překryvy, pole přepisu pod zámkem nebo druhý přehrávač dovnitř prvku.
• Zaznamenejte vlastníka média a spouštěč kontroly. Znovu zkontrolujte video, když se změní rozhraní, politika, chování produktu, atribuce mluvčího nebo okolní tvrzení.

Typy příspěvků, které jej používají

Pole postTypes v front matter řídí tuto matici. Zařazení povoluje inline video, když časově podmíněný důkaz přidává význam; nevyžaduje přehrávač na každé stránce.

Kontrolní seznam QA

• Video přidává časově podmíněný význam, který statický obrázek a stručná próza nedokážou stejně dobře sdělit.
• Viditelný název specificky pojmenovává záznam a shrnutí vysvětluje jeho hodnotu před přehráním.
• Délka trvání se zobrazí předtím, než čtenář aktivuje přehrávač.
• Náhledový snímek je reprezentativní, čitelný, schválený a bez soukromého nebo zavádějícího obsahu.
• Přehrávání nikdy nezačíná automaticky, nespouští se neočekávaně ve smyčce a nevydává zvuk bez akce čtenáře.
• Ovládací prvky přehrávání, pauzy, vyhledávání, hlasitosti, rychlosti, titulků a celé obrazovky fungují s klávesnicí i dotykem.
• Titulky odpovídají finálnímu sestřihu a správně zachovávají jména, čísla, změny mluvčích a smysluplné zvuky.
• Smysluplné vizuální prvky nepředané řečí mají zvukový popis nebo ekvivalentní alternativní verzi.
• Úplný přepis je volitelný HTML, sleduje pořadí záznamu a popisuje nezbytné vizuální akce.
• Písemné instrukce, varování, podmínky, důkazy a výzvy k akci zůstávají dostupné mimo video.
• Načítání externího poskytovatele se řídí platnými pravidly pro souhlas a poskytovatel je identifikován před aktivací.
• Přehrávač, štítek a přepis zůstávají jedním sémantickým figure a nejsou přerušeny nesouvisejícím obsahem.
• Prvek není vnořen uvnitř tabulky, seznamu, rámečku, karty, karuselu, panelu accordionu nebo klikatelného kontejneru.
• Záznam a přepis fungují při 200% zoomu, úzkých šířkách, omezeném pohybu a bez významu závislého pouze na JavaScriptu.
• Všechna pole VideoObject odpovídají viditelným, ověřitelným metadatům média a přístupnému záznamu.
• Vybraný typ příspěvku je uveden v postTypes a umístění odpovídá matici výše.
• Vlastník média, práva, datum záznamu a podmínky pro kontrolu nebo nahrazení jsou zaznamenány.

FAQ

Potřebuje každé inline video přepis?

Ano. Titulky slouží synchronizovanému přehrávání; přepis slouží čtení, procházení, vyhledávání, překladu, citování, přístupnosti a extrakci. Musí obsahovat úplný smysluplný obsah včetně vizuálních akcí, které řeč nevysvětluje.

Může náhledový snímek obsahovat název videa?

Ano, ale stejná identifikační informace musí být uvedena také v HTML textu. Text na náhledovém snímku může být nečitelný na malé obrazovce, nedostupný při selhání obrázků a nepřístupný softwaru, který neinterpretuje pixely.

Mělo by se inline video automaticky přehrávat?

Ne. Automatické přehrávání spotřebovává data, přerušuje čtení, vnáší nevyžádaný pohyb nebo zvuk a odebírá čtenáři volbu, kdy se zapojit. Spouštějte až po explicitní aktivaci.

Jsou titulky a přepis to samé?

Ne. Titulky jsou časovány k přehrávání a zahrnují relevantní zvukové signály. Přepis je trvalá čtecí alternativa uspořádaná v posloupnosti záznamu a obohacená o nezbytné popisy smysluplných vizuálních prvků.

Vyžaduje inline video schéma VideoObject?

Ne. Přidávejte VideoObject pouze tehdy, když jej podporují přesná viditelná metadata a stabilní záznam. Přehrávač bez důvěryhodného názvu, popisu, náhledového snímku, data nahrání, délky trvání a URL média by neměl generovat neúplné nebo vymyšlené značení.