Twitch
커뮤니티의 Twitch 스트리머가 방송을 시작하면 알립니다. 사용자 지정 메시지, 게임 필터, 방송 중 역할 부여를 선택적으로 사용할 수 있습니다.
주요 기능
방송 시작 알림
Nox는 구독한 Twitch 채널을 확인하고 스트리머의 방송 시작을 감지하면 선택한 채널에 알림을 게시합니다.
사용자 지정 알림 메시지
기본 임베드를 사용하거나, 스트리머 이름·제목·게임·링크가 자동으로 채워지는 임베드와 멘션 문구를 직접 작성할 수 있습니다.
게임 필터
알림 대상을 특정 게임으로 제한하여 관심 있는 카테고리에서 방송할 때만 알리도록 합니다.
방송 중 역할 부여
스트리머가 방송 중이고 알림이 게시될 때 멤버에게 역할을 선택적으로 부여하여 현재 방송 중인 사람을 커뮤니티가 알아볼 수 있게 합니다.
추천 용도
커뮤니티 스트리머와 파트너의 방송 시작을 알리는 경우.
알아보기 쉬운 커뮤니티 스타일의 게시물로 Discord 시청자를 Twitch로 안내하는 경우.
구독별 게임 필터로 주제에 맞는 방송만 소개하는 경우.
작동 방식
채널 구독
설정 → Twitch에서 Twitch 채널을 추가하고 알림을 게시할 Discord 채널을 선택합니다. 구독은 서로 독립적이므로 여러 서버와 채널이 같은 스트리머를 각자의 방식으로 구독할 수 있습니다.
Nox가 방송 상태 확인
Nox는 백그라운드에서 짧은 간격으로 구독 채널을 확인하여 방송 시작을 감지합니다. 화면을 열어 두거나 별도 프로그램을 실행할 필요가 없습니다.
알림 게시
방송이 시작되면 Nox는 기본 임베드 또는 사용자 지정 메시지를 게시하고, 설정된 경우 방송 중 역할을 부여합니다. 각 방송은 구독마다 최대 한 번만 알립니다.
방송 종료
스트리머가 오프라인이 되면 Nox는 기존 알림을 종료 상태로 편집합니다. 임베드를 회색으로 바꾸고 방송 시작 멘션을 제거하므로 오래된 실시간 알림 대신 깔끔한 기록이 남습니다.
사용자 지정 메시지에는 방송 시작 때마다 채워지는 다음 변수를 사용할 수 있습니다.
| 변수 | 표시되는 내용 |
|---|---|
| {{streamerName}} | 스트리머의 Twitch 표시 이름. |
| {{streamTitle}} | 현재 방송 제목. |
| {{streamGame}} | 방송 중인 게임 또는 카테고리. |
| {{streamUrl}} | 스트리머의 Twitch 채널 링크. |
{{ streamUrl }}은 멘션 문구, 임베드 설명, 제목, 필드 값 같은 텍스트 안에서 작동합니다. 실제 URL만 허용하는 임베드 전용 링크 필드에는 사용할 수 없습니다.
설정 체크리스트
설정 → Twitch에서 Twitch 채널을 추가하고 알림 채널을 선택하세요.
Nox가 해당 채널에 게시할 수 있는지 확인하세요. 채널 보기, 메시지 보내기, 링크 임베드 권한이 필요합니다.
기본 임베드를 유지할지 사용자 지정 메시지를 켤지 정하세요.
필요하면 게임 필터를 설정하고 방송 중 역할과 부여할 멤버를 선택하세요.
중요 사항
방송은 구독마다 한 번 알립니다. 이미 방송 중인 스트리머를 구독하면 현재 방송은 과거 알림을 다시 보내는 대신 다음 확인 때 감지됩니다.
사용자 지정 메시지에는 멘션 문구, 임베드 또는 둘 다 있어야 합니다. 스트리머가 카테고리를 지정하지 않아 게임 변수가 비는 경우처럼 빈 필드는 자동 제거되어 빈 값 때문에 게시가 실패하지 않습니다.
게임 필터는 방송 카테고리와 비교합니다. 방송 도중 해당 게임으로 변경하면 변경 순간이 아니라 이후 확인 때 알림이 발생합니다.
채널이 삭제되거나 Nox가 접근 권한을 잃어 영구적으로 전송할 수 없으면 구독을 비활성화하고 관리자가 수정할 수 있도록 오류 페이지에 기록합니다.
문제 해결
방송이 시작되어도 알림이 없음
구독과 알림이 켜져 있고 채널이 선택되어 있는지 확인하세요. Nox가 그 채널을 보고 게시할 수 있는지도 확인하세요. 새 방송은 즉시가 아니라 다음 백그라운드 확인 때 감지됩니다.
알림이 게시되었지만 임베드가 없음
사용자 지정 메시지의 모든 변수 필드가 비어 있으면, 예를 들어 제목과 게임이 없으면 일반 텍스트로 게시됩니다. 항상 임베드를 표시하려면 고정 텍스트나 다른 변수를 추가하세요.
방송 중 역할이 부여되지 않음
역할 부여가 실패해도 알림은 전송됩니다. 역할이 Nox의 가장 높은 역할보다 아래에 있고 역할 관리 권한이 있는지 확인하세요. 실패는 조용히 재시도하는 대신 오류 페이지에 기록됩니다.
구독이 스스로 비활성화됨
대개 채널 삭제나 접근 권한 상실로 인한 영구 전송 실패 후 발생합니다. 채널이나 권한을 수정한 뒤 설정에서 구독을 다시 켜세요.
권한
이 기능에 필요한 Discord 권한과 각 권한의 용도를 설명합니다.
서버에 이 기능들을 추가하세요
Discord에 Nox를 추가한 다음 대시보드에서 서버를 설정하세요. 승인하기 전에 권한을 확인하세요.