Discord

Discord 연동은 Macro Deck을 같은 컴퓨터에 있는 공식 Discord 데스크톱 앱에 연결합니다. Discord가 클라이언트를 제어하는 앱에 제공하는 로컬 RPC 인터페이스를 사용하므로, 버튼은 Discord에서 직접 클릭한 것처럼 동작합니다. Discord는 직접 소유한 애플리케이션에만 이 접근 권한을 주기 때문에, 설정 과정에서 Discord Developer Portal에 무료 애플리케이션을 만들고 한 번 인증해야 합니다.

할 수 있는 일

• 마이크 음소거와 스피커 끄기로 내 마이크를 음소거하거나 스피커를 끕니다. Discord에서 직접 음소거해도 버튼에 음소거 여부가 표시됩니다.
• 내 서버의 음성 채널에 참여하거나, 현재 채널에서 나가거나, Discord 앱에서 텍스트 채널을 엽니다.
• 마이크와 출력 볼륨을 설정하거나 높이거나 낮추고, 푸시 투 토크와 음성 감지 사이를 전환하고, 표준 노이즈 억제, 에코 캔슬레이션, 자동 게인 제어를 켜거나 끕니다.
• Rich Presence 설정으로 프로필에 사용자 지정 활동을 표시하고 Rich Presence 지우기로 다시 제거합니다.
• 웹후크 실행으로 웹후크를 통해 어떤 채널에든 메시지를 게시하며, 임베드를 넣을 수도 있습니다. 이 액션은 연동이 켜져 있기만 하면 연동을 설정하지 않아도 동작합니다.

활용 예:

• 토글 모드의 마이크 음소거가 들어 있고, 색이 discord_is_self_muted 변수를 따르는 마이크 버튼.
• 팀의 음성 채널에 참여하면서 이미 연결되어 있어도 나를 이동을 켜 두어, 다른 채널에 있을 때도 동작하는 버튼.
• 마이크 비활성화됨 트리거에서 빨간 조명을 켜고, 마이크 활성화됨에서 다시 끄는 흐름.
• 웹후크를 통해 채널 링크와 함께 "Stream is live"를 게시하는 버튼.

동작 방식

Macro Deck은 시작할 때 Discord에 연결하며, Discord를 닫았다가 다시 열면 스스로 다시 연결합니다. 시도가 실패할 때마다 조금씩 더 오래, 최대 1분까지 기다립니다. 이때 연결됨 및 연결 끊김 트리거가 실행됩니다. Discord가 연결되어 있지 않은 동안에는 discord_is_connected를 제외한 변수가 사용할 수 없음으로 표시됩니다. Discord에서 바꾼 내용과 관리자가 한 음소거는 변수와 트리거에 바로 반영됩니다. Discord 계정은 하나만 설정할 수 있습니다.