12 parametrow osadzania YouTube wyjasnionych (z przykladami)

Parametry osadzania YouTube to opcje w ciagu zapytania, ktore kontroluja dokladnie, jak wyglada i zachowuje sie osadzony film. Ten poradnik omawia dwanascie najbardziej przydatnych z nich pojedynczo, z dzialajacym przykladem dla kazdego, abys mogl dokladnie zobaczyc, co kazdy z nich zmienia.

Jak parametry dolacza sie do adresu URL osadzenia

Kazdy parametr dodaje sie do adresu URL osadzenia jako para klucz-wartosc, laczona ampersandem: https://www.youtube-nocookie.com/embed/ID_FILMU?param1=wartosc1&param2=wartosc2. Mozesz laczyc ich dowolna liczbe. Parametry logiczne zwykle uzywaja 1 jako “wlaczone” i 0 jako “wylaczone”, a calkowite pominiecie parametru wraca do domyslnego zachowania YouTube.

1. autoplay

Uruchamia film w momencie zaladowania odtwarzacza, bez nacisniecia play przez odwiedzajacego.

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

Wiekszosc przegladarek blokuje autoodtwarzanie z dzwiekiem, chyba ze odwiedzajacy juz wszedl w interakcje z Twoja strona, wiec autoplay niemal zawsze jest laczony z mute.

2. mute

Uruchamia odtwarzacz wyciszony, co sprawia, ze autoplay niezawodnie dziala we wszystkich przegladarkach.

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

3. start

Rozpoczyna odtwarzanie od konkretnej liczby sekund filmu, zamiast od poczatku.

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

Dziewiecdziesiat sekund w tym przykladzie oznacza, ze odtwarzacz otwiera sie dokladnie w momencie 1:30.

4. end

Zatrzymuje odtwarzanie w konkretnej sekundzie, przydatne do pokazania tylko istotnego fragmentu dluzszego filmu.

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

W polaczeniu ze start, odtwarza tylko okno od 30 do 90 sekundy, a nastepnie sie zatrzymuje.

5. loop

Automatycznie odtwarza film ponownie po zakonczeniu. Dla pojedynczego filmu (nie playlisty) musisz rowniez dodac parametr playlist ustawiony na to samo ID filmu, inaczej petla po cichu nie zadziala.

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

6. controls

Pokazuje lub ukrywa pasek sterowania odtwarzacza (play/pauza, glosnosc, postep, pelny ekran).

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

Ustawienie na 0 jest powszechne przy wideo w stylu tla, gdzie nie chcesz widocznych elementow sterujacych odtwarzaniem.

7. rel

Kontroluje, jakie powiazane filmy sa sugerowane po zakonczeniu odtwarzania. Ustawienie na 0 ogranicza sugestie do filmow z tego samego kanalu, zamiast szerszej puli rekomendacji YouTube.

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

8. list (i sciezka videoseries)

Laduje cala playliste zamiast pojedynczego filmu. Laczy sie ze sciezka /embed/videoseries zamiast pojedynczego ID filmu.

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

9. index

Uzywany razem z playlista, aby wybrac, od ktorej pozycji zaczac, liczac od 0 dla pierwszego filmu.

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

Ten przyklad zaczyna od trzeciego filmu na playliscie.

10. hl

Ustawia jezyk wlasnych elementow interfejsu odtwarzacza (nie dzwieku ani napisow filmu), uzywajac standardowego kodu jezyka.

https://www.youtube-nocookie.com/embed/ID_FILMU?hl=pl

11. cc_load_policy

Wymusza domyslne wyswietlanie napisow, gdy ustawione na 1, przydatne przy osadzeniach nastawionych na dostepnosc lub filmach z cichym autoodtwarzaniem, gdzie napisy niosa znaczenie.

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

12. color

Ustawia kolor paska postepu odtwarzacza, przyjmujac wartosc red lub white.

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

Laczenie kilku parametrow

Parametry laczy sie swobodnie. Przyjazny prywatnosci, responsywny, autoodtwarzajacy klip tlowy, ktory odtwarza sie w petli po cichu i ukrywa elementy sterujace, moze wygladac tak:

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

Tabela referencyjna

Parametr	Wartosci	Co robi
autoplay	0 / 1	Automatycznie uruchamia odtwarzanie
mute	0 / 1	Uruchamia wyciszony, wymagane do niezawodnego autoplay
start	sekundy	Punkt startu odtwarzania
end	sekundy	Punkt zatrzymania odtwarzania
loop	0 / 1	Odtwarza film ponownie (wymaga parametru playlist dla pojedynczego filmu)
controls	0 / 1	Pokazuje lub ukrywa pasek sterowania
rel	0 / 1	Ogranicza sugestie po zakonczeniu filmu do tego samego kanalu
list	ID playlisty	Laduje cala playliste przez /embed/videoseries
index	numer	Od ktorej pozycji na playliscie zaczac
hl	kod jezyka	Jezyk interfejsu odtwarzacza
cc_load_policy	0 / 1	Wymusza domyslne wlaczenie napisow
color	red / white	Kolor paska postepu

Powiazane artykuly

Po strone ukladu przy osadzaniu zobacz nasz poradnik responsywne osadzenia YouTube. Po strone prywatnosci zobacz osadzanie filmow YouTube bez plikow cookie. Po rozwiazywanie problemow zobacz film YouTube nie osadza sie: 8 rozwiazan.

Parametry czesto mylone ze soba

Kilka z tych dwunastu parametrow miesza sie ze soba wystarczajaco czesto, aby warto je bezposrednio porownac. autoplay i loop brzmia podobnie, ale robia rozne rzeczy: autoplay kontroluje, czy odtwarzanie zaczyna sie przy zaladowaniu, loop kontroluje, czy restartuje sie po zakonczeniu, i sa czesto uzywane razem, ale to niezalezne ustawienia. start i index tez latwo pomylic: start to przesuniecie czasowe w sekundach w obrebie jednego filmu, a index to pozycja na playliscie, liczona w elementach, a nie czasie. Poprawne ich sparowanie ma znaczenie, poniewaz niedopasowanie (na przyklad proba uzycia index na osadzeniu pojedynczego filmu) po prostu nie ma efektu, zamiast wywolac blad.

Parametry o ograniczonym lub niespojnym wsparciu

Nie kazdy parametr zachowuje sie identycznie w kazdym kontekscie. modestbranding, ktory ogranicza widocznosc logo YouTube, mial niespojne efekty w roznych wersjach odtwarzacza i jest ogolnie uwazany za ustawienie najlepszego starania, a nie gwarantowane. Podobnie niektore parametry zwiazane z wyswietlaniem moga zachowywac sie nieco inaczej w zaleznosci od tego, czy odwiedzajacy jest zalogowany na konto Google w przegladarce, poniewaz preferencje na poziomie konta moga wchodzic w interakcje z domyslnymi ustawieniami odtwarzacza. Parametry sterowania odtwarzaniem omowione powyzej, start, end, autoplay, mute, loop i controls, sa najbardziej niezawodne we wszystkich przegladarkach i stanach konta, dlatego to na nich warto oprzec strategie osadzania.

Przyklad krok po kroku: budowanie osadzenia na stronie kursu

Wyobraz sobie, ze osadzasz film lekcji na stronie kursu i chcesz, aby byl przyjazny prywatnosci, responsywny, rozpoczynajacy sie od drugiej minuty, gdzie faktycznie zaczyna sie tresc lekcji (pomijajac intro kanalu), z domyslnie wlaczonymi napisami dla dostepnosci i bez autoodtwarzania, poniewaz odwiedzajacy powinien sam zdecydowac o rozpoczeciu. Przechodzac przez parametry: przyjazny prywatnosci oznacza domene youtube-nocookie.com; responsywny oznacza kontener oparty na procentach zamiast stalych wymiarow; start od dwoch minut oznacza start=120; napisy domyslnie oznacza cc_load_policy=1; a brak autoplay oznacza po prostu pominiecie parametru autoplay, poniewaz to stan domyslny. Wynikowy adres URL osadzenia wygladalby tak:

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

Ten pojedynczy przyklad pokazuje, jak parametry omowione w tym poradniku laczo sie naturalnie, aby rozwiazac konkretny, realistyczny wymog, zamiast istniec jako abstrakcyjna lista.

Testowanie kombinacji parametrow

Przed opublikowaniem osadzenia z kilkoma polaczonymi parametrami warto przetestowac je bezposrednio, zamiast zakladac, ze kombinacja dziala zgodnie z oczekiwaniami. Wklej pelny adres URL osadzenia, ze wszystkimi parametrami, bezposrednio do karty przegladarki; odtwarzacz powinien zachowywac sie dokladnie tak, jak wewnatrz iframe Twojej strony, co pozwala wychwycic literowki w nazwach parametrow (powszechny blad, poniewaz zle wpisany parametr zwykle jest po cichu ignorowany, a nie oznaczany jako blad), zanim trafia na Twoja zywa strone.

Parametry a prywatnosc: ktore wchodza w interakcje z domena nocookie

Warto wyjasnic, ze kazdy parametr omowiony w tym poradniku dziala identycznie, niezaleznie od tego, czy uzywasz standardowej domeny osadzania youtube.com, czy domeny zwiekszajacej prywatnosc youtube-nocookie.com. Wybor domeny i parametry odtwarzania to calkowicie niezalezne decyzje: przelaczenie na domene zwiekszajaca prywatnosc nie wylacza ani nie zmienia zadnego z autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy czy color. To czesty punkt nieporozumienia, wart bezposredniego wyjasnienia, poniewaz niektorzy wlasciciele stron zakladaja, ze tryb prywatnosci to okrojona wersja odtwarzacza z mniejsza liczba opcji, podczas gdy w praktyce jest funkcjonalnie identyczny, tylko z innym zachowaniem cookie po stronie Google.

Budowanie wlasnej listy referencyjnej parametrow dla konkretnego projektu

Dla wiekszej strony z wieloma osadzonymi filmami warto wewnetrznie udokumentowac, ktorej kombinacji tych dwunastu parametrow domyslnie uzywa Twoj zespol, zamiast wymyslac to na nowo przy kazdym nowym osadzeniu. Prosty wewnetrzny standard, na przyklad: zawsze uzywaj domeny zwiekszajacej prywatnosc, zawsze wlaczaj rel=0, domyslnie bez autoplay, chyba ze konkretny typ strony tego wymaga, i zawsze uzywaj responsywnego kontenera, utrzymuje spojnosc osadzen w calej stronie i znacznie przyspiesza wykrycie zle skonfigurowanego podczas przegladu. Traktowanie tej listy dwunastu parametrow jako menu, z ktorego wybiera sie domyslne ustawienia, zamiast jednorazowej decyzji podejmowanej za kazdym razem od nowa, oplaca sie w miare wzrostu ilosci tresci wideo na stronie.

Ostatnie slowo o trzymaniu tej listy pod reka

Dodanie tej strony do zakladek, a konkretnie powyzszej tabeli referencyjnej, jest prawdopodobnie bardziej przydatne niz probowanie zapamietania wszystkich dwunastu parametrow na pamiec. W praktyce wiekszosc osadzen na typowej stronie uzywa naraz tylko trzech lub czterech z nich (zwykle domyslnie domena zwiekszajaca prywatnosc, rel=0 i czasem start lub autoplay/mute razem), wiec posiadanie pelnej listy do sprawdzenia w mniej typowych przypadkach, jak playlisty czy napisy, pokrywa pozostale sytuacje bez koniecznosci zapamietywania wszystkiego z gory.

Jak wlasna dokumentacja YouTube wypada w porownaniu z tym poradnikiem

YouTube publikuje wlasna dokumentacje deweloperska obejmujaca IFrame Player API i parametry osadzania, skierowana glownie do deweloperow budujacych niestandardowe odtwarzacze sterowane przez JavaScript, a nie do wlascicieli stron dodajacych proste osadzenie do strony. Ten poradnik skupia sie konkretnie na podzbiorze parametrow istotnych dla standardowego osadzenia iframe bez niestandardowego JavaScript, co pokrywa zdecydowana wiekszosc realnych przypadkow uzycia na zwyklych stronach internetowych. Dla kazdego, kto buduje bardziej zaawansowane, programowo sterowane doswiadczenia wideo (niestandardowe przyciski odtwarzania, sledzenie postepu ogladania, zsynchronizowane odtwarzacze wielu filmow), wlasna dokumentacja IFrame Player API YouTube jest kolejnym krokiem poza tym, co moze zaoferowac podejscie oparte na parametrach ciagu zapytania.

Podsumowanie dwunastu parametrow

Wsrod autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy i color, praktyczny wniosek jest taki, ze niewielka garstka (wybor domeny prywatnosci, rel i responsywny kontener) stanowi sensowne domyslne ustawienie dla niemal kazdego osadzenia, podczas gdy reszta (start/end, loop, formatowanie dla Shorts, playlisty, napisy, jezyk i kolor) to narzedzia sytuacyjne, po ktore warto siegac tylko wtedy, gdy konkretna strona tego naprawde wymaga, zamiast dodawac je bezkrytycznie do kazdego osadzenia w serwisie.

Trzymanie tej listy referencyjnej pod reka oznacza, ze nigdy nie musisz zgadywac nazw parametrow z pamieci, gdy pojawi sie nowa potrzeba osadzania.

Najczesciej zadawane pytania