Macro Deck Companion
Incluída no Macro DeckControle os celulares e tablets que usam o app Companion: brilho, rotação, tela e capturas de tela.
A caixa de diálogo Conectar um dispositivo da integração Macro Deck Companion, que não tem campos
- Defina o brilho da tela e a orientação de um dispositivo
- Ligue e desligue a tela no Android
- Salve capturas de tela do deck como arquivos PNG no computador
- Bateria, rede e memória de cada dispositivo como variáveis
- Gatilho Dispositivo pronto quando um dispositivo se conecta
A integração Macro Deck Companion conecta o Macro Deck aos celulares e tablets que usam o app Macro Deck Companion para Android, iPhone e iPad. Cada dispositivo que se conecta recebe sua própria configuração, então dá para enviar comandos a um tablet específico e ler o que ele informa, junto com todos os outros dispositivos.
Não é preciso informar nada para configurar. Abra o app Companion no dispositivo e conecte-o ao computador. O dispositivo aparece então sozinho na integração, com o próprio nome.
O que dá para fazer
As ações funcionam em um dispositivo por vez. O dispositivo é escolhido no campo Dispositivo de cada ação:
- Definir brilho da tela e Definir orientação (automática, retrato ou paisagem) funcionam no Android, iPhone e iPad.
- Vibrar funciona no Android e no iPhone.
- Capturar tela captura o deck ou, no Android, a tela inteira e salva como arquivo PNG em uma pasta do computador.
- Ligar a tela, Desligar a tela e Trazer para frente funcionam no Android, depois de permitidas em Controle do dispositivo nas configurações do app.
Cada dispositivo também informa seu estado como variáveis: nível da bateria, carregamento, orientação, brilho da tela, modelo, plataforma, versão do app, se o Macro Deck está em primeiro plano, o tipo e o nome da rede e o uso de CPU e de memória. Use-as em rótulos, condições e automações como qualquer outra variável.
Exemplos de uso
- Um tablet que serve só como deck: uma automação em Servidor parado executa Desligar a tela quando o Macro Deck é fechado, e uma automação em Dispositivo pronto executa Ligar a tela quando o tablet volta.
- Duas automações em Variável alterada para a variável
system_lockedda integração Sistema desligam a tela do tablet quando o computador é bloqueado e a ligam de novo quando ele é desbloqueado. - Um evento de Agendamento às 22:00 executa Definir brilho da tela em 20 %, e outro às 08:00 volta a aumentá-lo.
- Um rótulo no deck do celular mostra
companion_<configuration>_battery_level_percentdo tablet na parede, para você ver quando ele precisa ser carregado. - Um botão com Capturar tela salva o deck como arquivo PNG, e Salvar caminho na variável coloca o caminho do arquivo em uma variável para a próxima ação.
Uma ação precisa que o dispositivo esteja conectado. Logo depois de ele se conectar, a ação espera alguns segundos até ele ficar pronto. Quando um dispositivo não está conectado, as variáveis dele ficam indisponíveis, exceto companion_<configuration>_is_connected, que fica false.
O que é necessário
- Macro Deck 3 no computador
- O app Macro Deck Companion no Android 6 ou posterior, ou no iOS e iPadOS 15 ou posterior
- Uma licença do app Companion ou o teste gratuito de 7 dias
- O dispositivo na mesma rede que o computador, ou conectado por USB
- No Android, as permissões em Controle do dispositivo no app para ligar e desligar a tela e para Trazer para frente
Configuração
Passo 1: Instale o app Companion
Instale o Macro Deck Companion pelo Google Play ou pela App Store no celular ou tablet. Comece o teste gratuito de 7 dias ou compre a licença.
Passo 2: Conecte o dispositivo ao Macro Deck
No Macro Deck do computador, abra o painel de rede pelo ícone de rede no canto superior direito. No app, toque em Adicionar conexão (no iPhone e no iPad, +), escolha Escanear QR code e escaneie o código do painel. Também é possível escolher o computador em Encontrados nesta rede ou digitar o endereço dele.
Passo 3: Encontre o dispositivo na integração
Na barra lateral, clique em Integrações e depois em Macro Deck Companion. Depois que um dispositivo se conecta, ele aparece sozinho em Configuração na aba Visão geral, com o próprio nome, e a chave no canto superior direito fica ativada. Se você desativou a integração antes, ative a chave de novo. Adicionar configuração abre a caixa de diálogo Conectar um dispositivo, que não tem campos e só explica isso. Renomear muda o nome que o Macro Deck usa para um dispositivo.
Passo 4: Permita o controle do dispositivo no Android
Para ligar e desligar a tela ou trazer o deck para frente, abra as configurações do app no dispositivo Android e ative as permissões em Controle do dispositivo. Ligar a tela também precisa de Conexão em segundo plano e Sobrepor a outros apps, para que o dispositivo continue conectado com a tela desligada.
Passo 5: Adicione uma ação do Companion a um botão
Na página Deck, confira se o deck está desbloqueado (o botão no canto superior direito mostra Bloquear) e clique em um botão. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, escolha Macro Deck Companion à esquerda da caixa de diálogo Adicionar ação e selecione uma ação, por exemplo Definir brilho da tela. Escolha o dispositivo em Dispositivo e defina o valor.
Passo 6: Pressione o botão
Clique em Salvar e pressione o botão em qualquer um dos seus decks. O dispositivo executa o comando enquanto estiver conectado ao Macro Deck.
Ações7
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Definir brilho da tela
- Define o brilho da tela de um dispositivo Companion, de 0 a 100 %.
- Definir orientação
- Fixa um dispositivo Companion em retrato ou paisagem, ou deixa que ele gire automaticamente.
- Vibrar
- Faz um dispositivo Companion vibrar rapidamente (Android e iPhone).
- Ligar a tela
- Liga a tela de um dispositivo Companion e mostra este Macro Deck (Android).
- Desligar a tela
- Desliga a tela de um dispositivo Companion (Android).
- Trazer para frente
- Mostra o deck deste Macro Deck em primeiro plano em um dispositivo Companion (Android).
- Capturar tela
- Captura o deck ou, no Android, a tela inteira de um dispositivo e salva como arquivo PNG em uma pasta do computador.
Gatilhos1
Um botão ou fluxo pode reagir a estes eventos.
- Dispositivo pronto
- É executado quando um app Companion se conectou e pode executar ações do Companion, opcionalmente só para um dispositivo.
Variáveis15
Mostre estes valores em botões e widgets ou use-os em condições.
companion_<configuration>_is_connected- Se o dispositivo está conectado agora.
companion_<configuration>_battery_level_percent- A carga da bateria em porcentagem.
companion_<configuration>_charging- Se o dispositivo está carregando.
companion_<configuration>_orientation- Se o dispositivo está em retrato ou paisagem.
companion_<configuration>_screen_brightness_percent- O brilho da tela em porcentagem.
companion_<configuration>_model- O modelo do dispositivo.
companion_<configuration>_platform- O sistema operacional e a versão dele, por exemplo
Android 14. companion_<configuration>_app_version- A versão do app Companion.
companion_<configuration>_in_focus- Se o Macro Deck está em primeiro plano no dispositivo.
companion_<configuration>_network_type- O tipo de rede: Wi-Fi, celular, Ethernet, VPN ou nenhuma.
companion_<configuration>_network_metered- Se a rede é tarifada.
companion_<configuration>_network_validated- Se a rede tem acesso à internet.
companion_<configuration>_network_name- O nome da rede Wi-Fi, no Android com a permissão Nome do Wi-Fi.
companion_<configuration>_cpu_usage_percent- O uso da CPU em porcentagem, no iOS.
companion_<configuration>_memory_used_percent- A memória em uso em porcentagem.
Perguntas frequentes
Preciso do app Companion para usar o Macro Deck em um celular?
Não. Qualquer dispositivo com um navegador atual pode usar o cliente web gratuito. As ações e variáveis desta integração precisam do app Companion, porque um navegador não consegue controlar o próprio dispositivo.
Por que Ligar a tela ou Desligar a tela falha?
Essas ações funcionam só no Android, e só com as permissões em Controle do dispositivo nas configurações do app. Ligar a tela também precisa de Conexão em segundo plano e Sobrepor a outros apps, para que o dispositivo continue conectado com a tela desligada. No iPhone e no iPad, um app não pode ligar nem desligar a tela.
O que acontece quando um dispositivo não está conectado?
Uma ação para esse dispositivo falha com O dispositivo Companion não está conectado. As variáveis dele ficam indisponíveis, e companion_<configuration>_is_connected fica false. Quando o dispositivo se conecta de novo, Dispositivo pronto é executado e as variáveis são atualizadas.
Posso usar vários celulares e tablets?
Sim. Cada dispositivo que se conecta recebe sua própria configuração, com variáveis próprias. Em cada ação, o dispositivo é escolhido em Dispositivo.
Onde as capturas de tela são salvas?
No computador em que o Macro Deck está rodando, na Pasta escolhida na ação, como companion-screenshot-<date>-<time>.png. Uma captura do deck precisa que o deck esteja na tela do dispositivo. Uma captura da tela inteira só funciona no Android, depois de permitida no dispositivo.
Plugins também podem usar meus dispositivos Companion?
Só enquanto Permitir que plugins usem dispositivos Companion estiver ativado em Acesso de plugins em Configurações > Aplicativo complementar. A opção fica desativada até você ativá-la. Ela não afeta as ações, variáveis e o gatilho desta integração.
Mais em Macro Deck
Macro Deck Delegate
Incluída no Macro DeckExecute scripts em outro PC com o Macro Deck e use as variáveis que ele compartilha.
Scripts
Incluída no Macro DeckMonte um conjunto de ações uma vez como script e execute-o a partir de qualquer botão, automação ou outro script.
Variáveis
Incluída no Macro DeckAltere as suas variáveis a partir de botões e automações e grave qualquer variável em um arquivo.