OBS Studio

L'intégration OBS Studio relie Macro Deck à OBS via le serveur WebSocket intégré à OBS (obs-websocket 5). Une fois la connexion établie, vos boutons peuvent piloter presque tout ce que vous faites dans OBS pendant un stream, et OBS signale en retour chaque changement, si bien que votre deck affiche toujours l'état actuel.

Ce que vous pouvez faire

• Changer la scène du programme, la scène d'aperçu du mode studio, le profil ou la collection de scènes.
• Démarrer, arrêter ou basculer le direct, l'enregistrement, le tampon de relecture et la caméra virtuelle, enregistrer un replay, mettre un enregistrement en pause, diviser le fichier d'enregistrement ou ajouter un marqueur de chapitre.
• Afficher ou masquer une source dans une scène, activer ou désactiver un filtre, couper une entrée ou modifier son volume en pourcentage ou en dB.
• Modifier un paramètre d'une source, par exemple le texte d'une source texte, le fichier d'une source image ou média, ou l'URL d'une source navigateur.
• Démarrer et arrêter n'importe quelle sortie OBS par son nom, y compris les sorties ajoutées par des plugins.

Quelques exemples de configuration :

• Un bouton BRB qui passe à votre scène BRB et coupe votre microphone.
• Un bouton Enregistrer qui bascule l'enregistrement et indique si OBS enregistre, est en pause ou arrêté.
• Un curseur lié à la variable obs_<input>_volume de votre entrée musique : déplacer le curseur modifie le volume dans OBS.
• Un flux qui s'exécute quand OBS signale Direct démarré et vous envoie une notification.

Fonctionnement

Macro Deck écoute les événements envoyés par OBS, si bien que les variables comme la scène actuelle, les états de sourdine et les états des filtres se mettent à jour en une fraction de seconde après une modification dans OBS. Les boutons à bascule s'allument tant que leur état est actif, même si vous le changez directement dans OBS. Les statistiques comme les FPS, l'utilisation du CPU, le débit et les images perdues sont lues toutes les une ou deux secondes.

En plus des variables fixes, le sélecteur de variables liste chaque entrée, scène, élément de scène et filtre de l'OBS connecté, avec son volume, son état de sourdine, sa visibilité ou son état d'activation. Les déclencheurs réagissent aux changements de scène, aux changements d'enregistrement et de direct, aux replays et captures d'écran enregistrés, aux entrées qui deviennent actives et aux événements personnalisés diffusés par vos propres scripts OBS.

Vous pouvez ajouter plusieurs configurations, par exemple une pour votre PC de streaming et une pour votre PC de jeu. Chaque configuration a ses propres variables, et chaque action possède un champ Configuration pour choisir l'OBS qu'elle pilote. Quand OBS se ferme ou que le réseau tombe, Macro Deck tente de se reconnecter en continu, et les déclencheurs Déconnecté et Connecté s'exécutent.