12 YouTube embed-parametrar förklarade (med exempel)

YouTube embed-parametrar är de frågesträngsalternativ som styr exakt hur en inbäddad video ser ut och beter sig. Den här guiden går igenom tolv av de mest användbara individuellt, med ett praktiskt exempel för varje, så att du exakt kan se vad var och en ändrar.

Hur parametrar kopplas till en inbäddnings-URL

Varje parameter läggs till i inbäddnings-URL:en som ett nyckel-värde-par, sammanfogat med ett &-tecken: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=värde1&param2=värde2. Du kan kombinera så många du vill. Booleska parametrar använder generellt 1 för “på” och 0 för “av”, och att utelämna en parameter helt faller tillbaka på YouTubes eget standardbeteende för den.

1. autoplay

Startar videon i samma stund spelaren laddas, utan att en besökare trycker på play.

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

De flesta webbläsare blockerar autoplay av video med ljud om inte besökaren redan interagerat med din sida, så autoplay parkopplas nästan alltid med mute.

2. mute

Startar spelaren ljudlös, vilket är det som gör att autoplay pålitligt fungerar i alla webbläsare.

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

3. start

Börjar uppspelningen vid ett specifikt antal sekunder in i videon, i stället för från början.

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

Nittio sekunder i det här exemplet innebär att spelaren öppnas direkt vid 1:30-markeringen.

4. end

Stoppar uppspelningen vid ett specifikt antal sekunder, användbart för att bara visa ett relevant klipp av en längre video.

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

Kombinerat med start spelas endast fönstret från 30 till 90 sekunder och stoppar sedan.

5. loop

Spelar upp videon igen automatiskt när den är klar. För en enskild video (inte en spellista) behöver du också lägga till en playlist-parameter satt till samma video-ID, annars fungerar inte loopen tyst.

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

6. controls

Visar eller döljer spelarens kontrollfält (play/paus, volym, förlopp, helskärm).

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

Att sätta detta till 0 är vanligt för videor som fungerar som bakgrund där du inte vill ha synliga uppspelningskontroller.

7. rel

Styr vilka relaterade videor som föreslås när uppspelningen är klar. Att sätta detta till 0 begränsar förslagen till videor från samma kanal i stället för YouTubes bredare rekommendationspool.

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

8. list (och videoseries-sökvägen)

Laddar en hel spellista i stället för en enskild video. Detta kombineras med sökvägen /embed/videoseries i stället för ett enskilt video-ID.

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

9. index

Används tillsammans med en spellista för att välja vilket objekt uppspelningen ska starta på, räknat från 0 för första videon.

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

Det här exemplet startar på den tredje videon i spellistan.

10. hl

Sätter språket för spelarens egna gränssnittselement (inte videons ljud eller textning), med en standardspråkkod.

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

11. cc_load_policy

Tvingar textning att visas som standard när satt till 1, användbart för tillgänglighetsfokuserade inbäddningar eller ljudlöst autoplay-video där textningen bär betydelsen.

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

12. color

Sätter färgen på spelarens förloppsindikator, accepterar antingen red eller white som värden.

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

Kombinera flera parametrar

Parametrar staplas fritt. Ett integritetsvänligt, responsivt, automatiskt uppspelat bakgrundsklipp som loopar ljudlöst och döljer kontroller kan se ut så här:

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

Referenstabell

Parameter	Värden	Vad den gör
autoplay	0 / 1	Startar uppspelningen automatiskt
mute	0 / 1	Startar ljudlös, krävs för pålitlig autoplay
start	sekunder	Startpunkt för uppspelning
end	sekunder	Stopppunkt för uppspelning
loop	0 / 1	Spelar videon igen (behöver playlist-parameter för en enskild video)
controls	0 / 1	Visar eller döljer kontrollfältet
rel	0 / 1	Begränsar slutförslag till samma kanal
list	spellist-ID	Laddar en hel spellista via /embed/videoseries
index	nummer	Vilket spellisteobjekt uppspelningen ska starta på
hl	språkkod	Spelarens gränssnittsspråk
cc_load_policy	0 / 1	Tvingar textning på som standard
color	red / white	Färg på förloppsindikatorn

Relaterad läsning

För layoutdelen av inbäddning, se vår guide om responsiva YouTube-inbäddningar. För integritet, se att bädda in YouTube-videor utan kakor. För felsökning, se YouTube-video bäddas inte in: 8 åtgärder.

Parametrar som ofta förväxlas med varandra

Några av dessa tolv parametrar blandas ihop tillräckligt ofta för att förtjäna en direkt jämförelse. autoplay och loop låter liknande men gör olika saker: autoplay styr om uppspelningen startar vid laddning, loop styr om den startar om efter att ha slutat, och de används ofta tillsammans men är oberoende inställningar. start och index är också lätta att förväxla: start är en tidsförskjutning i sekunder inom en enskild video, medan index är en position inom en spellista, räknat i objekt snarare än tid. Att koppla dessa rätt spelar roll, eftersom att blanda ihop dem (till exempel att försöka använda index på en enskild videoinbäddning) helt enkelt inte har någon effekt i stället för att ge ett fel.

Parametrar med begränsat eller inkonsekvent stöd

Inte varje parameter beter sig identiskt i alla sammanhang. modestbranding, som minskar YouTubes logotyp, har haft inkonsekventa effekter mellan olika spelarversioner och betraktas i allmänhet som en bästa-möjliga-inställning snarare än en garanterad. På liknande sätt kan vissa visningsrelaterade parametrar bete sig något olika beroende på om en besökare är inloggad på ett Google-konto i sin webbläsare, eftersom kontonivåinställningar kan samverka med spelarens standardvärden. Parametrarna för uppspelningskontroll ovan, start, end, autoplay, mute, loop och controls, är de mest konsekvent tillförlitliga över webbläsare och kontostatus, vilket är varför de är de värda att bygga din inbäddningsstrategi kring.

Ett praktiskt exempel: bygga en kursinbäddning steg för steg

Föreställ dig att du bäddar in en lektionsvideo på en kurssida och vill att den ska vara integritetsvänlig, responsiv, starta vid tvåminutersmarkeringen där själva lektionsinnehållet börjar (och hoppa över en kanalintro), med textning på som standard för tillgänglighet, och ingen autoplay eftersom en besökare själv bör välja att starta den. Genom parametrarna: integritetsvänlig betyder domänen youtube-nocookie.com; responsiv betyder en procentbaserad wrapper i stället för fasta mått; start vid två minuter betyder start=120; textning som standard betyder cc_load_policy=1; och ingen autoplay betyder helt enkelt att utelämna autoplay-parametern, eftersom det är standardläget. Den resulterande inbäddnings-URL:en skulle vara:

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

Detta enda exempel visar hur parametrarna i den här guiden kombineras naturligt för att lösa ett specifikt, realistiskt krav i stället för att existera som en abstrakt lista.

Testa dina parameterkombinationer

Innan du publicerar en inbäddning med flera kombinerade parametrar är det värt att testa den direkt i stället för att anta att kombinationen fungerar som förväntat. Klistra in hela inbäddnings-URL:en, parametrar och allt, direkt i en webbläsarflik; spelaren ska bete sig exakt som den skulle inuti din sidas iframe, vilket låter dig fånga felstavningar i parameternamn (ett vanligt misstag, eftersom en felstavad parameter vanligtvis bara ignoreras tyst i stället för att flaggas som ett fel) innan de når din live-sida.

Parametrar och integritet: vilka samverkar med nocookie-domänen

Det är värt att förtydliga att varje parameter i den här guiden fungerar identiskt oavsett om du använder standarddomänen youtube.com eller den integritetsvänliga domänen youtube-nocookie.com. Domänvalet och uppspelningsparametrarna är helt oberoende beslut: att byta till den integritetsvänliga domänen inaktiverar eller ändrar inte någon av autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy eller color. Detta är en vanlig punkt för förvirring värd att adressera direkt, eftersom vissa webbplatsägare antar att integritetsläget är en nedbantad version av spelaren med färre alternativ, när det i praktiken är funktionellt identiskt, bara med annat kakbeteende på Googles sida.

Bygga din egen parameterreferens för ett specifikt projekt

För en större sida med många inbäddade videor är det värt att internt dokumentera vilken kombination av dessa tolv parametrar ditt team använder som standard, i stället för att uppfinna valet på nytt för varje ny inbäddning. En enkel intern standard, till exempel: använd alltid den integritetsvänliga domänen, inkludera alltid rel=0, standard till ingen autoplay om inte en specifik sidtyp kräver det, och använd alltid en responsiv wrapper, håller inbäddningar konsekventa över en sida och gör det mycket snabbare att upptäcka en felkonfigurerad under granskning. Att behandla den här listan med tolv parametrar som en meny att välja standardvärden från, i stället för ett engångsbeslut taget på nytt varje gång, lönar sig när en sidas videoinnehåll växer.

Ett sista ord om att ha den här referensen till hands

Att bokmärka den här sidan, eller referenstabellen ovan specifikt, är sannolikt mer användbart än att försöka lära sig alla tolv parametrar utantill. I praktiken använder de flesta inbäddningar på en typisk sida bara tre eller fyra av dessa samtidigt (vanligtvis en integritetsvänlig domän implicit, rel=0, och ibland start eller autoplay/mute tillsammans), så att ha den fullständiga listan att kontrollera mot för de mindre vanliga fallen, som spellistor eller textning, täcker de återstående situationerna utan att behöva ha allt memorerat i förväg.

Hur YouTubes egen dokumentation jämför sig med den här guiden

YouTube publicerar sin egen utvecklardokumentation som täcker IFrame Player API och inbäddningsparametrar, riktad primärt till utvecklare som bygger anpassade, JavaScript-styrda spelare snarare än webbplatsägare som lägger till en enkel inbäddning på en sida. Den här guiden fokuserar specifikt på den delmängd av parametrar som är relevanta för en vanlig iframe-inbäddning utan anpassad JavaScript, vilket täcker den stora majoriteten av verkliga användningsfall på vanliga webbplatser. För alla som bygger mer avancerade, programmatiskt styrda videoupplevelser (anpassade play-knappar, spårning av tittarförlopp, synkroniserade multivideospelare) är YouTubes egen dokumentation för IFrame Player API nästa steg bortom vad en frågesträngsparameter-metod som denna kan erbjuda.

En avslutande sammanfattning av de tolv parametrarna

Genom autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy och color är den praktiska slutsatsen att en liten handfull (val av integritetsdomän, rel och en responsiv wrapper) utgör ett förnuftigt standardval för nästan varje inbäddning, medan resten (start/end, loop, Shorts-formatering, spellistor, textning, språk och färg) är situationsberoende verktyg värda att ta till bara när en specifik sida genuint kräver dem, i stället för att läggas till urskillningslöst på varje inbäddning på en sida.

Att ha den här referensen inom räckhåll gör att du aldrig behöver gissa parameternamn ur minnet när ett nytt inbäddningsbehov dyker upp.

Vanliga frågor