SinusBot

SinusBot은 직접 운영하는 서버에서 실행하는 TeamSpeak 및 Discord용 음악 봇입니다. SinusBot 연동은 Macro Deck을 SinusBot 웹 인터페이스에 연결하므로, 봇 인스턴스가 재생하는 음악을 제어하고 현재 트랙을 덱에서 볼 수 있습니다. 같은 컴퓨터, 로컬 네트워크, 서버 등 Macro Deck이 네트워크로 접속할 수 있는 SinusBot이라면 모두 동작합니다.

할 수 있는 일

• 재생, 일시 정지, 전환, 다음 또는 이전 트랙으로 건너뛰기, 현재 트랙의 특정 위치로 이동.
• 볼륨 설정, 높이기 또는 낮추기, 셔플 켜기 또는 끄기, 반복 켜기 또는 끄기.
• Play Track으로 봇 라이브러리의 특정 트랙 재생. 트랙을 비워 두면 버튼을 누를 때 고를 수 있습니다.
• Macro Deck의 음악 플레이어 위젯에 재생 중인 트랙, 아티스트, 커버를 표시하고, 변수를 통해 봇의 트랙, 재생 위치, 볼륨을 라벨에 사용.

활용 예:

• TeamSpeak 채널에 있는 봇을 위한 Previous Track, Toggle Play/Pause, Next Track 버튼 한 줄. 재생 버튼은 봇이 재생 중인지 보여 줍니다.
• 봇의 볼륨 변수 sinusbot_<instance>_volume에 연결한 슬라이더. 말하는 동안 음악 소리를 줄일 수 있습니다.
• 봇마다 하나씩 둔 음악 플레이어 위젯과, 그 옆에 music_player_<player>_album_color 변수를 통해 커버 색을 따라가는 버튼.

여러 봇과 동작 방식

제어하려는 SinusBot 인스턴스 하나가 구성 하나입니다. 서로 다른 서버의 인스턴스를 포함해 원하는 만큼 추가할 수 있으며, 각 액션의 Player 필드에서 인스턴스를 고릅니다. Player를 비워 두면 액션은 첫 번째 인스턴스를 제어합니다. 각 구성은 sinusbot_<instance>_volume처럼 구성 이름을 딴 고유한 변수 세트를 가집니다.

Macro Deck은 구성을 설정할 때 연결을 확인하고 봇이 가진 인스턴스를 불러옵니다. 실행 중에는 재생 상태를 주기적으로 읽습니다. 봇에 잠깐 접속할 수 없으면 덱은 마지막 트랙을 계속 표시합니다. 계속 접속할 수 없으면 sinusbot_<instance>_is_connected 변수가 false가 되고, 봇이 다시 응답할 때까지 액션은 아무 동작도 하지 않습니다.