12 YouTube embed parametre forklaret (med eksempler)

YouTube embed parametre er de query streng muligheder, der styrer præcis hvordan en indlejret video ser ud og opfører sig. Denne guide gennemgår tolv af de mest nyttige, individuelt, med et fungerende eksempel for hver, så du præcis kan se, hvad hver enkelt ændrer.

Sådan tilføjes parametre til en embed URL

Hver parameter tilføjes til embed URL’en som et nøgle-værdi par, forbundet med et og-tegn: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value1&param2=value2. Du kan kombinere lige så mange, du vil. Boolske parametre bruger generelt 1 for “til” og 0 for “fra,” og hvis en parameter helt udelades, falder den tilbage til YouTubes egen standardopførsel for den.

1. autoplay

Starter videoen i det øjeblik, afspilleren indlæses, uden at den besøgende trykker afspil.

https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1

De fleste browsere blokerer autoplay af video med lyd, medmindre den besøgende allerede har interageret med din side, så autoplay parres næsten altid med mute.

2. mute

Starter afspilleren lydløst, hvilket er det, der gør autoplay pålideligt på tværs af browsere.

https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1

3. start

Starter afspilningen ved et bestemt antal sekunder inde i videoen, i stedet for fra begyndelsen.

https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90

Halvfems sekunder i dette eksempel betyder, at afspilleren åbner lige på 1:30-markøren.

4. end

Stopper afspilningen ved et bestemt antal sekunder, nyttigt til kun at vise et relevant klip af en længere video.

https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90

Kombineret med start afspilles kun vinduet fra 30 til 90 sekunder, hvorefter det stopper.

5. loop

Afspiller videoen automatisk igen, når den er slut. For en enkelt video (ikke en afspilningsliste) skal du også tilføje en playlist parameter sat til samme video ID, ellers virker loop stille og roligt ikke.

https://www.youtube-nocookie.com/embed/VIDEO_ID?loop=1&playlist=VIDEO_ID

6. controls

Viser eller skjuler afspillerens kontrolbjælke (afspil/pause, lydstyrke, fremdrift, fuldskærm).

https://www.youtube-nocookie.com/embed/VIDEO_ID?controls=0

At sætte denne til 0 er almindeligt til baggrundsagtig video, hvor du ikke ønsker synlige afspilningskontroller.

7. rel

Styrer hvilke relaterede videoer der foreslås, når afspilningen slutter. At sætte denne til 0 begrænser forslag til videoer fra samme kanal, i stedet for YouTubes bredere anbefalingspulje.

https://www.youtube-nocookie.com/embed/VIDEO_ID?rel=0

8. list (og videoseries stien)

Indlæser en hel afspilningsliste i stedet for en enkelt video. Dette kombineres med stien /embed/videoseries i stedet for et enkelt video ID.

https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID

9. index

Bruges sammen med en afspilningsliste til at vælge, hvilket element der skal startes på, talt fra 0 for den første video.

https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2

Dette eksempel starter på tredje video i afspilningslisten.

10. hl

Angiver sproget i afspillerens egne grænsefladeelementer (ikke videoens lyd eller undertekster), ved brug af en standard sprogkode.

https://www.youtube-nocookie.com/embed/VIDEO_ID?hl=de

11. cc_load_policy

Tvinger undertekster til at vises som standard, når den er sat til 1, nyttigt til tilgængelighedsfokuserede indlejringer eller lydløse autoplay-videoer, hvor undertekster bærer betydningen.

https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=1

12. color

Angiver farven på afspillerens fremdriftslinje, med værdierne red eller white.

https://www.youtube-nocookie.com/embed/VIDEO_ID?color=white

At kombinere flere parametre

Parametre stables frit. Et privatlivsvenligt, responsivt, autoplayende baggrundsklip, der løber lydløst i loop og skjuler kontroller, kunne se sådan ud:

https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_ID&rel=0

Referencetabel

Parameter	Værdier	Hvad den gør
autoplay	0 / 1	Starter afspilningen automatisk
mute	0 / 1	Starter lydløst, krævet for pålidelig autoplay
start	sekunder	Afspilningens startpunkt
end	sekunder	Afspilningens stoppunkt
loop	0 / 1	Afspiller videoen igen (kræver playlist parameter for en enkelt video)
controls	0 / 1	Viser eller skjuler kontrolbjælken
rel	0 / 1	Begrænser forslag efter videoen til samme kanal
list	afspilningsliste ID	Indlæser en hel afspilningsliste via /embed/videoseries
index	nummer	Hvilket element i afspilningslisten der startes på
hl	sprogkode	Afspillerens grænsefladesprog
cc_load_policy	0 / 1	Tvinger undertekster til som standard
color	red / white	Fremdriftslinjens farve

Relateret læsning

For layoutsiden af indlejring, se vores guide om responsive YouTube indlejringer. For privatliv, se indlejring af YouTube videoer uden cookies. For fejlfinding, se YouTube video vil ikke indlejre: 8 løsninger.

Parametre der ofte forveksles med hinanden

Et par af disse tolv parametre bliver blandet sammen ofte nok til, at en direkte sammenligning er værd. autoplay og loop lyder ens, men gør forskellige ting: autoplay styrer, om afspilningen starter ved indlæsning, loop styrer, om den genstarter efter at være slut, og de bruges ofte sammen, men er uafhængige indstillinger. start og index er også lette at forveksle: start er en tidsforskydning i sekunder inden for en enkelt video, mens index er en position i en afspilningsliste, talt i elementer i stedet for tid. At få dem parret korrekt betyder noget, da en fejlpasning (for eksempel at prøve at bruge index på en enkeltvideo-indlejring) simpelthen ikke har nogen effekt, i stedet for at give en fejl.

Parametre med begrænset eller inkonsekvent understøttelse

Ikke alle parametre opfører sig identisk i hver kontekst. modestbranding, som reducerer YouTubes logo, har haft inkonsekvente effekter på tværs af forskellige afspillerversioner og betragtes generelt som en bedste-forsøg indstilling snarere end en garanteret en. Tilsvarende kan nogle visningsrelaterede parametre opføre sig lidt anderledes afhængigt af, om en besøgende er logget ind på en Google konto i sin browser, da kontoniveau-præferencer kan interagere med afspillerens standarder. Afspilningsstyrende parametre dækket ovenfor, start, end, autoplay, mute, loop og controls, er de mest konsekvent pålidelige på tværs af browsere og kontostatusser, hvilket er grunden til, at de er dem, det er værd at bygge din indlejringsstrategi omkring.

Et praktisk eksempel: byg en kursusside-indlejring trin for trin

Forestil dig, at du indlejrer en lektionsvideo på en kursusside og ønsker den privatlivsvenlig, responsiv, startende ved to-minutters markøren, hvor selve lektionsindholdet begynder (springer en kanalintro over), med undertekster til som standard af hensyn til tilgængelighed, og ingen autoplay, da en besøgende selv bør vælge at starte den. Ved at arbejde gennem parametrene: privatlivsvenlig betyder domænet youtube-nocookie.com; responsiv betyder en procentbaseret indpakning i stedet for faste dimensioner; start ved to minutter betyder start=120; undertekster som standard betyder cc_load_policy=1; og ingen autoplay betyder blot at udelade autoplay parameteren, da det er standardtilstanden. Den resulterende embed URL ville være:

https://www.youtube-nocookie.com/embed/VIDEO_ID?start=120&cc_load_policy=1&rel=0

Dette ene eksempel viser, hvordan parametrene dækket i denne guide naturligt kombineres for at løse et specifikt, realistisk behov, i stedet for at eksistere som en abstrakt liste.

Test dine parameterkombinationer

Før du udgiver en indlejring med flere kombinerede parametre, er det værd at teste den direkte, i stedet for at antage kombinationen virker som forventet. Indsæt den fulde embed URL, parametre og det hele, direkte i en browserfane; afspilleren bør opføre sig præcis, som den ville inde i din sides iframe, hvilket lader dig fange tastefejl i parameternavne (en almindelig fejl, da en fejlstavet parameter som regel bare bliver stille ignoreret, i stedet for markeret som en fejl), før de når din live side.

Parametre og privatliv: hvilke interagerer med nocookie domænet

Det er værd at præcisere, at hver parameter dækket i denne guide fungerer identisk, uanset om du bruger det almindelige youtube.com embed domæne eller det privatlivsvenlige youtube-nocookie.com domæne. Domænevalget og afspilningsparametrene er helt uafhængige beslutninger: at skifte til det privatlivsvenlige domæne deaktiverer eller ændrer ikke autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy eller color. Dette er et almindeligt forvirringspunkt, det er værd at adressere direkte, da nogle sideejere antager, at privatlivstilstand er en udvandet version af afspilleren med færre muligheder, når det i praksis er funktionelt identisk, blot med anderledes cookieopførsel på Googles side.

Byg din egen parameteroversigt til et specifikt projekt

For en større side med mange indlejrede videoer er det værd internt at dokumentere, hvilken kombination af disse tolv parametre dit team som standard bruger, i stedet for at genopfinde valget for hver ny indlejring. En simpel intern standard, for eksempel: brug altid det privatlivsvenlige domæne, inkludér altid rel=0, brug som standard ingen autoplay medmindre en specifik sidetype kalder på det, og brug altid en responsiv indpakning, holder indlejringer konsekvente på tværs af en side og gør det meget hurtigere at få øje på en fejlkonfigureret en under gennemgang. At behandle denne liste over tolv parametre som en menu at vælge standarder fra, i stedet for en engangsbeslutning taget hver gang, betaler sig, efterhånden som en sides videoindhold vokser.

Et sidste ord om at have denne oversigt ved hånden

At bogmærke denne side, eller specifikt referencetabellen ovenfor, er sandsynligvis mere nyttigt end at forsøge at lære alle tolv parametre udenad. I praksis bruger de fleste indlejringer på en typisk side kun tre eller fire af disse ad gangen (ofte implicit et privatlivsvenligt domæne, rel=0, og lejlighedsvis start eller autoplay/mute sammen), så at have hele listen at tjekke mod til de mindre almindelige tilfælde, som afspilningslister eller undertekster, dækker de resterende situationer uden at skulle huske alt på forhånd.

Hvordan YouTubes egen dokumentation sammenlignes med denne guide

YouTube udgiver sin egen udviklerdokumentation, der dækker IFrame Player API’et og embed parametre, primært rettet mod udviklere, der bygger tilpassede, JavaScript-styrede afspillere, snarere end sideejere, der tilføjer en ligetil indlejring til en side. Denne guide fokuserer specifikt på den delmængde af parametre, der er relevante for en standard iframe-indlejring uden tilpasset JavaScript, hvilket dækker langt de fleste virkelige brugssituationer på almindelige hjemmesider. For alle, der bygger mere avancerede, programmatisk styrede videooplevelser (tilpassede afspilningsknapper, sporingsfremskridt, synkroniserede multi-video-afspillere), er YouTubes egen IFrame Player API dokumentation det næste skridt ud over det, en query-streng-parameter tilgang som denne kan tilbyde.

En afsluttende opsummering af de tolv parametre

På tværs af autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy og color er det praktiske budskab, at en lille håndfuld (privatlivsdomænevalg, rel, og en responsiv indpakning) udgør et fornuftigt standardvalg for næsten enhver indlejring, mens resten (start/end, loop, Shorts format, afspilningslister, undertekster, sprog og farve) er situationsbestemte værktøjer, det kun er værd at gribe til, når en specifik side reelt kalder på dem, i stedet for at blive tilføjet vilkårligt til hver indlejring på en side.

At have denne oversigt inden for rækkevidde betyder, at du aldrig behøver gætte på parameternavne fra hukommelsen, når et nyt indlejringsbehov opstår.

Ofte stillede spørgsmål