Macro Deck Companion
Macro Deck에 포함Companion 앱을 실행하는 스마트폰과 태블릿의 밝기, 화면 회전, 화면, 스크린샷을 제어하세요.
필드가 없는 Macro Deck Companion 연동의 기기 연결 대화 상자
- 기기의 화면 밝기와 방향 설정
- Android에서 화면 켜기와 끄기
- 덱의 스크린샷을 컴퓨터에 PNG 파일로 저장
- 각 기기의 배터리, 네트워크, 메모리를 변수로 제공
- 기기가 연결되면 실행되는 기기 준비됨 트리거
Macro Deck Companion 연동은 Macro Deck을 Android, iPhone, iPad용 Macro Deck Companion 앱을 실행하는 스마트폰과 태블릿에 연결합니다. 연결되는 기기마다 고유한 구성이 생기므로, 다른 모든 기기와 별도로 특정 태블릿 하나에 명령을 보내고 그 기기가 보고하는 내용을 읽을 수 있습니다.
설정할 때 입력할 것은 없습니다. 기기에서 Companion 앱을 열고 컴퓨터에 연결하세요. 그러면 기기가 자체 이름으로 연동에 자동으로 나타납니다.
할 수 있는 일
액션은 한 번에 기기 하나에서 동작합니다. 각 액션의 기기 필드에서 기기를 고릅니다.
- 화면 밝기 설정과 방향 설정(자동, 세로, 가로)은 Android, iPhone, iPad에서 동작합니다.
- 진동은 Android와 iPhone에서 동작합니다.
- 스크린샷 찍기는 덱을, Android에서는 전체 화면을 캡처해 컴퓨터의 폴더에 PNG 파일로 저장합니다.
- 화면 켜기, 화면 끄기, 앞으로 가져오기는 앱 설정의 기기 제어에서 허용하면 Android에서 동작합니다.
각 기기는 상태도 변수로 보고합니다. 배터리 잔량, 충전 여부, 방향, 화면 밝기, 모델, 플랫폼, 앱 버전, Macro Deck이 맨 앞에 있는지 여부, 네트워크 유형과 이름, CPU 및 메모리 사용률입니다. 다른 변수처럼 라벨, 조건, 자동화에서 사용하세요.
활용 예
- 덱 전용으로만 쓰는 태블릿: Macro Deck이 종료되면 서버 중지됨 자동화가 화면 끄기를 실행하고, 태블릿이 다시 연결되면 기기 준비됨 자동화가 화면 켜기를 실행합니다.
- 시스템 연동의
system_locked변수에 대한 변수 변경됨 자동화 두 개로, 컴퓨터를 잠그면 태블릿 화면을 끄고 잠금을 풀면 다시 켭니다. - 22:00의 일정 이벤트가 화면 밝기 설정을 20 %로 실행하고, 08:00의 다른 이벤트가 다시 원래대로 설정합니다.
- 스마트폰 덱의 라벨에 벽에 걸린 태블릿의
companion_<configuration>_battery_level_percent를 표시해 충전할 때를 알 수 있습니다. - 스크린샷 찍기 버튼이 덱을 PNG 파일로 저장하고, 저장 경로를 변수에 저장이 다음 액션을 위해 파일 경로를 변수에 넣습니다.
액션을 실행하려면 기기가 연결되어 있어야 합니다. 기기가 방금 연결되었다면 액션은 기기가 준비될 때까지 몇 초 기다립니다. 기기가 연결되어 있지 않으면 false가 되는 companion_<configuration>_is_connected를 제외한 변수가 사용할 수 없음으로 표시됩니다.
준비물
- 컴퓨터의 Macro Deck 3
- Android 6 이상 또는 iOS 및 iPadOS 15 이상의 Macro Deck Companion 앱
- Companion 앱 라이선스 또는 7일 무료 체험
- 컴퓨터와 같은 네트워크에 있거나 USB로 연결된 기기
- Android에서 화면 켜기와 끄기, 앞으로 가져오기를 하려면 앱의 기기 제어에 있는 권한
설정하기
1단계: Companion 앱 설치
스마트폰이나 태블릿에 Google Play 또는 App Store에서 Macro Deck Companion을 설치하세요. 7일 무료 체험을 시작하거나 라이선스를 구매하세요.
2단계: 기기를 Macro Deck에 연결
컴퓨터의 Macro Deck에서 오른쪽 위의 네트워크 아이콘으로 네트워크 패널을 여세요. 앱에서 연결 추가(iPhone과 iPad에서는 +)를 탭하고 QR 코드 스캔을 선택한 다음 패널의 코드를 스캔하세요. 이 네트워크에서 찾음에서 컴퓨터를 고르거나 주소를 직접 입력할 수도 있습니다.
3단계: 연동에서 기기 찾기
사이드바에서 연동을 클릭한 다음 Macro Deck Companion을 클릭하세요. 기기가 연결되면 개요 탭의 구성 아래에 이름과 함께 자동으로 나타나며, 오른쪽 위의 스위치가 켜집니다. 이전에 연동을 껐다면 스위치를 다시 켜세요. 구성 추가를 누르면 기기 연결 대화 상자가 열리는데, 필드는 없고 이 내용만 설명합니다. 이름 바꾸기로 Macro Deck이 기기에 사용하는 이름을 바꿀 수 있습니다.
4단계: Android에서 기기 제어 허용
화면을 켜고 끄거나 덱을 앞으로 가져오려면 Android 기기의 앱 설정을 열고 기기 제어 아래의 권한을 켜세요. 화면 켜기에는 백그라운드 연결과 다른 앱 위에 표시도 필요합니다. 그래야 화면이 꺼져 있는 동안에도 기기가 연결된 상태로 유지됩니다.
5단계: 버튼에 Companion 액션 추가
덱 페이지에서 덱의 잠금이 해제되어 있는지 확인하고(오른쪽 위 버튼에 잠금이라고 표시됨) 버튼을 클릭하세요. 짧게 누르기가 선택된 상태로 편집기가 열립니다. + 액션 추가를 클릭하고 액션 추가 대화 상자 왼쪽에서 Macro Deck Companion을 선택한 다음 액션을 고르세요(예: 화면 밝기 설정). 기기에서 기기를 고르고 값을 설정하세요.
6단계: 버튼 누르기
저장을 클릭하고 아무 덱에서나 버튼을 누르세요. 기기가 Macro Deck에 연결되어 있는 동안 명령을 실행합니다.
액션7
버튼에 넣거나 흐름에서 실행하세요.
- 화면 밝기 설정
- Companion 기기의 화면 밝기를 0~100 %로 설정합니다.
- 방향 설정
- Companion 기기를 세로나 가로로 고정하거나 자동으로 회전하게 합니다.
- 진동
- Companion 기기를 잠깐 진동시킵니다(Android 및 iPhone).
- 화면 켜기
- Companion 기기의 화면을 켜고 이 Macro Deck을 표시합니다(Android).
- 화면 끄기
- Companion 기기의 화면을 끕니다(Android).
- 앞으로 가져오기
- Companion 기기에서 이 Macro Deck의 덱을 맨 앞에 표시합니다(Android).
- 스크린샷 찍기
- 기기의 덱 또는 Android에서는 전체 화면을 캡처해 컴퓨터의 폴더에 PNG 파일로 저장합니다.
트리거1
버튼이나 흐름이 이 이벤트에 반응할 수 있습니다.
- 기기 준비됨
- Companion 앱이 연결되어 Companion 액션을 실행할 수 있게 되면 실행됩니다. 특정 기기로 한정할 수도 있습니다.
변수15
버튼과 위젯에 이 값을 표시하거나 조건에 사용하세요.
companion_<configuration>_is_connected- 기기가 지금 연결되어 있는지 여부입니다.
companion_<configuration>_battery_level_percent- 배터리 충전량(퍼센트)입니다.
companion_<configuration>_charging- 기기가 충전 중인지 여부입니다.
companion_<configuration>_orientation- 기기가 세로 방향인지 가로 방향인지 나타냅니다.
companion_<configuration>_screen_brightness_percent- 화면 밝기(퍼센트)입니다.
companion_<configuration>_model- 기기 모델입니다.
companion_<configuration>_platform- 운영 체제와 그 버전입니다(예:
Android 14). companion_<configuration>_app_version- Companion 앱의 버전입니다.
companion_<configuration>_in_focus- 기기에서 Macro Deck이 맨 앞에 있는지 여부입니다.
companion_<configuration>_network_type- 네트워크 유형입니다: Wi-Fi, 셀룰러, 이더넷, VPN 또는 없음.
companion_<configuration>_network_metered- 데이터 통신량이 제한된 네트워크인지 여부입니다.
companion_<configuration>_network_validated- 네트워크가 인터넷에 연결되는지 여부입니다.
companion_<configuration>_network_name- Wi-Fi 네트워크의 이름입니다(Android에서는 Wi-Fi 이름 권한이 있을 때).
companion_<configuration>_cpu_usage_percent- CPU 사용률(퍼센트)입니다(iOS).
companion_<configuration>_memory_used_percent- 사용 중인 메모리(퍼센트)입니다.
자주 묻는 질문
스마트폰에서 Macro Deck을 쓰려면 Companion 앱이 필요한가요?
아니요. 최신 브라우저가 있는 기기라면 무료 웹 클라이언트를 사용할 수 있습니다. 이 연동의 액션과 변수에는 Companion 앱이 필요합니다. 브라우저는 기기 자체를 제어할 수 없기 때문입니다.
화면 켜기나 화면 끄기가 실패하는 이유는 무엇인가요?
이 액션은 Android에서만, 그리고 앱 설정의 기기 제어에 있는 권한이 있을 때만 동작합니다. 화면 켜기에는 백그라운드 연결과 다른 앱 위에 표시도 필요합니다. 그래야 화면이 꺼져 있는 동안에도 기기가 연결된 상태로 유지됩니다. iPhone과 iPad에서는 앱이 화면을 켜거나 끌 수 없습니다.
기기가 연결되어 있지 않으면 어떻게 되나요?
그 기기에 대한 액션은 Companion 기기가 연결되어 있지 않습니다. 메시지와 함께 실패합니다. 변수는 사용할 수 없음으로 표시되고 companion_<configuration>_is_connected는 false가 됩니다. 기기가 다시 연결되면 기기 준비됨이 실행되고 변수가 업데이트됩니다.
여러 스마트폰과 태블릿을 사용할 수 있나요?
네. 연결되는 기기마다 고유한 변수를 가진 고유한 구성이 생깁니다. 각 액션의 기기에서 기기를 고르세요.
스크린샷은 어디에 저장되나요?
Macro Deck이 실행 중인 컴퓨터에서, 액션에서 고른 폴더에 companion-screenshot-<date>-<time>.png로 저장됩니다. 덱의 스크린샷을 찍으려면 기기 화면에 덱이 표시되어 있어야 합니다. 전체 화면 스크린샷은 Android에서만, 기기에서 허용한 뒤에 동작합니다.
플러그인도 Companion 기기를 사용할 수 있나요?
설정 > 컴패니언 앱의 플러그인 접근에서 플러그인의 Companion 기기 사용 허용이 켜져 있는 동안에만 가능합니다. 직접 켜기 전까지는 꺼져 있습니다. 이 설정은 이 연동 자체의 액션, 변수, 트리거에는 영향을 주지 않습니다.
Macro Deck의 다른 연동
Macro Deck Delegate
Macro Deck에 포함Macro Deck이 실행 중인 다른 PC에서 스크립트를 실행하고 그 PC가 공유하는 변수를 사용하세요.
스크립트
Macro Deck에 포함여러 액션을 스크립트로 한 번 만들어 두고 어떤 버튼, 자동화, 다른 스크립트에서든 실행하세요.
변수
Macro Deck에 포함버튼과 자동화에서 변수를 바꾸고, 어떤 변수든 파일에 쓰세요.