테마
대시보드 화면 둘러보기
대시보드는 화면 하나에 네 덩어리가 붙어 있어요. 왼쪽 사이드바, 위쪽 헤더, 가운데 본문, 아래 플레이어입니다. 이 페이지는 각 덩어리에 무엇이 있고 어떤 버튼이 실제로 동작하는지를 훑어봅니다. 개별 기능은 대기열 · 플레이리스트 · 가사와 기록 문서에 따로 있어요.
왼쪽 사이드바
위에서부터 봇 이름(연희)과 온라인 표시, 연결된 음성 채널 카드, 그리고 이동 메뉴 다섯 개가 있습니다.
연결된 음성 채널 카드
지금 보고 있는 서버와, 그 서버에서 내가 들어가 있는 음성 채널이 표시돼요. 음성 채널에 들어가 있지 않으면 "음성 채널 없음" 이라고 나옵니다. 맨 아래 줄에는 헤드폰 아이콘과 함께 지금 재생 중인 곡 제목이 붙어요.
카드를 누르면 사이드바 안에서 서버 목록이 아래로 펼쳐집니다. 각 줄에는 서버 아이콘과 이름, "내가 접속 중 · 채널명", 그리고 그 서버에서 음성 채널에 들어가 있는 연희 봇들의 이름과 채널이 표시돼요. 줄을 누르면 그 서버로 전환하고, 전환하는 동안에는 "전환 중…" 스피너가 돕니다.
NOTE
헤드폰 옆의 숫자는 실제 인원수가 아니에요. 봇이 연결돼 있으면 1+, 아니면 0 으로만 표시됩니다. 채널에 몇 명이 있는지 세는 값이 아니니 참고만 해 주세요.
이동 메뉴 다섯 개
| 메뉴 | 내용 | 옆의 숫자 |
|---|---|---|
| 지금 재생 | 큰 앨범아트, 곡 정보, 가사, 다음 곡 4곡 | 없음 |
| 탐색 | 미리 준비된 플레이리스트 카드 10개 | 없음 |
| 검색 | 검색 결과 화면 | 없음 |
| 재생 대기열 | 대기열 전체와 순서 편집 | 대기 중인 곡 수 |
| 플레이리스트 | 내 플레이리스트와 유튜브 가져오기 | 플레이리스트 개수 |
기록 과 설정 은 이 목록에 없어요. 오른쪽 위 아바타를 눌러야 나옵니다. 설정은 서버 관리자 권한이 있는 사람에게만 메뉴가 보여요.
위쪽 헤더
왼쪽부터 화살표 두 개, 검색창, 경고 배지, 현재 채널 표시, 내 아바타 순서입니다.
검색창 왼쪽의 좌우 화살표(< >)는 아직 동작하지 않아요. 브라우저 뒤로가기·앞으로가기를 대신 쓰시면 됩니다.
검색창
곡 제목이나 링크를 넣고 Enter 를 누르면 검색 화면으로 이동해요. 바로 재생되지는 않습니다. 결과는 YouTube · Spotify · SoundCloud 세 탭으로 나뉘고, 탭마다 결과 개수가 붙어요. 어떤 곳에서 결과를 못 가져오면 그 탭에 경고 표시가 뜹니다.
결과는 한 번에 20개까지 보이고, 더보기 를 누르면 20개씩 늘어나요. 곡 행을 누르면 대기열에 들어가고 "대기열에 추가했어요" 알림이 뜹니다.
Spotify 탭에서 고른 곡도 실제 재생은 YouTube에서 찾아 틀기 때문에, 라이브·커버·반주 버전이 걸릴 수 있어요. 반주 버전으로 판단되면 곡 제목 옆에 초록색 INST 배지가 붙습니다.
시스템 경고 배지
문제가 있을 때만 주황색 알약이 나타나요. 마우스를 올리거나 키보드 포커스를 주면 내용이 펼쳐집니다.
| 경고 | 뜻 | 할 수 있는 것 |
|---|---|---|
| Discord 연결 불안정 | 봇이 디스코드와 잘 연결되지 않았습니다 | 기다립니다. 조작이 늦게 먹힐 수 있어요 |
| Lavalink 연결 문제 | 음악을 실제로 틀어 주는 쪽에 문제가 있습니다 | 새 곡 재생이 실패해요. 서버 관리자에게 알립니다 |
| 봇 음성 연결 끊김 | 봇이 음성 채널에 붙어 있지 않습니다 | 봇을 다시 부르거나 서버 관리자에게 알립니다 |
| 대시보드 실시간 연결 끊김 | 화면과 봇 사이 연결이 잠깐 끊겼습니다 | 잠시 기다리면 대개 저절로 붙어요 |
마지막 항목이 떠 있는 동안에는 화면 갱신이 느려지고, 일부 조작(특히 프리미엄 서버의 대기열 편집)이 막힐 수 있어요. 자세한 건 대시보드에서 대기열 다루기를 보세요.
현재 채널 표시와 아바타 메뉴
경고 배지 오른쪽에는 지금 들어가 있는 음성 채널 이름이 알약으로 붙고, 재생 중이면 옆의 막대가 움직여요.
아바타를 누르면 메뉴가 열립니다.
- 이름과, DJ 역할이 있으면 왕관과 함께 DJ 권한 표시
- 기록 — 최근에 들은 곡과 내가 추가한 곡
- 설정 — 서버 관리자에게만 보입니다
- 로그아웃
메뉴 바깥을 클릭하면 닫혀요.
가운데 본문
선택한 메뉴에 따라 내용이 바뀝니다. 여기서는 화면별 특징만 짧게 정리할게요.
지금 재생
큰 앨범아트가 왼쪽에 있고, 아트워크에서 뽑은 색이 뒤로 은은하게 번져요. 오른쪽에는 상태 표시 (지금 재생 중 / 일시정지 / 대기 중), 곡 제목, 아티스트, 앨범과 연도, 그리고 이 곡을 신청한 사람의 아바타와 이름이 나옵니다.
그 아래가 가사 패널, 다시 그 아래가 다음 곡 4곡 미리보기예요. 오른쪽 위 "대기열 전체보기" 로 대기열 화면에 갑니다.
CAUTION
"다음 곡" 목록에서 곡 제목을 누르면 그 곡으로 곧바로 건너뜁니다. 미리듣기가 아니에요. 게다가 그 앞에 있던 곡들은 대기열에서 사라지고 되돌릴 수 없습니다. 순서만 확인할 생각이었다면 제목을 누르지 마세요.
탐색
카드가 두 묶음으로 놓여 있어요. 태그별 플레이리스트 여섯 개(K-pop Mix, J-pop / Anime, Lo-fi Study, City Pop, Gaming BGM, Acoustic Chill)와 인기 목록 네 개(Korea / Japan / English Top 50, SoundCloud Trending)입니다.
카드를 누르면 곡 목록이 열리고, 전체 재생 으로 통째로 담거나 곡을 하나씩 추가할 수 있어요. 목록이 아직 준비되지 않은 상태에서 열면 영문 안내가 잠깐 보일 수 있습니다. 이때는 잠시 뒤에 다시 눌러 주세요.
검색 · 재생 대기열 · 플레이리스트 · 기록
- 검색은 위의 헤더 설명과 같아요.
- 재생 대기열은 대시보드에서 대기열 다루기 참고.
- 플레이리스트는 플레이리스트와 유튜브 재생목록 가져오기 참고.
- 기록은 가사 패널과 기록 화면 참고.
아래쪽 플레이어
화면 맨 아래에 항상 붙어 있는 막대예요. 왼쪽은 지금 곡, 가운데는 조작, 오른쪽은 보조 버튼입니다.
| 위치 | 버튼 | 동작 |
|---|---|---|
| 왼쪽 | 앨범아트와 곡 정보 | 누르면 "지금 재생" 화면으로 이동 |
| 가운데 | 셔플 | 대기열 순서를 섞습니다 |
| 가운데 | 이전 곡 | 직전에 재생한 곡으로 돌아갑니다 |
| 가운데 | 재생 / 일시정지 | 흰 동그라미 버튼. 상태에 따라 모양이 바뀝니다 |
| 가운데 | 다음 곡 | 스킵합니다 |
| 가운데 | 반복 | 누를 때마다 끄기 → 한 곡 → 전체 순서로 바뀝니다 |
| 가운데 | 진행바 | 드래그해서 원하는 지점으로 이동합니다 |
| 오른쪽 | 목록 아이콘 | 대기열 화면으로 이동 |
| 오른쪽 | 정지 | 재생을 멈춥니다 |
| 오른쪽 | 볼륨 슬라이더 | 0~100 사이로 드래그 |
반복이 켜져 있으면 아이콘이 빨간색이 되고, 한 곡 반복일 때는 숫자 1이 붙은 모양으로 바뀌어요.
진행바는 잡고 끌면 시간이 말풍선으로 따라다니고, 손을 떼는 순간 그 지점으로 이동합니다. 볼륨도 같은 방식으로 드래그하며, 손을 뗄 때 적용돼요.
NOTE
곡 정보 오른쪽의 하트 아이콘 과 오른쪽 끝의 방송(안테나) 아이콘 은 아직 동작하지 않습니다. 곡을 저장하고 싶으면 플레이리스트 상세 화면의 현재곡 저장 버튼을 써 주세요.
조작 버튼을 눌렀는데 아무 변화가 없고 화면 아래에 안내 문구만 잠깐 뜬다면, 권한이나 음성 채널 문제예요. 대시보드에서 대기열 다루기의 권한 표를 확인해 보세요.
휴대폰에서 볼 때
화면 폭이 좁아지면 배치가 크게 바뀝니다.
- 사이드바가 아래쪽 탭바로 내려갑니다. 봇 이름과 연결된 음성 채널 카드는 사라져요. 즉 휴대폰에서는 서버를 전환할 수 없습니다. 서버를 바꾸려면 화면을 넓히거나 PC에서 열어 주세요.
- 플레이어가 작은 막대로 바뀝니다. 남는 버튼은 재생·일시정지와 다음 곡 두 개뿐이고, 셔플·이전 곡·반복·정지·볼륨·대기열 바로가기는 숨겨져요.
- 진행바는 미니 플레이어 위쪽에 얇은 띠로 붙습니다. 좁아서 정밀한 이동은 어려워요.
- 하트 아이콘은 아예 숨겨집니다.
NOTE
화면이 좁으면 하단 탭바의 마지막 항목(플레이리스트)이 두 번째 줄로 밀려 찌그러지거나 잘려 보일 수 있어요. 눌리기는 하지만 위치가 어색하다면, 하단 플레이어의 목록 아이콘이나 화면 안의 링크로 이동하시면 됩니다.
화면이 저절로 갱신되는 방식
대시보드는 봇과 계속 이어져 있어서, 곡이 바뀌거나 누가 대기열을 건드리면 새로고침 없이 화면이 바뀌어요. 진행바와 가사의 현재 줄도 재생에 맞춰 저절로 움직입니다.
연결이 끊기면 헤더에 "대시보드 실시간 연결 끊김" 경고가 뜨고, 대개 저절로 다시 붙어요. 기다리는 동안에도 대부분의 버튼은 그대로 동작하니 아주 먹통이 되지는 않습니다.