Inline-video: Regler og eksempler

En inline-video er en hostet eller eksternt indlejret optagelse placeret inde i artiklens læseflow for at demonstrere, forklare eller dokumentere én afgrænset idé. Den inkluderer en synlig etiket, en bevidst posterramme, afspilningskontroller, undertekster, varighed og et komplet transskription. Uden disse omgivende ord er en umærket afspiller usynlig for enhver læser, der ikke kan eller vælger ikke at se – og næsten tom for systemer, der udtrækker tekst frem for at afkode optagelsen.

Den afventende posterkommentar er en optagelsesspecifikation, ikke en aktivreference. Den omkringliggende HTML demonstrerer den krævede læserækkefølge, før medieproduktionen er færdig.

Hvorfor dette element er vigtigt

Video reducerer forklaringsomkostningerne, når bevægelse, timing, stemme eller forandring over tid har betydning. En læser kan se, hvordan en menu åbnes, hvordan et fysisk produkt bevæger sig, eller hvordan en taler kvalificerer en konklusion. At se kræver opmærksomhed, lyd eller undertekster, tid og ofte mere data end at læse, så en tydelig etiket og varighed lader læseren vurdere denne omkostning.

Posterrammer påvirker denne beslutning før afspilning. Et repræsentativt stillbillede fungerer som et visuelt løfte om, hvad optagelsen indeholder. En tilfældig ramme med lukkede øjne, en indlæsningsspinner eller et urelateret titelkort får indholdet til at se sjusket ud og tvinger læseren til at trykke på afspil for at opdage emnet. Posterrammen bør afsløre den tilstand, person, genstand eller det resultat, videoen faktisk forklarer.

Maskinekstraherbarhed er softwarens evne til at genskabe en indholdsenheds betydning uden at gengive dens præsentation. En bar iframe afslører typisk ikke meget mere end en udbyder-URL. Et mærket element afslører en titel, oversigt, varighed, dato, poster, undertekster, transskription og en stabil identifikator. Søge-, oversættelses-, tilgængeligheds- og genfindingssystemer kan derefter forstå den afgrænsede forklaring.

Transskriptionen er derfor en del af elementet, ikke en valgfri download. Den bevarer talte påstande, talerskift, meningsfulde lyde og visuelle handlinger i dokumentrækkefølge. Undertekster understøtter afspilningsoplevelsen; transskriptionen understøtter siden. Følg de fælles element writing rules for semantisk forrang, direktivsyntaks og brødtekstkortlægning. Denne side har forrang, hvor den kræver et transskription, poster, varighed og videospecifikke tilgængelighedsfelter.

Hvornår skal det bruges

Brug inline-video, når tidsbaserede beviser gør et afgrænset punkt tydeligere end stillbilleder og prosa. Egnede tilfælde inkluderer en grænsefladeoperation, fysisk teknik, synlig overgang, ekspertforklaring, bevægelsesafhængig produktadfærd eller et optaget resultat, hvis levering er bevis.

Anvend en erstatningstest, før du bestiller optagelsen. Hvis et skærmbillede og to sætninger forklarer pointen lige så godt, så brug dem: de indlæses hurtigere, scannes hurtigere og koster mindre at opdatere. Video fortjener sin plads, når rækkefølge, tempo, bevægelse, stemme eller observeret adfærd ændrer forståelsen.

Næsten-ramte tilfælde inkluderer:

• En lang webinar inde i et urelateret afsnit: link til en dedikeret videoside eller brug en fuld videoindlejringsektion. Et inline-element skal tjene den lokale argumentation, ikke importere en time af tilstødende emne.
• En stille, loopende dekoration: det er bevægelsesdesign, ikke redaktionel video. Fjern det, eller behandl det som dekorativt medie med reduceret bevægelsesadfærd.
• En skærmoptagelse brugt i stedet for instruktioner: skriv trinene og successtatus i tekst. Videoen kan demonstrere dem, men den må ikke være den eneste måde at fuldføre opgaven på.
• Et kundetilbud klippet uden kontekst: et kort klip kan understøtte et casestudie kun, når taleren, relationen, optagelsesdatoen, godkendelsen og den omkringliggende påstand er oplyst.
• En video, hvis eneste værdi er personlighed: brug den kun, når stemme, levering eller talerens autoritet er relevant. Få ikke læsere til at se en oplæser gentage tekst, der allerede er på siden.
• Flere peer-klip: brug et galleri eller en dedikeret mediesektion, når udvælgelse blandt optagelser er opgaven. Stable ikke inline-afspillere.

Hvor skal det placeres

Placer videoen umiddelbart efter afsnittet, der nævner, hvad læseren vil lære eller observere. Sæt dens titel, varighed og oversigt før afspilleren. Placer transskriptionen direkte efter den, kun skjult når den komplette tekst forbliver i HTML uden afspilningskode.

I en procedure skal du placere afspilleren efter den skrevne handlingssekvens og før fejlfinding. Læseren bør kunne handle uden at se og derefter bruge optagelsen til at bekræfte bevægelse eller grænsefladetilstand. I en argumentation eller et casestudie skal du angive påstanden før optagelsen og fortolke dens begrænsninger efter den.

Placer den ikke ved siden af en anden afspiller, autoafspillende animation, stor call to action, formular eller lommeregner. Konkurrerende kontroller skaber uklar fokus. Sæt den ikke inde i en tabelcelle, listeelement, callout, fane, karrusel, akkordionpanel eller klikbart kort. Transskriptionen må bruge en åbenbaring kontrol; hele videoen må ikke.

Hold titlen, oversigten, poster, afspiller, varighed, transskriptionskontrol og kredit inden for én figur-grænse. En kilde note må følge umiddelbart efter. Adskil aldrig afspilleren fra dens transskription med en annonce, kampagne eller urelateret sektion.

Anatomi

1. Synlig titel: Navngiver opgaven, demonstrationen, begivenheden eller påstanden i specifik HTML-tekst.
2. Oversigt: Forklarer i én sætning, hvad læseren vil se, og hvorfor det er vigtigt.
3. Varighed: Angiver visningsomkostningen før afspilning i minutter og sekunder.
4. Posterramme: Viser en repræsentativ, godkendt ramme uden at foregive at være en knap i sig selv.
5. Afspiller kontroller: Giver afspil, pause, søg, lydstyrke, fuld skærm, afspilningshastighed og undertekstadgang.
6. Undertekster: Synkroniserer dialog, talerskift og meningsfuld ikke-tale lyd med afspilning.
7. Transskription: Gengiver den komplette meningsfulde sekvens som valgbar, søgbar HTML-tekst.
8. Visuelle beskrivelser: Registrerer meningsfulde handlinger på skærmen eller ændringer, som fortælling ikke angiver.
9. Kredit og kilde: Identificer taleren, skaberen, optagelsesdatoen eller bevisets oprindelse, når det er relevant.

Titlen er ikke filnavnet, og oversigten er ikke “Se videoen nedenfor.” Hver især skal forblive nyttig, når den kopieres uden afspilleren.

Designeksempler

Alle varianter deler samme indholdskontrakt. Levering ændrer sig; mærkning, undertekster, transskriptionskvalitet, afspilningssamtykke og læserækkefølge gør ikke.

Hostet demonstration

Brug en first-party HTML5-afspiller til en kort produkt- eller procesoptagelse, når organisationen styrer kodning, undertekster, postervalg og tilgængelighed.

Privatlivsbevidst ekstern indlejring

Brug en ekstern platform, når dens levering, analyse eller etablerede kanal er påkrævet. Indlæs udbyderen kun efter samtykke, hvor politik kræver det, identificer udbyderen før aktivering, og bevar det lokale transskription, selv hvis udbyderen fjerner optagelsen.

Kort grænsefladeklip

Brug et kort klip til én tilstandsændring, der er svær at kommunikere med stillbilleder. Det kræver stadig kontroller, en pausemekanisme, en meningsfuld tekstbeskrivelse og et transskription; gør det ikke til en automatisk loopende GIF.

Interview eller bevisklip

Brug et talerledet klip, når forfatterskab, ordlyd eller observeret vidneudsagn betyder noget. Vis personens navn og rolle i HTML, oplys redigeringer, og transskriber både tale og materielle visuelle beviser.

Parametre

Disse felter udgør den bærbare indholdskontrakt. Bredde, kant, skygge, afspilknap-stil og breakpoint-adfærd tilhører gengiveren.

Den første overskrift i brødteksten kortlægges til title; det første afsnit kortlægges til summary; den resterende brødtekst kortlægges til transcript. Transskriptionstidsintervaller er valgfrie for en kontinuerlig enkelt-taler forklaring og anbefales til procedurer, talerskift og optagelser længere end to minutter. autoplay, loop og baggrundslydfelter er bevidst fraværende.

Syntaks og kodeeksempler

Hver notation bevarer den samme titel, oversigt, mediametadata, undertekster og transskription. Eksempel-domænerne beskriver kontrakten og er ikke produktionsaktivreferencer.

Bærbar Markdown-direktiv

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

Dette er den tilsigtede adapterkontrakt, ikke en påstand om, at en lokal shortcode eksisterer. Den bruger kun navngivne parametre. Indtil en gengiver er registreret, brug semantisk figur-, video-, spor- og transskriptions-HTML, der bevarer de samme felter.

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

Hvis den registrerede WordPress-blok ikke er tilgængelig, brug native Video-, Overskrift-, Afsnit- og Detaljer-blokke. Indsæt ikke en iframe og udelad det lokale transskription.

Eksempler

Godt: en afgrænset demonstration med et læsealternativ

Filtrer sider, der skal gennemgås · 1:30

Videoen viser én opgave: åbning af en friskhedsrapport, anvendelse af et statusfilter og kontrol af resultatantallet. Dens poster viser det åbne filter, underteksterne identificerer grænsefladeetiketter nøjagtigt, og det tredelte transskription registrerer hver handling og succesbekræftelse. Afspilning begynder først efter aktivering.

Dette virker, fordi en læser kan forudsige værdien og tidsomkostningen, se med lyd, se med undertekster eller udføre den samme opgave fra transskriptionen. Optagelsen tilføjer bevægelse og tilstandsændringsbevis uden at blive den eneste instruktion.

Dårligt: en umærket afspiller

Se dette En tredjeparts iframe indlæses automatisk under overskriften. Dens poster er en sort ramme, ingen varighed vises, undertekster er udbydergenererede og ugennemgåede, og siden indeholder intet transskription eller oversigt.

Den dårlige version får enhver læser, der ikke ser, til at gætte. Den giver ekstraktorer intet emne, beder privatlivsbevidste læsere om at kontakte en udbyder før afspilningsvalg, tilbyder ingen holdbar tekst, når optagelsen forsvinder, og kan annoncere forkerte undertekster som fakta. Reparer den med en specifik titel og oversigt, bevidst poster, varighed, samtykkebevidst indlæsning, gennemgåede undertekster, komplet lokalt transskription og en skrevet opgave eller påstand uden for afspilleren.

Skemamarkering og tilgængelighed

Inline-video skaber ikke automatisk en skemaberettigelse. Brug VideoObject kun, når siden synligt leverer nøjagtige name, description, thumbnailUrl, uploadDate, duration og contentUrl eller embedUrl-værdier for den tilgængelige optagelse. Opfind aldrig felter for at tilfredsstille en validator eller markere et dekorativt klip som primær video.

En relevant video kan understøtte en berettiget Article, HowTo eller Product, når siden uafhængigt kvalificerer sig. Dens transskription kan ikke retfærdiggøre påstande eller trin, der mangler på den synlige side.

Tilgængelighed begynder før afspilning. Mærk figuren, vis titel og varighed i tekst, og giv kontroller tastaturbetjening og synligt fokus. Brug aldrig autoafspilning. Giv pause, søg, lydstyrke, hastighed, undertekster og fuld skærm. Fang ikke fokus i en tredjepartsafspiller; efter fuld skærm lukkes, returner det til den initierende kontrol.

Undertekster skal være synkroniserede, tegnsatte og gennemgået mod optagelsen. Identificer talere, når stemmen ikke er indlysende, og inkluder meningsfulde lyde såsom “[notifikationstone]”, når de påvirker forståelsen. Lydbeskrivelse er påkrævet, når meningsfuld visuel information ikke er angivet i hovedlyden; et beskrivende transskription alene gør ikke den tidsindstillede afspilningsoplevelse tilsvarende.

Transskriptionen skal være ægte HTML i logisk rækkefølge – ikke canvas, kun-afspilningsindhold, skjult tekst eller en kun-PDF-download. Åbenbaringskontroller kræver et tilgængeligt navn og udvidet tilstand. Afspiller og transskription skal fungere ved 200 % zoom og smalle bredder uden vandret rulning på sideniveau.

Skriveregler

Ordene omkring afspilleren afgør, om videoen er et indholdselement eller et uforklaret objekt:

• Skriv en specifik titel på 4–12 ord. Navngiv opgaven, demonstrationen, taleren, begivenheden eller fundet; brug aldrig “Video”, “Se dette” eller “Lær mere” alene.
• Skriv én oversigtssætning på 15–35 ord, der fortæller læseren, hvad der sker, og hvorfor det er vigtigt. Gentag ikke titlen.
• Hold inline-optagelser fokuserede og normalt under fem minutter. Den hårde maksimumgrænse er 20 minutter; længere optagelser hører til på en dedikeret side eller har brug for redaktionel opdeling.
• Vis varighed før afspilning. Brug M:SS til synlig tekst og ISO 8601, såsom PT1M30S, i strukturerede felter.
• Vælg en poster, der repræsenterer emnet ved normal visningsstørrelse. Undgå blanke rammer, spinnere, utilsigtede udtryk, vildledende afspilknapper, lille grænsefladetekst og ugodkendte personlige eller kundeoplysninger.
• Gennemgå undertekster mod den endelige redigering. Ret navne, produktetiketter, tal, domæneterminologi, tegnsætning, talerskift og meningsfulde lyde.
• Transskriber al meningsfuld tale og visuelle elementer. Resuméer, kapiteltitler og auto-genererede undertekstfiler erstatter ikke transskriptionen.
• Brug korte transskriptionsafsnit, taleretiketter hvor nødvendigt, og tidsintervaller omkring proceduremæssige faser eller emneændringer. Fremstil ikke citater fra parafraseret tale.
• Angiv redigeringer, der kunne ændre fortolkning. Splejs ikke et testimonial, eksperiment eller demonstration, så rækkefølgen antyder et uunderstøttet resultat.
• Hold væsentlige instruktioner, priser, advarsler, berettigelsesbetingelser, beviser og call-to-action uden for optagelsen. En læser må ikke skulle skrubbe gennem en tidslinje for at finde en væsentlig kendsgerning.
• Placer aldrig autoafspilning, blinkende indhold, baggrundslyd, konverteringsoverlejringer, låste transskriptionsfelter eller en anden afspiller inde i elementet.
• Registrer medieejeren og gennemgangsudløseren. Gense videoen, når grænsefladen, politikken, produktadfærden, talertilskrivningen eller den omkringliggende påstand ændres.

Indlægstyper, der bruger det

postTypes frontmatter-arrayet driver denne matrix. Inklusion tillader inline-video, når tidsbaserede beviser tilføjer mening; det kræver ikke en afspiller på hver side.

QA-tjekliste

• Videoen tilføjer tidsbaseret betydning, som et stillbillede og kortfattet prosa ikke kan formidle lige så godt.
• Den synlige titel navngiver optagelsen specifikt, og oversigten forklarer dens værdi før afspilning.
• Varighed vises, før læseren aktiverer afspilleren.
• Posterrammen er repræsentativ, læselig, godkendt og fri for privat eller vildledende indhold.
• Afspilning starter aldrig automatisk, looper uventet eller producerer lyd uden en læserhandling.
• Afspil, pause, søg, lydstyrke, hastighed, undertekster og fuld skærm fungerer med tastatur og touch.
• Undertekster matcher den endelige redigering og bevarer korrekt navne, tal, talerskift og meningsfulde lyde.
• Meningsfulde visuelle elementer, der ikke formidles i tale, modtager lydbeskrivelse eller en tilsvarende alternativ version.
• Det komplette transskription er valgbar HTML, følger optagelsens rækkefølge og beskriver nødvendige visuelle handlinger.
• Skrevne instruktioner, advarsler, betingelser, beviser og call-to-action forbliver tilgængelige uden for videoen.
• Indlæsning af ekstern udbyder følger gældende samtykkeregler, og udbyderen identificeres før aktivering.
• Afspilleren, etiketten og transskriptionet forbliver én semantisk figur og afbrydes ikke af urelateret indhold.
• Elementet er ikke indlejret inde i en tabel, liste, callout, fane, karrusel, akkordionpanel eller klikbar container.
• Optagelsen og transskriptionet fungerer ved 200 % zoom, smalle bredder, reduceret bevægelse og uden kun-JavaScript-betydning.
• Eventuelle VideoObject-felter matcher synlige, verificerbare mediametadata og den tilgængelige optagelse.
• Den valgte indlægstype vises i postTypes, og placeringen matcher matricen ovenfor.
• Medieejeren, rettigheder, optagelsesdato og betingelser for gennemgang eller udskiftning er registreret.

FAQ

Skal hver inline-video have et transskription?

Ja. Undertekster tjener synkroniseret afspilning; transskriptionet tjener læsning, scanning, søgning, oversættelse, citering, tilgængelighed og ekstraktion. Det skal indeholde det komplette meningsfulde indhold, inklusive visuelle handlinger, som tale ikke forklarer.

Må posterrammen indeholde videotitlen?

Ja, men den samme identificerende information skal også fremgå i HTML-tekst. Postertekt kan være ulæselig på en lille skærm, utilgængelig når billeder fejler, og utilgængelig for software, der ikke fortolker pixels.

Bør en inline-video afspille automatisk?

Nej. Autoafspilning bruger data, afbryder læsning, introducerer uønsket bevægelse eller lyd og fjerner læserens valg om, hvornår de vil engagere sig. Start kun efter en eksplicit aktivering.

Er undertekster og et transskription det samme?

Nej. Undertekster er tidsindstillede til afspilning og inkluderer relevante lydsignaler. Et transskription er et holdbart læsealternativ organiseret i optagelsens rækkefølge og beriget med nødvendige beskrivelser af meningsfulde visuelle elementer.

Kræver en inline-video VideoObject-skema?

Nej. Tilføj VideoObject kun, når nøjagtige synlige metadata og en stabil optagelse understøtter det. En afspiller uden et pålideligt navn, beskrivelse, poster, uploaddato, varighed og medie-URL bør ikke generere ufuldstændig eller opfundet markup.