YouTube
In Macro Deck enthaltenZeige deinen YouTube-Livechat und deine Stream-Statistiken, ändere Titel und Tags und reagiere auf Super Chats und Mitglieder.
Ein Widget YouTube-Chat und Widgets YouTube-Stream-Statistiken
- Widgets YouTube-Chat und YouTube-Stream-Statistiken
- Titel, Beschreibung und Tags des Streams festlegen
- Live gehen, den Stream beenden und Werbepausen starten
- Auslöser für Super Chats, Super Sticker und Mitgliedschaften
- Nutzt dein eigenes Google-Cloud-Projekt und Kontingent
Die YouTube-Integration verbindet deinen YouTube-Kanal mit Macro Deck. Sie zeigt den Zustand deines Livestreams als Variablen, löst bei Super Chats, Super Stickern und Mitgliedschaften aus, zeigt deinen Livechat in einem Widget, in dem du ihn moderieren kannst, und ändert deine Übertragung per Taste.
YouTube bietet keine gemeinsame Anmeldung, die Macro Deck für alle nutzen könnte. Du verbindest dich über ein eigenes Google-Cloud-Projekt, was einmalig etwa zehn Minuten dauert. Das Projekt ist kostenlos, und sein Kontingent und seine Berechtigungen gehören allein dir.
Was du damit machen kannst
- Eine Chatnachricht in den Livechat deiner aktuellen Übertragung senden.
- Titel, Beschreibung oder Tags der laufenden Übertragung ändern, oder der nächsten geplanten, wenn du nicht live bist.
- Die nächste geplante Übertragung mit Live gehen starten, sie mit Stream beenden beenden und YouTube um eine Werbepause bitten.
- Den Livechat im Widget YouTube-Chat anzeigen und von dort Nachrichten löschen, Chattern einen Timeout geben oder sie bannen.
- Im Widget YouTube-Stream-Statistiken anzeigen, ob du live bist, deine Zuschauer, Likes und Abonnenten, Titel und Laufzeit.
Einige Beispiele:
- Eine Taste Gleich live, die Titel und Tags deiner nächsten Übertragung festlegt.
- Eine Taste Werbepause, die YouTube um eine 60-sekündige Werbepause bittet.
- Ein Ablauf, der bei Super Chat läuft und eine Benachrichtigung mit Absender und Betrag anzeigt.
- Ein Ablauf, der bei Neues Mitglied läuft und eine Dankesnachricht in den Chat schreibt.
So verhält sich die Integration
Macro Deck liest deinen Stream-Status etwa einmal pro Minute und den Chat alle paar Sekunden, solange du live bist. Jedes Lesen und jede Änderung kostet Kontingent deines Google-Cloud-Projekts, das 10.000 Einheiten pro Tag bekommt. Macro Deck zählt mit. Ist das Kontingent fast aufgebraucht, pausiert es die Chat-Aktualisierungen und liest den Live-Status seltener. Ist das Kontingent aufgebraucht, pausiert es Live-Status- und Chat-Aktualisierungen bis Mitternacht pazifischer Zeit, wenn Google das Kontingent zurücksetzt.
Chat, Super Chats und Mitgliedschaftsereignisse kommen nur an, solange eine Übertragung live ist. Ereignisse, die passiert sind, während Macro Deck nicht lief, werden nicht nachträglich ausgelöst. Du kannst mehr als einen Kanal verbinden: Jede Aktion hat ein Feld Kanal, und jeder Auslöser lässt sich auf einen Kanal eingrenzen.
Das brauchst du
- Macro Deck 3 unter Windows, macOS oder Linux, mit Internetzugang
- Ein YouTube-Kanal, der live streamen kann
- Ein Google-Cloud-Projekt mit aktivierter YouTube Data API v3
- Eine OAuth-Client-ID vom Typ TVs and Limited Input devices mit ihrem Clientschlüssel
- Werbepause starten braucht eine Live-Übertragung auf einem Kanal, der Mid-Roll-Werbung zeigen kann
So richtest du sie ein
Schritt 1: Google-Cloud-Projekt erstellen
Öffne die Google Cloud console mit dem Google-Konto, dem dein Kanal gehört, und erstelle ein Projekt, zum Beispiel Macro Deck. Suche unter APIs & Services > Library nach YouTube Data API v3 und klicke auf Enable.
Schritt 2: Zustimmungsbildschirm einrichten
Öffne APIs & Services > OAuth consent screen (in neueren Konsolen Google Auth Platform). Wähle External, gib einen App-Namen und deine E-Mail-Adresse ein und speichere. Füge unter Audience (oder Test users) das Google-Konto, dem dein Kanal gehört, als Testnutzer hinzu.
Schritt 3: OAuth-Client-ID erstellen
Öffne APIs & Services > Credentials, klicke auf Create credentials > OAuth client ID und wähle den Anwendungstyp TVs and Limited Input devices. Jeder andere Typ wird bei der Anmeldung abgelehnt. Kopiere die Client ID und das Client secret, die Google anzeigt.
Schritt 4: Client in Macro Deck eintragen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf YouTube. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Konfiguration hinzufügen. Der Schalter oben rechts öffnet denselben Dialog, und die Integration ist eingeschaltet, sobald die Einrichtung abgeschlossen ist. Füge im Dialog YouTube-Kanal verbinden die Client-ID und den Clientschlüssel ein. Nur wenn Google deinem Projekt mehr Kontingent gewährt hat, schalte Erweiterte Konfiguration ein und trage es als Tageskontingent (Einheiten) ein. Klicke auf Fortfahren.
Schritt 5: Zugriff bei Google bestätigen
Der Dialog zeigt jetzt Zugriff bei Google bestätigen mit einem Gerätecode. Klicke auf Google öffnen und bestätigen, melde dich mit dem Konto an, dem dein Kanal gehört, gib den Code ein, wähle deinen Kanal und erlaube den Zugriff. Google warnt, dass die App nicht überprüft ist: Es ist dein eigenes Projekt, also fahre fort. Kehre zu Macro Deck zurück und klicke auf Fortfahren. Die Konfiguration wird nach deinem Kanal benannt, zum Beispiel YouTube (My Channel). Zeigt der Dialog Einrichtung abgeschlossen., klicke auf Fertig.
Schritt 6: YouTube-Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf die Taste, die du verwenden willst. Das Deck muss entsperrt sein: Zeigt die Schaltfläche oben rechts Sperren, ist es entsperrt. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen YouTube und nimm eine Aktion wie Stream-Titel festlegen. Wähle den Kanal, gib den Titel ein und klicke dann auf Speichern.
Aktionen7
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Chatnachricht senden
- Postet eine Nachricht mit bis zu 200 Zeichen im Livechat deiner aktuellen Übertragung.
- Stream-Titel festlegen
- Ändert den Titel deiner aktuellen Übertragung oder der nächsten geplanten, wenn du nicht live bist.
- Stream-Beschreibung festlegen
- Ändert die Beschreibung deiner aktuellen Übertragung oder der nächsten geplanten.
- Stream-Tags festlegen
- Ersetzt die Tags deiner aktuellen Übertragung oder der nächsten geplanten.
- Werbepause starten
- Bittet YouTube, während deiner Live-Übertragung eine Werbepause von 30 Sekunden bis 3 Minuten zu zeigen.
- Live gehen
- Startet die nächste geplante Übertragung, die bereit ist. Starte zuerst deine Streaming-Software.
- Stream beenden
- Beendet deine aktuelle Live-Übertragung.
Auslöser8
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Stream Online
- Der Kanal ist live gegangen.
- Stream Offline
- Die Live-Übertragung des Kanals ist beendet.
- Super Chat
- Jemand hat einen Super Chat gesendet, mit Absender, Betrag, Währung und Kommentar.
- Super Sticker
- Jemand hat einen Super Sticker gesendet.
- Neues Mitglied
- Jemand ist Mitglied des Kanals geworden oder hat seine Mitgliedschaft hochgestuft.
- Mitglieds-Meilenstein
- Ein Mitglied hat im Chat einen Mitgliedschafts-Meilenstein geteilt.
- Verschenkte Mitgliedschaften
- Jemand hat anderen Zuschauern Mitgliedschaften geschenkt.
- YouTube-Ereignis (erweitert)
- Jedes YouTube-Ereignis dieser Liste in einem Auslöser, auf Wunsch nach Typ gefiltert.
Variablen8
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
youtube_<channel>_display_name- Der Name des Kanals.
youtube_<channel>_is_live- Ob der Kanal live ist.
youtube_<channel>_stream_title- Der Titel der Live-Übertragung.
youtube_<channel>_viewer_count- Aktuelle Zuschauer. Leer, wenn du die Zuschaueranzahl ausblendest.
youtube_<channel>_like_count- Likes der Live-Übertragung.
youtube_<channel>_subscriber_count- Abonnenten des Kanals, so wie YouTube sie rundet.
youtube_<channel>_uptime_seconds- Wie lange die Übertragung läuft, in Sekunden.
youtube_<channel>_stream_thumbnail_url- Das Vorschaubild der Übertragung.
Widgets2
Füge sie über die Widget-Auswahl zu deinem Deck hinzu.
- YouTube-Chat
- Zeigt den Livechat deiner aktuellen Übertragung, auch Super Chats und neue Mitglieder. Drücke es, um in einem größeren Dialog zu moderieren.
- YouTube-Stream-Statistiken
- Zeigt Live-Status, Zuschauer, Likes und Abonnenten, Titel und Laufzeit in einem Stil deiner Wahl.
Häufige Fragen
Warum brauche ich ein eigenes Google-Cloud-Projekt?
YouTube bietet keine gemeinsame Anmeldung, die Macro Deck für alle nutzen könnte. Mit deinem eigenen Projekt gehören Kontingent und Berechtigungen allein dir. Das Projekt ist kostenlos.
Warum muss ich mich jede Woche neu anmelden?
Solange der Zustimmungsbildschirm deines Projekts im Testmodus ist, beendet Google die Anmeldung nach 7 Tagen. Integrationen zeigt dann, dass die Anmeldung abgelaufen ist; verbinde dich mit derselben Client-ID und demselben Clientschlüssel neu. Um angemeldet zu bleiben, veröffentliche den Zustimmungsbildschirm in der Google Cloud console.
Was passiert, wenn das Kontingent aufgebraucht ist?
Macro Deck pausiert die Aktualisierung von Live-Status und Chat, und die YouTube-Seite unter Integrationen zeigt YouTube-Kontingent aufgebraucht. Google setzt das Kontingent um Mitternacht pazifischer Zeit zurück, dann geht es weiter. Aktionen funktionieren, bis Google sie ablehnt.
Warum startet Live gehen meinen Stream nicht?
Live gehen startet die nächste geplante Übertragung, deren Stream bereits bei YouTube ankommt, starte also zuerst deine Streaming-Software. Übertragungen, die von selbst starten, und Stream now in YouTube Studio werden von YouTube gestartet, nicht von dieser Aktion.
Kann ich jemanden über das Chat-Widget entbannen?
Nur Banns, die du während der aktuellen Übertragung über Macro Deck ausgesprochen hast, und nur bis Macro Deck neu startet. YouTube teilt Macro Deck nicht mit, welche Banns es gibt, also hebe andere Banns in YouTube Studio auf.
Wo werden meine Zugangsdaten gespeichert?
Clientschlüssel und Tokens werden verschlüsselt auf dem Computer gespeichert, auf dem Macro Deck läuft, und nur an Google gesendet.
Mehr in „Streaming“
OBS Studio
In Macro Deck enthaltenWechsle Szenen, steuere Stream, Aufnahme und Audio und reagiere auf das, was in OBS Studio passiert.
Meld Studio
In Macro Deck enthaltenWechsle und bereite Szenen vor, steuere Ebenen, Effekte und Audiospuren und geh in Meld Studio live.
Streamlabs Desktop
In Macro Deck enthaltenWechsle Szenen und steuere Stream, Aufnahme und Audioquellen in Streamlabs Desktop.
Streamer.bot
In Macro Deck enthaltenFühre Streamer.bot-Aktionen aus, sende Chatnachrichten und reagiere auf jedes Ereignis, das Streamer.bot meldet.
Twitch
In Macro Deck enthaltenZeige deinen Twitch-Chat und deine Stream-Statistiken, moderiere, starte Umfragen und Werbung und reagiere auf Follows, Subs und Raids.