Macro Deck Companion
Incluse avec Macro DeckPilotez les téléphones et tablettes qui utilisent l'application Companion : luminosité, rotation, écran et captures d'écran.
La boîte de dialogue Connecte un appareil de l'intégration Macro Deck Companion, qui n'a aucun champ
- Réglez la luminosité de l'écran et l'orientation d'un appareil
- Allumez et éteignez l'écran sous Android
- Enregistrez des captures d'écran du deck en fichiers PNG sur votre ordinateur
- La batterie, le réseau et la mémoire de chaque appareil sous forme de variables
- Déclencheur Appareil prêt quand un appareil se connecte
L'intégration Macro Deck Companion relie Macro Deck aux téléphones et tablettes qui utilisent l'application Macro Deck Companion pour Android, iPhone et iPad. Chaque appareil qui se connecte reçoit sa propre configuration : vous pouvez ainsi envoyer des commandes à une tablette précise et lire ce qu'elle signale, à côté de tous vos autres appareils.
Il n'y a rien à saisir pour la configurer. Ouvrez l'application Companion sur l'appareil et connectez-la à votre ordinateur. L'appareil apparaît alors tout seul dans l'intégration, sous son propre nom.
Ce que vous pouvez faire
Les actions agissent sur un appareil à la fois. Vous choisissez l'appareil dans le champ Appareil de chaque action :
- Définir la luminosité de l'écran et Définir l'orientation (automatique, portrait ou paysage) fonctionnent sous Android, sur iPhone et sur iPad.
- Vibrer fonctionne sous Android et sur iPhone.
- Prendre une capture d'écran capture le deck, ou sous Android l'écran entier, et l'enregistre en fichier PNG dans un dossier de votre ordinateur.
- Allumer l'écran, Éteindre l'écran et Mettre au premier plan fonctionnent sous Android, une fois que vous les avez autorisées sous Contrôle de l'appareil dans les réglages de l'application.
Chaque appareil signale aussi son état sous forme de variables : niveau de batterie, charge, orientation, luminosité de l'écran, modèle, plateforme, version de l'application, présence de Macro Deck au premier plan, type et nom du réseau, et utilisation du processeur et de la mémoire. Utilisez-les dans des libellés, des conditions et des automatisations comme n'importe quelle autre variable.
Exemples de configuration
- Une tablette qui sert uniquement de deck : une automatisation sur Serveur arrêté exécute Éteindre l'écran quand Macro Deck se ferme, et une automatisation sur Appareil prêt exécute Allumer l'écran quand la tablette est de retour.
- Deux automatisations sur Variable changée pour la variable
system_lockedde l'intégration Système éteignent l'écran de la tablette quand vous verrouillez l'ordinateur et le rallument quand vous le déverrouillez. - Un événement Planification à 22:00 exécute Définir la luminosité de l'écran à 20 %, un autre à 08:00 la rétablit.
- Un libellé sur le deck de votre téléphone affiche
companion_<configuration>_battery_level_percentde la tablette fixée au mur, pour savoir quand la recharger. - Un bouton avec Prendre une capture d'écran enregistre le deck en fichier PNG, et Enregistrer le chemin dans une variable place le chemin du fichier dans une variable pour l'action suivante.
Une action nécessite que l'appareil soit connecté. S'il vient de se connecter, l'action attend quelques secondes qu'il soit prêt. Quand un appareil n'est pas connecté, ses variables apparaissent comme indisponibles, sauf companion_<configuration>_is_connected, qui vaut false.
Ce qu'il vous faut
- Macro Deck 3 sur votre ordinateur
- L'application Macro Deck Companion sous Android 6 ou plus récent, ou iOS et iPadOS 15 ou plus récent
- Une licence de l'application Companion ou l'essai gratuit de 7 jours
- L'appareil sur le même réseau que l'ordinateur, ou connecté en USB
- Sous Android, les autorisations sous Contrôle de l'appareil dans l'application pour allumer et éteindre l'écran et pour Mettre au premier plan
Configuration
Étape 1: Installez l'application Companion
Installez Macro Deck Companion depuis Google Play ou l'App Store sur votre téléphone ou votre tablette. Lancez l'essai gratuit de 7 jours ou achetez la licence.
Étape 2: Connectez l'appareil à Macro Deck
Dans Macro Deck sur l'ordinateur, ouvrez le panneau réseau avec l'icône réseau en haut à droite. Dans l'application, touchez Ajouter une connexion (sur iPhone et iPad, +), choisissez Scanner le code QR et scannez le code affiché dans le panneau. Vous pouvez aussi choisir l'ordinateur sous Trouvés sur ce réseau ou saisir son adresse.
Étape 3: Retrouvez l'appareil dans l'intégration
Dans la barre latérale, cliquez sur Intégrations, puis sur Macro Deck Companion. Une fois qu'un appareil s'est connecté, il apparaît tout seul sous Configuration dans l'onglet Aperçu, avec son nom, et l'interrupteur en haut à droite est activé. Si vous aviez désactivé l'intégration, réactivez l'interrupteur. Ajouter une configuration ouvre la boîte de dialogue Connecte un appareil, qui n'a aucun champ et explique seulement ce fonctionnement. Renommer modifie le nom que Macro Deck utilise pour un appareil.
Étape 4: Autorisez le contrôle de l'appareil sous Android
Pour allumer et éteindre l'écran ou mettre le deck au premier plan, ouvrez les réglages de l'application sur l'appareil Android et activez les autorisations sous Contrôle de l'appareil. Allumer l'écran nécessite aussi Connexion en arrière-plan et Affichage par-dessus les autres apps, pour que l'appareil reste connecté quand son écran est éteint.
Étape 5: Ajoutez une action Companion à un bouton
Sur la page Deck, vérifiez que le deck est déverrouillé (le bouton en haut à droite indique Verrouiller) et cliquez sur un bouton. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, choisissez Macro Deck Companion à gauche de la boîte de dialogue Ajouter une action et sélectionnez une action, par exemple Définir la luminosité de l'écran. Choisissez l'appareil sous Appareil et réglez la valeur.
Étape 6: Appuyez sur le bouton
Cliquez sur Enregistrer et appuyez sur le bouton depuis n'importe lequel de vos decks. L'appareil exécute la commande tant qu'il est connecté à Macro Deck.
Actions7
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Définir la luminosité de l'écran
- Règle la luminosité de l'écran d'un appareil Companion, de 0 à 100 %.
- Définir l'orientation
- Bloque un appareil Companion en portrait ou en paysage, ou le laisse pivoter automatiquement.
- Vibrer
- Fait vibrer brièvement un appareil Companion (Android et iPhone).
- Allumer l'écran
- Allume l'écran d'un appareil Companion et affiche ce Macro Deck (Android).
- Éteindre l'écran
- Éteint l'écran d'un appareil Companion (Android).
- Mettre au premier plan
- Affiche au premier plan le deck de ce Macro Deck sur un appareil Companion (Android).
- Prendre une capture d'écran
- Capture le deck ou, sous Android, l'écran entier d'un appareil et l'enregistre en fichier PNG dans un dossier de votre ordinateur.
Déclencheurs1
Un bouton ou un flux peut réagir à ces événements.
- Appareil prêt
- S'exécute quand une application Companion s'est connectée et peut exécuter des actions Companion, éventuellement pour un seul appareil.
Variables15
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
companion_<configuration>_is_connected- Indique si l'appareil est connecté en ce moment.
companion_<configuration>_battery_level_percent- La charge de la batterie en pourcentage.
companion_<configuration>_charging- Indique si l'appareil est en charge.
companion_<configuration>_orientation- Indique si l'appareil est en portrait ou en paysage.
companion_<configuration>_screen_brightness_percent- La luminosité de l'écran en pourcentage.
companion_<configuration>_model- Le modèle de l'appareil.
companion_<configuration>_platform- Le système d'exploitation et sa version, par exemple
Android 14. companion_<configuration>_app_version- La version de l'application Companion.
companion_<configuration>_in_focus- Indique si Macro Deck est au premier plan sur l'appareil.
companion_<configuration>_network_type- Le type de réseau : Wi-Fi, cellulaire, Ethernet, VPN ou aucun.
companion_<configuration>_network_metered- Indique si le réseau est limité.
companion_<configuration>_network_validated- Indique si le réseau a accès à Internet.
companion_<configuration>_network_name- Le nom du réseau Wi-Fi, sous Android avec l'autorisation d'accès au nom du Wi-Fi.
companion_<configuration>_cpu_usage_percent- L'utilisation du processeur en pourcentage, sous iOS.
companion_<configuration>_memory_used_percent- La mémoire utilisée en pourcentage.
Questions fréquentes
Ai-je besoin de l'application Companion pour utiliser Macro Deck sur un téléphone ?
Non. Tout appareil doté d'un navigateur récent peut utiliser le client web gratuit. Les actions et variables de cette intégration nécessitent l'application Companion, car un navigateur ne peut pas piloter l'appareil lui-même.
Pourquoi les actions Allumer l'écran ou Éteindre l'écran échouent-elles ?
Ces actions ne fonctionnent que sous Android, et uniquement avec les autorisations sous Contrôle de l'appareil dans les réglages de l'application. Allumer l'écran nécessite aussi Connexion en arrière-plan et Affichage par-dessus les autres apps, pour que l'appareil reste connecté quand son écran est éteint. Sur iPhone et iPad, une application ne peut pas allumer ni éteindre l'écran.
Que se passe-t-il quand un appareil n'est pas connecté ?
Une action pour cet appareil échoue avec L'appareil Companion n'est pas connecté. Ses variables apparaissent comme indisponibles, et companion_<configuration>_is_connected vaut false. Quand l'appareil se reconnecte, Appareil prêt s'exécute et les variables se mettent à jour.
Puis-je utiliser plusieurs téléphones et tablettes ?
Oui. Chaque appareil qui se connecte reçoit sa propre configuration, avec ses propres variables. Dans chaque action, vous choisissez l'appareil sous Appareil.
Où les captures d'écran sont-elles enregistrées ?
Sur l'ordinateur qui exécute Macro Deck, dans le Dossier choisi dans l'action, sous le nom companion-screenshot-<date>-<time>.png. Une capture du deck nécessite que le deck soit affiché à l'écran de l'appareil. Une capture de l'écran entier ne fonctionne que sous Android, après l'avoir autorisée sur l'appareil.
Des extensions peuvent-elles aussi utiliser mes appareils Companion ?
Uniquement si Autoriser les extensions à utiliser les appareils Companion est activé sous Accès des extensions dans Paramètres > Application Companion. L'option reste désactivée tant que vous ne l'activez pas. Elle n'a aucun effet sur les actions, variables et déclencheur propres à cette intégration.
Plus dans Macro Deck
Macro Deck Delegate
Incluse avec Macro DeckExécutez des scripts sur un autre PC équipé de Macro Deck et utilisez les variables qu'il partage.
Scripts
Incluse avec Macro DeckCréez une fois un ensemble d'actions sous forme de script et exécutez-le depuis n'importe quel bouton, automatisation ou autre script.
Variables
Incluse avec Macro DeckModifiez vos variables depuis des boutons et des automatisations, et écrivez n'importe quelle variable dans un fichier.