YouTube
Dołączona do Macro DeckPokazuj czat na żywo i statystyki transmisji YouTube, zmieniaj tytuł i tagi oraz reaguj na Super Chaty i członków.
Widżet Czat YouTube i widżety Statystyki transmisji YouTube
- Widżety Czat YouTube i Statystyki transmisji YouTube
- Ustawianie tytułu, opisu i tagów transmisji
- Rozpoczynanie i kończenie transmisji oraz przerwy reklamowe
- Wyzwalacze dla Super Chatów, Super Stickerów i członkostw
- Własny projekt Google Cloud i własny limit
Integracja YouTube łączy kanał YouTube z Macro Deck. Pokazuje stan transmisji na żywo w postaci zmiennych, uruchamia wyzwalacze dla Super Chatów, Super Stickerów i członkostw, wyświetla czat na żywo w widżecie, w którym można go moderować, i zmienia transmisję z poziomu przycisku.
YouTube nie oferuje wspólnego logowania, z którego Macro Deck mógłby korzystać dla wszystkich. Połączenie odbywa się przez własny projekt Google Cloud, którego jednorazowe utworzenie zajmuje około dziesięciu minut. Projekt jest bezpłatny, a jego limit i uprawnienia należą wyłącznie do jego właściciela.
Możliwości
- Wysyłanie wiadomości na czacie na żywo bieżącej transmisji.
- Zmiana tytułu, opisu lub tagów trwającej transmisji albo następnej zaplanowanej, gdy nie trwa transmisja na żywo.
- Rozpoczynanie następnej zaplanowanej transmisji akcją Rozpocznij transmisję na żywo, kończenie jej akcją Zakończ transmisję i proszenie YouTube o przerwę reklamową.
- Wyświetlanie czatu na żywo w widżecie Czat YouTube oraz usuwanie wiadomości, czasowe blokowanie lub banowanie uczestników czatu z jego poziomu.
- Wyświetlanie statusu na żywo, widzów, polubień i subskrybentów, tytułu i czasu trwania transmisji w widżecie Statystyki transmisji YouTube.
Przykładowe zastosowania:
- Przycisk Zaraz na żywo, który ustawia tytuł i tagi następnej transmisji.
- Przycisk Przerwa reklamowa, który prosi YouTube o 60-sekundową przerwę reklamową.
- Przebieg uruchamiany wyzwalaczem Super Chat, który wyświetla powiadomienie z autorem i kwotą.
- Przebieg uruchamiany wyzwalaczem Nowy członek, który publikuje podziękowanie na czacie.
Działanie
Macro Deck odczytuje stan transmisji mniej więcej raz na minutę, a podczas transmisji na żywo czat co kilka sekund. Każdy odczyt i każda zmiana zużywa limit projektu Google Cloud, który wynosi 10 000 jednostek dziennie. Macro Deck liczy zużycie. Gdy limit jest prawie wyczerpany, wstrzymuje aktualizacje czatu i rzadziej odczytuje status na żywo. Gdy limit zostanie wyczerpany, wstrzymuje aktualizacje statusu na żywo i czatu do północy czasu pacyficznego, kiedy Google resetuje limit.
Czat, Super Chaty i zdarzenia członkostwa docierają tylko podczas transmisji na żywo. Zdarzenia, które nastąpiły, gdy Macro Deck nie działał, nie są uruchamiane później. Można połączyć więcej niż jeden kanał: każda akcja ma pole Kanał, a każdy wyzwalacz można ograniczyć do jednego kanału.
Czego potrzebujesz
- Macro Deck 3 w systemie Windows, macOS lub Linux, z dostępem do internetu
- Kanał YouTube, który może nadawać na żywo
- Projekt Google Cloud z włączonym YouTube Data API v3
- Identyfikator klienta OAuth typu TVs and Limited Input devices wraz z tajnym kluczem klienta
- Rozpocznij przerwę reklamową wymaga transmisji na żywo na kanale, który może wyświetlać reklamy w trakcie filmu
Konfiguracja krok po kroku
Krok 1: Utwórz projekt Google Cloud
Otwórz konsolę Google Cloud kontem Google, do którego należy kanał, i utwórz projekt, np. Macro Deck. W Interfejsy API i usługi > Biblioteka wyszukaj YouTube Data API v3 i kliknij Włącz.
Krok 2: Skonfiguruj ekran zgody
Otwórz Interfejsy API i usługi > Ekran zgody OAuth (w nowszych wersjach konsoli Google Auth Platform). Wybierz Zewnętrzny, wpisz nazwę aplikacji i swój adres e-mail, a następnie zapisz. W sekcji Odbiorcy (lub Użytkownicy testowi) dodaj konto Google, do którego należy kanał, jako użytkownika testowego.
Krok 3: Utwórz identyfikator klienta OAuth
Otwórz Interfejsy API i usługi > Dane logowania, kliknij Utwórz dane logowania > Identyfikator klienta OAuth i wybierz typ aplikacji TVs and Limited Input devices. Każdy inny typ zostanie odrzucony podczas logowania. Skopiuj identyfikator klienta i tajny klucz klienta, które pokaże Google.
Krok 4: Wprowadź klienta w Macro Deck
W Macro Deck kliknij Integracje na pasku bocznym, a następnie YouTube. Na karcie Przegląd kliknij Dodaj konfigurację w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno, a integracja zostaje włączona po zakończeniu konfiguracji. W oknie Połącz kanał YouTube wklej wartości w polach Identyfikator klienta i Tajny klucz klienta. Tylko jeśli Google przyznał projektowi większy limit, włącz Konfiguracja zaawansowana i wpisz go w polu Dzienny limit (jednostki). Kliknij Dalej.
Krok 5: Zatwierdź dostęp w Google
Okno pokazuje teraz krok Zatwierdź dostęp w Google z polem Kod urządzenia. Kliknij Otwórz Google i zatwierdź, zaloguj się kontem, do którego należy kanał, wpisz kod, wybierz kanał i zezwól na dostęp. Google ostrzeże, że aplikacja nie jest zweryfikowana: to własny projekt, więc kontynuuj. Wróć do Macro Deck i kliknij Dalej. Konfiguracja otrzyma nazwę według kanału, np. YouTube (My Channel). Gdy okno pokaże Konfiguracja zakończona., kliknij Gotowe.
Krok 6: Dodaj akcję YouTube do przycisku
Na stronie Deck kliknij przycisk, który ma zostać użyty. Deck musi być odblokowany: jest odblokowany, gdy przycisk w prawym górnym rogu ma etykietę Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz YouTube i wybierz akcję, np. Ustaw tytuł transmisji. Wybierz kanał w polu Kanał, wpisz tytuł w polu Tytuł, a następnie kliknij Zapisz.
Akcje7
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Wyślij wiadomość na czacie
- Publikuje wiadomość o długości do 200 znaków na czacie na żywo bieżącej transmisji.
- Ustaw tytuł transmisji
- Zmienia tytuł bieżącej transmisji albo następnej zaplanowanej, gdy nie trwa transmisja na żywo.
- Ustaw opis transmisji
- Zmienia opis bieżącej transmisji albo następnej zaplanowanej.
- Ustaw tagi transmisji
- Zastępuje tagi bieżącej transmisji albo następnej zaplanowanej.
- Rozpocznij przerwę reklamową
- Prosi YouTube o wyświetlenie przerwy reklamowej trwającej od 30 sekund do 3 minut podczas transmisji na żywo.
- Rozpocznij transmisję na żywo
- Rozpoczyna następną zaplanowaną transmisję, która jest gotowa. Najpierw uruchom oprogramowanie do streamowania.
- Zakończ transmisję
- Kończy bieżącą transmisję na żywo.
Wyzwalacze8
Przycisk lub przebieg może reagować na te zdarzenia.
- Transmisja online
- Kanał rozpoczął transmisję na żywo.
- Transmisja offline
- Transmisja na żywo kanału się zakończyła.
- Super Chat
- Ktoś wysłał Super Chat, wraz z autorem, kwotą, walutą i komentarzem.
- Super Sticker
- Ktoś wysłał Super Sticker.
- Nowy członek
- Ktoś został członkiem kanału lub podniósł poziom członkostwa.
- Kamień milowy członkostwa
- Członek udostępnił na czacie kamień milowy członkostwa.
- Podarowane członkostwa
- Ktoś podarował członkostwa innym widzom.
- Zdarzenie YouTube (zaawansowane)
- Wszystkie zdarzenia YouTube z tej listy w jednym wyzwalaczu, opcjonalnie filtrowane według typu.
Zmienne8
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
youtube_<channel>_display_name- Nazwa kanału.
youtube_<channel>_is_live- Czy kanał nadaje na żywo.
youtube_<channel>_stream_title- Tytuł transmisji na żywo.
youtube_<channel>_viewer_count- Bieżąca liczba widzów. Pusta, gdy liczba widzów jest ukryta.
youtube_<channel>_like_count- Polubienia transmisji na żywo.
youtube_<channel>_subscriber_count- Subskrybenci kanału w zaokrągleniu stosowanym przez YouTube.
youtube_<channel>_uptime_seconds- Jak długo trwa transmisja, w sekundach.
youtube_<channel>_stream_thumbnail_url- Miniatura transmisji.
Widżety2
Dodaj je do decku z selektora widżetów.
- Czat YouTube
- Pokazuje czat na żywo bieżącej transmisji, w tym Super Chaty i nowych członków. Naciśnięcie otwiera większe okno do moderowania.
- Statystyki transmisji YouTube
- Pokazuje status na żywo, widzów, polubienia i subskrybentów, tytuł i czas trwania transmisji w wybranym stylu.
Najczęściej zadawane pytania
Dlaczego potrzebuję własnego projektu Google Cloud?
YouTube nie oferuje wspólnego logowania, z którego Macro Deck mógłby korzystać dla wszystkich. We własnym projekcie limit i uprawnienia należą wyłącznie do jego właściciela. Projekt jest bezpłatny.
Dlaczego co tydzień muszę logować się ponownie?
Dopóki ekran zgody projektu jest w trybie testowym, Google kończy logowanie po 7 dniach. Integracje pokazują wtedy, że logowanie wygasło; połącz się ponownie z tym samym identyfikatorem i tajnym kluczem klienta. Aby pozostać zalogowanym, opublikuj ekran zgody w konsoli Google Cloud.
Co się dzieje po wyczerpaniu limitu?
Macro Deck wstrzymuje aktualizacje statusu na żywo i czatu, a strona YouTube w sekcji Integracje pokazuje Limit YouTube wykorzystany. Google resetuje limit o północy czasu pacyficznego i wtedy aktualizacje są wznawiane. Akcje działają, dopóki Google ich nie odrzuci.
Dlaczego Rozpocznij transmisję na żywo nie uruchamia transmisji?
Rozpocznij transmisję na żywo rozpoczyna następną zaplanowaną transmisję, której strumień już dociera do YouTube, więc najpierw uruchom oprogramowanie do streamowania. Transmisje, które rozpoczynają się same, oraz Transmituj teraz w YouTube Studio są uruchamiane przez YouTube, a nie przez tę akcję.
Czy mogę odbanować kogoś z widżetu czatu?
Tylko w przypadku banów nałożonych przez Macro Deck podczas bieżącej transmisji i tylko do ponownego uruchomienia Macro Deck. YouTube nie informuje Macro Deck, jakie bany istnieją, więc pozostałe bany znieś w YouTube Studio.
Gdzie są przechowywane moje dane uwierzytelniające?
Tajny klucz klienta i tokeny są przechowywane w postaci zaszyfrowanej na komputerze, na którym działa Macro Deck, i wysyłane wyłącznie do Google.
Więcej w kategorii Streaming
OBS Studio
Dołączona do Macro DeckPrzełączaj sceny, steruj transmisją, nagrywaniem i dźwiękiem oraz reaguj na to, co dzieje się w OBS Studio.
Meld Studio
Dołączona do Macro DeckPrzełączaj i przygotowuj sceny, steruj warstwami, efektami i ścieżkami audio oraz rozpoczynaj transmisję w Meld Studio.
Streamlabs Desktop
Dołączona do Macro DeckPrzełączaj sceny, steruj transmisją, nagrywaniem i źródłami audio w Streamlabs Desktop.
Streamer.bot
Dołączona do Macro DeckUruchamiaj akcje Streamer.bot, wysyłaj wiadomości na czacie i reaguj na każde zdarzenie zgłaszane przez Streamer.bot.
Twitch
Dołączona do Macro DeckPokazuj czat i statystyki transmisji na Twitchu, moderuj, uruchamiaj ankiety i reklamy oraz reaguj na obserwacje, suby i raidy.