YouTube
Incluse avec Macro DeckAffichez votre chat en direct et vos statistiques YouTube, modifiez le titre et les tags, et réagissez aux Super Chats et aux membres.
Un widget Chat YouTube et des widgets Statistiques de direct YouTube
- Widgets Chat YouTube et Statistiques de direct YouTube
- Définissez le titre, la description et les tags du direct
- Passez en direct, terminez le direct et lancez des pauses publicitaires
- Des déclencheurs pour les Super Chats, Super Stickers et abonnements de membre
- Utilise votre propre projet Google Cloud et votre propre quota
L'intégration YouTube relie votre chaîne YouTube à Macro Deck. Elle affiche l'état de votre direct sous forme de variables, déclenche des événements pour les Super Chats, Super Stickers et abonnements de membre, affiche votre chat en direct dans un widget où vous pouvez le modérer, et modifie votre diffusion depuis un bouton.
YouTube ne propose pas de connexion partagée que Macro Deck pourrait utiliser pour tout le monde. Vous vous connectez via votre propre projet Google Cloud, ce qui prend une dizaine de minutes, une seule fois. Le projet est gratuit, et son quota et ses autorisations n'appartiennent qu'à vous.
Ce que vous pouvez faire
- Envoyer un message dans le chat en direct de votre diffusion en cours.
- Modifier le titre, la description ou les tags de la diffusion en direct, ou de la prochaine diffusion programmée quand vous n'êtes pas en direct.
- Lancer la prochaine diffusion programmée avec Passer en direct, la terminer avec Terminer le direct, et demander une pause publicitaire à YouTube.
- Afficher le chat en direct dans le widget Chat YouTube, et y supprimer des messages, mettre en pause ou bannir des participants.
- Afficher si vous êtes en direct, vos spectateurs, « J'aime » et abonnés, le titre et la durée du direct dans le widget Statistiques de direct YouTube.
Quelques exemples de configuration :
- Un bouton On passe en direct qui définit le titre et les tags de votre prochaine diffusion.
- Un bouton Pub qui demande à YouTube une pause publicitaire de 60 secondes.
- Un flux qui s'exécute sur Super Chat et affiche une notification avec l'auteur et le montant.
- Un flux qui s'exécute sur Nouveau membre et publie un message de remerciement dans le chat.
Fonctionnement
Macro Deck lit l'état de votre direct environ une fois par minute et le chat toutes les quelques secondes pendant que vous êtes en direct. Chaque lecture et chaque modification consomme du quota de votre projet Google Cloud, qui dispose de 10 000 unités par jour. Macro Deck fait le compte. Quand le quota est presque épuisé, il met en pause les mises à jour du chat et lit l'état du direct moins souvent. Quand le quota est épuisé, il met en pause les mises à jour de l'état du direct et du chat jusqu'à minuit, heure du Pacifique, moment où Google réinitialise le quota.
Le chat, les Super Chats et les événements de membres n'arrivent que pendant une diffusion en direct. Les événements survenus pendant que Macro Deck ne tournait pas ne sont pas déclenchés après coup. Vous pouvez connecter plusieurs chaînes : chaque action possède un champ Chaîne, et chaque déclencheur peut être limité à une chaîne.
Ce qu'il vous faut
- Macro Deck 3 sous Windows, macOS ou Linux, avec un accès à Internet
- Une chaîne YouTube qui peut diffuser en direct
- Un projet Google Cloud avec la YouTube Data API v3 activée
- Un ID client OAuth de type TV et appareils à saisie limitée, avec son code secret
- Lancer une pause publicitaire nécessite une diffusion en direct sur une chaîne qui peut afficher des annonces mid-roll
Configuration
Étape 1: Créez un projet Google Cloud
Ouvrez la console Google Cloud avec le compte Google propriétaire de votre chaîne et créez un projet, par exemple Macro Deck. Sous API et services > Bibliothèque, cherchez YouTube Data API v3 et cliquez sur Activer.
Étape 2: Configurez l'écran de consentement
Ouvrez API et services > Écran de consentement OAuth (dans les consoles récentes Google Auth Platform). Choisissez Externe, saisissez un nom d'application et votre adresse e-mail, puis enregistrez. Sous Audience (ou Utilisateurs tests), ajoutez le compte Google propriétaire de votre chaîne comme utilisateur test.
Étape 3: Créez un ID client OAuth
Ouvrez API et services > Identifiants, cliquez sur Créer des identifiants > ID client OAuth et choisissez le type d'application TV et appareils à saisie limitée. Tout autre type est refusé lors de la connexion. Copiez l'ID client et le Code secret du client affichés par Google.
Étape 4: Saisissez le client dans Macro Deck
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur YouTube. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée. Dans la boîte de dialogue Connecter une chaîne YouTube, collez l'ID client et le Code secret du client. Uniquement si Google a accordé plus de quota à votre projet, activez Configuration avancée et saisissez ce quota dans Quota quotidien (unités). Cliquez sur Continuer.
Étape 5: Approuvez l'accès sur Google
La boîte de dialogue affiche maintenant Approuver l'accès sur Google avec un Code de l'appareil. Cliquez sur Ouvrir Google et approuver, connectez-vous avec le compte propriétaire de votre chaîne, saisissez le code, choisissez votre chaîne et autorisez l'accès. Google avertit que l'application n'est pas validée : c'est votre propre projet, continuez donc. Revenez dans Macro Deck et cliquez sur Continuer. La configuration porte le nom de votre chaîne, par exemple YouTube (My Channel). Quand la boîte de dialogue affiche Configuration terminée., cliquez sur Terminé.
Étape 6: Ajoutez une action YouTube à un bouton
Sur la page Deck, cliquez sur le bouton que vous voulez utiliser. Le deck doit être déverrouillé : c'est le cas lorsque le bouton en haut à droite indique Verrouiller. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez YouTube à gauche de la boîte de dialogue Ajouter une action et choisissez une action comme Définir le titre du direct. Choisissez la Chaîne, saisissez le Titre, puis cliquez sur Enregistrer.
Actions7
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Envoyer un message dans le chat
- Publie un message de 200 caractères maximum dans le chat en direct de votre diffusion en cours.
- Définir le titre du direct
- Modifie le titre de votre diffusion en cours, ou de la prochaine diffusion programmée quand vous n'êtes pas en direct.
- Définir la description du direct
- Modifie la description de votre diffusion en cours, ou de la prochaine diffusion programmée.
- Définir les tags du direct
- Remplace les tags de votre diffusion en cours, ou de la prochaine diffusion programmée.
- Lancer une pause publicitaire
- Demande à YouTube d'afficher une pause publicitaire de 30 secondes à 3 minutes pendant votre diffusion en direct.
- Passer en direct
- Lance la prochaine diffusion programmée qui est prête. Lancez d'abord votre logiciel de streaming.
- Terminer le direct
- Termine votre diffusion en direct actuelle.
Déclencheurs8
Un bouton ou un flux peut réagir à ces événements.
- Direct démarré
- La chaîne est passée en direct.
- Direct terminé
- La diffusion en direct de la chaîne s'est terminée.
- Super Chat
- Quelqu'un a envoyé un Super Chat, avec l'auteur, le montant, la devise et le commentaire.
- Super Sticker
- Quelqu'un a envoyé un Super Sticker.
- Nouveau membre
- Quelqu'un est devenu membre de la chaîne ou a amélioré son abonnement.
- Étape d'abonnement
- Un membre a partagé une étape de son abonnement dans le chat.
- Abonnements offerts
- Quelqu'un a offert des abonnements de membre à d'autres spectateurs.
- Événement YouTube (avancé)
- Tous les événements YouTube de cette liste en un seul déclencheur, éventuellement filtrés par type.
Variables8
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
youtube_<channel>_display_name- Le nom de la chaîne.
youtube_<channel>_is_live- Indique si la chaîne est en direct.
youtube_<channel>_stream_title- Le titre de la diffusion en direct.
youtube_<channel>_viewer_count- Les spectateurs actuels. Vide si vous masquez le nombre de spectateurs.
youtube_<channel>_like_count- Les « J'aime » de la diffusion en direct.
youtube_<channel>_subscriber_count- Les abonnés de la chaîne, arrondis par YouTube.
youtube_<channel>_uptime_seconds- Depuis combien de temps la diffusion dure, en secondes.
youtube_<channel>_stream_thumbnail_url- La miniature de la diffusion.
Widgets2
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- Chat YouTube
- Affiche le chat en direct de votre diffusion en cours, y compris les Super Chats et les nouveaux membres. Appuyez dessus pour modérer dans une fenêtre plus grande.
- Statistiques de direct YouTube
- Affiche votre état en direct, les spectateurs, « J'aime » et abonnés, le titre et la durée du direct, dans le style de votre choix.
Questions fréquentes
Pourquoi ai-je besoin de mon propre projet Google Cloud ?
YouTube ne propose pas de connexion partagée que Macro Deck pourrait utiliser pour tout le monde. Avec votre propre projet, le quota et les autorisations n'appartiennent qu'à vous. Le projet est gratuit.
Pourquoi dois-je me reconnecter chaque semaine ?
Tant que l'écran de consentement de votre projet est en test, Google met fin à la connexion après 7 jours. Intégrations indique alors que la connexion a expiré ; reconnectez-vous avec le même ID client et le même code secret. Pour rester connecté, publiez l'écran de consentement dans la console Google Cloud.
Que se passe-t-il quand le quota est épuisé ?
Macro Deck met en pause les mises à jour de l'état du direct et du chat, et la page YouTube sous Intégrations affiche Quota YouTube épuisé. Google réinitialise le quota à minuit, heure du Pacifique, et les mises à jour reprennent alors. Les actions continuent de fonctionner jusqu'à ce que Google les refuse.
Pourquoi l'action Passer en direct ne lance-t-elle pas mon stream ?
Passer en direct lance la prochaine diffusion programmée dont le flux arrive déjà chez YouTube : lancez donc d'abord votre logiciel de streaming. Les diffusions qui démarrent d'elles-mêmes, et Diffuser maintenant dans YouTube Studio, sont lancées par YouTube et non par cette action.
Puis-je débannir quelqu'un depuis le widget de chat ?
Uniquement les bannissements faits via Macro Deck pendant la diffusion en cours, jusqu'au redémarrage de Macro Deck. YouTube n'indique pas à Macro Deck quels bannissements existent : levez donc les autres bannissements dans YouTube Studio.
Où mes identifiants sont-ils stockés ?
Le code secret du client et les jetons sont stockés chiffrés sur l'ordinateur qui exécute Macro Deck et ne sont envoyés qu'à Google.
Plus dans Streaming
OBS Studio
Incluse avec Macro DeckChangez de scène, pilotez votre stream, vos enregistrements et l'audio, et réagissez à ce qui se passe dans OBS Studio.
Meld Studio
Incluse avec Macro DeckChangez et préparez des scènes, pilotez calques, effets et pistes audio, et passez en direct dans Meld Studio.
Streamlabs Desktop
Incluse avec Macro DeckChangez de scène, pilotez votre stream, vos enregistrements et vos sources audio dans Streamlabs Desktop.
Streamer.bot
Incluse avec Macro DeckExécutez des actions Streamer.bot, envoyez des messages de chat et réagissez à chaque événement signalé par Streamer.bot.
Twitch
Incluse avec Macro DeckAffichez votre chat et vos statistiques Twitch, modérez, lancez sondages et publicités, et réagissez aux follows, abonnements et raids.