Na tej stronie możesz obejrzeć prezentację funkcji interfejsu YouTube Player API. Odtwarzacz umieszczony na stronie musi mieć okno wyświetlania o rozmiarze co najmniej 200 x 200 pikseli. Jeżeli w odtwarzaczu mają być widoczne elementy sterujące, musi on być na tyle duży, aby elementy te były całkowicie widoczne bez zmniejszania okna wyświetlania poniżej rozmiaru minimalnego. W przypadku odtwarzaczy 16:9 zalecamy rozmiar co najmniej 480 pikseli szerokości i 270 pikseli wysokości.

Treść Możesz wybrać, czy chcesz wczytać treść do odtwarzacza, czy dodać ją do kolejki. Jeśli zdecydujesz się na wczytanie i zaktualizujesz odtwarzacz, to wybrana treść zostanie odtworzona, nawet jeśli akurat był wyświetlany inny film. Jeśli wybierzesz dodanie treści do kolejki, a następnie zaktualizujesz odtwarzacz, to film zostanie wczytany, ale jego odtwarzanie nie rozpocznie się. Żeby włączyć film, trzeba będzie kliknąć link Odtwórz w sekcji elementów sterujących odtwarzacza albo sam odtwarzacz. W zależności od tego, co wybierzesz, strona wywoła jedną z następujących funkcji API: loadVideoById loadVideoByUrl loadPlaylist cueVideoById cueVideoByUrl cuePlaylist	Wczytanie filmu o podanym identyfikatorze: Wczytanie listy filmów o podanych identyfikatorach: Wczytanie playlisty o podanym identyfikatorze: Wczytanie przesłanych filmów z danego kanału: Wczytanie wyników wyszukiwania określonego hasła: Skolejkowanie filmu za pomocą jego identyfikatora: Skolejkowanie listy filmów za pomocą ich identyfikatorów: Skolejkowanie playlisty za pomocą jej identyfikatora: Skolejkowanie przesłanych filmów z danego kanału: Skolejkowanie wyników wyszukiwania określonego hasła:   Czas rozpoczęcia (w sekundach od początku filmu):   Sugerowana jakość: default highres hd1080 hd720 large medium small
Sterowanie Elementy sterujące z tej sekcji pozwalają odtworzyć, wstrzymać i zatrzymać film. Aby przewinąć film do określonego momentu, w polu Przewiń do wpisz wyrażony w sekundach czas od początku wideo. Odtwarzanie rozpocznie się od podanego momentu.	Odtwórz | Wstrzymaj | Zakończ Przewiń do:     Przejdź Poprzedni | Następny Przejdź do (numer indeksu playlisty):      Przejdź Odtwarzaj filmy w pętli: off|on Odtwarzaj losowo: odtwarzanie losowe | powrót do pierwotnej kolejności
Głośność Elementy służące do wyciszania i wyłączania wyciszenia odpowiednio wyłączają dźwięk i włączają go z powrotem. Pole Dźwięk wł./wył. w sekcji Statystyka informuje, czy dźwięk w odtwarzaczu jest wyciszony. Głośność dźwięku w odtwarzaczu możesz ustawić, wpisując w polu Ustaw głośność wartość od 0 do 100. Zmiany zostaną zastosowane, gdy klikniesz poza polem lub wyjdziesz z niego klawiszem Tab.	Wycisz | Wyłącz wyciszenie Ustaw:   (0-100) [ aktualny poziom:  --]
Jakość Ta lista rozwijana pozwala wywołać funkcję setPlaybackQuality(), która umożliwia zmianę jakości filmu w trakcie odtwarzania. Po zmianie jakości odtwarzanie zostaje wstrzymywane i rozpoczyna się ponownie od początku. W polu Dostępne poziomy w sekcji Statystyka znajdziesz listę poziomów jakości, jakie można zastosować w danym filmie. Jeżeli wybierzesz niedostępny poziom, YouTube dobierze najbardziej odpowiedni z tych, które mogą być zastosowane. Jeśli na przykład wybierzesz poziom niska, ale obsługiwane są poziomy średnia i wysoka, YouTube ustawi poziom średnia.	default highres hd1080 hd720 large medium small
Ocena To ustawienie określa, z jaką prędkością ma być odtwarzany film. Funkcja getAvailablePlaybackRates() zwraca zbiór prędkości, które można ustawić dla danego filmu. W tej prezentacji dostępne ustawienia możesz zobaczyć w sekcji Statystyka. Wartość 1 oznacza, że film będzie odtwarzany ze zwykłą prędkością.	Aktualizuj prędkość odtwarzania
Rozmiar W tej sekcji można zmienić rozmiar odtwarzacza za pomocą funkcji setSize(szerokość, wysokość). Ta funkcja znajduje zastosowanie raczej tylko w aplikacjach ActionScript. W aplikacjach napisanych w JavaScript odtwarzacz o zmienionym rozmiarze zostanie wstawiony do obiektu, który go zawiera, nawet wtedy, gdy ten obiekt będzie mniejszy lub większy od samego odtwarzacza.	Proporcje obrazu 16x9 4x3 Wymiary:  x 405    Aktualizuj rozmiar odtwarzacza
Historia Gdy odtwarzacz jest gotowy do wyświetlenia filmu, strona wywołuje funkcje getVideoUrl() i getEmbedCode(). W przypadku skolejkowania lub wczytania wideo są one wywoływane ponownie. Jeżeli funkcja getVideoUrl() zostanie wywołana po przynajmniej 10 sekundach odtwarzania, to w URL-u znajdzie się parametr, który wskazuje, o ile powinno zostać przesunięte miejsce rozpoczęcia odtwarzania.	(wyczyść) Błędy Jak dotąd brak. Zdarzenia i wywołania funkcji Jak dotąd brak.

Parametry odtwarzacza

  • pole zaznaczone = wartość parametru 1
  • pole niezaznaczone = wartość parametru 0
  • Kod IFrame do umieszczenia na stronie pozwala wstawić na stronę odtwarzacz z włączonymi wybranymi opcjami.

Parametr	Wartość
autoplay  1 – odtwarzanie rozpocznie się automatycznie po wczytaniu odtwarzacza. 0 (domyślnie) – po wczytaniu odtwarzacza wyświetlanie filmu nie zostanie automatycznie włączone.
cc_load_policy  1 – napisy zostaną domyślnie wyświetlone, nawet jeśli zostały wyłączone przez użytkownika. Domyślny sposób działania zależy od preferencji użytkownika.
color Ten parametr określa, jakim kolorem na pasku postępu wideo ma być zaznaczana część filmu, która została już obejrzana. Domyślnym kolorem jest czerwony.	red white
controls  1 (domyślnie) – w odtwarzaczu są wyświetlane elementy sterujące. 0 – w odtwarzaczu nie są wyświetlane elementy sterujące.
disablekb  1 – wyłącza klawisze sterujące odtwarzaczem. 0 (domyślnie) – włącza klawisze sterujące odtwarzaczem. Klawisze sterujące odtwarzaczem to: Spacja: odtwarzanie/pauza Strzałka w lewo: cofnięcie się o kilka sekund w oglądanym filmie. Strzałka w prawo: przejście w przód o kilka sekund w oglądanym filmie. Strzałka w górę: głośniej Strzałka w dół: ciszej
enablejsapi  1 – włączenie sterowania odtwarzaczem za pomocą IFrame Player API. 0 (domyślnie) – API wyłączone.
end  Czas, po którym odtwarzanie filmu powinno się zakończyć. Wartością jest dodatnia liczba całkowita wyrażająca liczbę sekund odtwarzania, po upływie której wideo ma zostać zatrzymane.
fs  1 (domyślnie) – w odtwarzaczu pojawia się przycisk włączenia trybu pełnoekranowego. 0 – odtwarzacz nie wyświetla przycisku.
hl  Określa język interfejsu odtwarzacza. Wartością tego parametru jest dwuliterowy kod języka zgodny z normą ISO 639-1 lub w pełni sprecyzowane ustawienie regionalne, na przykład fr lub fr-ca. Inne kody języków, na przykład tagi IETF (BCP 47), także mogą być prawidłowo obsługiwane. Język interfejsu służy do wyświetlania podpowiedzi w odtwarzaczu, ma też wpływ na to, jaka będzie domyślna ścieżka napisów.
iv_load_policy 1 (domyślnie) – adnotacje w filmach będą widoczne. 3 – adnotacje w filmach nie będą widoczne.	1 3
list  Parametr, który w połączeniu z parametrem list służy do identyfikacji treści wczytywanej do odtwarzacza. playlist – parametr list określa identyfikator playlisty YouTube. Pamiętaj, że jego wartość musi zaczynać się od liter PL. search – parametr list określa wyszukiwane słowa służące do wybrania materiałów do odtworzenia. user_uploads – parametr list określa kanał YouTube, z którego będą pochodzić wczytywane filmy.
listType Parametr, który w połączeniu z parametrem list służy do identyfikacji treści wczytywanej do odtwarzacza. search – parametr list określa wyszukiwane słowa służące do wybrania materiałów do odtworzenia. user_uploads – parametr list określa kanał YouTube, z którego będą pochodzić wczytywane filmy. playlist – parametr list określa identyfikator playlisty YouTube. Pamiętaj, że jego wartość musi zaczynać się od liter PL.	search user_uploads playlist
loop  1 – jeżeli odtwarzacz wczytuje jeden film, to będzie on odtwarzany w pętli. Jeżeli wczytywana jest playlista, to będzie ona odtwarzana w pętli: gdy skończy się ostatni film, odtwarzacz przejdzie z powrotem do pierwszego. 0 (domyślnie) – filmy ani playlisty nie będą odtwarzane w pętli.
modestbranding  1 – na pasku sterowania nie pojawi się logo YouTube. Po najechaniu wskaźnikiem myszy na odtwarzacz ukaże się jednak etykieta tekstowa YouTube lub znak wodny. 0 – na pasku sterującym odtwarzacza pojawi się logo YouTube.
playlist  Rozdzielona przecinkami lista identyfikatorów filmów, które mają być kolejno odtwarzane.
playsinline  1 – włącza odtwarzanie w treści strony dla obiektu UIWebViews, który został utworzony z właściwością allowsInlineMediaPlayback o wartości TRUE. 0 (domyślnie) – włącza wyświetlanie na pełnym ekranie. Pamiętaj, że wartość domyślna może ulec zmianie.
start  Przesunięcie miejsca rozpoczęcia odtwarzania. Wartość to dodatnia liczba całkowita oznaczająca sekundę filmu, od której powinno się zacząć odtwarzanie. Odtwarzacz przechodzi do klatki, która jest najbliższa podanego czasu lub następuje tuż przed nim.

Statystyki   W tej sekcji znajdziesz opisy stanu odtwarzacza i wyświetlanego filmu (albo ostatniego filmu do odtworzenia). Na liście znajdują się nazwy funkcji API powiązanych z poszczególnymi polami tej sekcji:

• Czas trwania: getDuration()
• Aktualny czas: getCurrentTime()
• Stan odtwarzacza: getPlayerState()
• Wczytany procent filmu: getVideoLoadedFraction()
• Bajty początkowe: getVideoStartBytes()
• Poziom jakości: getPlaybackQuality()
• Dostępne poziomy: getAvailableQualityLevels()
• Dźwięk (wł./wył.): isMuted()
• Liczba filmów na playliście: count(getPlaylist())
• Pozycja aktualnego filmu: getPlaylistIndex()
• Filmy na playliście: getPlaylist()
• Wczytano bajtów: getVideoBytesLoaded() (nieużywane)
• Łącznie bajtów: getVideoBytesTotal() (nieużywane)

Czas trwania: --:--
Aktualny czas: --:--
Stan odtwarzacza: --
Bajty początkowe: --
Wczytany % filmu: --
Dźwięk (wł./wył.):
Prędkość odtwarzania: --
Dostępne prędkości:
Przestarzałe
Wczytano bajtów: --
Łącznie bajtów: --

Liczba filmów na playliście:
Pozycja aktualnego filmu:
Filmy na playliście: