챗봇에서 현재 스트림 카테고리를 표시하는 !게임 명령어

봇이 현재 게임 이름을 가져오는 곳

!게임 명령어는 보통 컴퓨터에서 실행 중인 애플리케이션이 아니라 Twitch 채널의 현재 카테고리를 표시합니다. 스트리머가 방송 관리 패널에서 게임이나 카테고리를 변경하면, 봇은 내장 변수나 API 요청을 통해 그 값을 가져옵니다.

Twitch 패널에 이전 게임이 남아 있거나, '대화' 카테고리가 선택되어 있거나, 필드가 비어 있으면 봇도 같은 값을 출력합니다. 챗봇 자체는 화면에 표시된 게임을 인식하지 못합니다: 플랫폼이나 외부 자동화가 전달하는 데이터로 작동합니다.

먼저 Twitch에서 채널 카테고리를 갱신하세요

명령어를 설정하기 전에 카테고리를 어디서 변경하는지 확인하세요: Creator Dashboard 패널, 스트림 관리 프로그램 또는 봇과의 연동을 통해서 말입니다. 중요한 것은 시청자가 방송 페이지에서 보는 채널의 최종 상태입니다.

게임을 변경한 후 모든 서비스에서 즉시 갱신될 것이라고 기대하지 마세요. 봇은 마지막 값을 캐시에 저장할 수 있고, 플랫폼은 갱신된 데이터를 지연해서 전달할 수 있습니다. !게임 명령어의 경우 방송 시작 전에 카테고리를 변경하고 채팅에서 응답을 별도로 확인하는 것이 좋습니다.

Nightbot의 !게임 명령어

Nightbot에서 Custom Commands를 열고 !게임 명령어를 생성한 후 Twitch 변수가 포함된 메시지를 지정하세요. 현재 채널의 경우 보통 다음과 같은 응답을 사용합니다: «Сейчас играем в: $(twitch game $(channel))».

$(channel) 변수는 명령어가 호출된 채널을 대입하고, $(twitch game ...)은 해당 채널의 카테고리를 요청합니다. 봇이 여러 채널을 관리하는 경우 이 방식이 각 명령어에 스트리머 로그인을 직접 입력하는 것보다 편리합니다.

• Command: !게임
• Message: Сейчас играем в: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: 채팅에 동일한 응답이 넘치지 않도록 지연 시간을 설정하세요

Nightbot의 단점은 응답 로직이 제한적이라는 것입니다. 추가적인 우회 방법 없이 빈 카테고리, 여러 텍스트 변형 또는 자체 일정의 데이터를 처리하기는 어렵습니다.

StreamElements의 카테고리 명령어

StreamElements에서 현재 게임 변수는 보통 명령어 응답에 ${game}으로 추가됩니다. Chat bot 섹션에서 !게임 명령어를 생성하고 텍스트를 «Текущая игра: ${game}»로 설정하세요.

저장하기 전에 시청자 계정으로 채팅에서 명령어를 확인하세요. 봇이 필요한 채널에 연결되어 있지 않거나 채널 카테고리가 갱신되지 않았다면, 변수는 이전 값이나 빈 텍스트를 반환할 수 있습니다. 권한 및 지연 설정은 명령어 매개변수에서 같은 위치에 있습니다.

• Command: !게임
• Response: Текущая игра: ${game}
• Permission: Everyone
• Cooldown: 채팅 활동량에 맞게 조정하세요

StreamElements의 단점은 명령어가 서비스 자체의 Twitch 연동에 의존한다는 것입니다. 인증 오류나 동기화 지연이 발생하면 명령어를 수정하지 않고는 응답을 수동으로 고칠 수 없습니다.

Streamer.bot으로 카테고리 출력하는 방법

Streamer.bot에서는 Action을 통해 명령어를 구성하는 것이 더 편리합니다. Twitch 채널 정보를 가져온 후 채팅에 메시지를 전송하는 액션을 생성하세요. 채널 데이터 조회 하위 명령어 이후에는 보통 액션 인수에서 gameName이라는 게임 이름을 사용할 수 있습니다.

Send Message 하위 명령어에서 예를 들어 «Сейчас играем в: %gameName%»와 같이 지정하세요. 그런 다음 Commands 섹션에서 Action을 !게임 명령어에 연결하세요. 사용 중인 Streamer.bot 빌드에서 인수 이름이 다르다면, 먼저 테스트 모드로 액션을 실행하고 Twitch 하위 명령어가 반환한 인수 목록을 확인하세요.

Streamer.bot의 단점은 수동 설정이 더 많다는 것입니다. 명령어, 액션, 채팅에 대한 봇의 접근 권한, Twitch 인증을 직접 연결해야 하므로 어느 단계에서든 오류가 발생하면 명령어가 응답하지 않게 됩니다.

Twitch API를 통한 카테고리 요청

커스텀 봇, 스크립트 또는 Streamer.bot의 Action은 Twitch API를 통해 카테고리를 직접 가져올 수 있습니다. 이를 위해서는 먼저 채널의 숫자 식별자를 확인하세요: GET https://api.twitch.tv/helix/users?login=채널_로그인 요청은 id를 포함한 사용자 데이터를 반환합니다.

다음으로 GET https://api.twitch.tv/helix/channels?broadcaster_id=채널_ID 요청을 사용하세요. API 응답에는 game_name 필드가 있으며, 이것이 현재 카테고리 이름으로, !게임에 대한 응답으로 채팅에 전송할 수 있습니다.

요청에는 Client-ID와 액세스 토큰이 포함된 Authorization 헤더가 필요합니다. 토큰과 애플리케이션 식별자를 명령어의 공개 텍스트, 공개 저장소 또는 브라우저 위젯에 넣지 마세요: 이 데이터는 봇 설정이나 환경 변수에 저장해야 합니다.

API 명령어 설정 순서

1. Twitch 개발자 패널에서 애플리케이션을 생성하고 Client ID를 발급받으세요.
2. 채널 데이터에 접근할 수 있는 토큰을 발급받아 봇이나 스크립트 설정에 저장하세요.
3. 로그인으로 users 엔드포인트를 통해 채널의 broadcaster_id를 확인하세요.
4. broadcaster_id와 함께 channels 엔드포인트로 요청을 보내세요.
5. 응답에서 game_name 필드를 가져와 채팅용 메시지를 구성하세요.
6. game_name이 비어 있으면 빈 응답 대신 중립적인 텍스트를 출력하세요.

채팅의 모든 메시지마다 API를 폴링하지 마세요. !게임이 처음 호출될 때 값을 갱신하고, 명령어 지연 시간 동안 저장한 후 캐시가 만료된 후 데이터를 다시 가져오는 것이 더 실용적입니다. 카테고리를 수동으로 변경한 후에는 별도의 모더레이터 명령어로 값을 강제 갱신할 수 있습니다.

카테고리를 갱신하고 이전 응답을 받지 않는 방법

방송 중에 게임을 변경하는 경우 먼저 Twitch에서 카테고리를 갱신하고, 새 값이 채널 페이지에 표시될 때까지 기다린 후에 !게임을 확인하세요. 봇이 캐시를 사용하는 경우 캐시를 지우거나 다음 API 요청을 기다리세요.

단일 채널의 경우 보통 지속적인 폴링을 실행하는 대신 명령어 호출 시 카테고리를 갱신하는 것으로 충분합니다. 자동 모니터링이 필요한 경우 적당한 간격으로 확인하고 API 제한을 고려하세요. 잦은 요청이 데이터를 더 정확하게 만들지는 않지만 플랫폼 측에서 제한을 받을 수 있습니다.

직접 API 접근 방식의 단점은 토큰을 관리해야 한다는 것입니다. 접근 권한이 취소되거나, 비밀번호가 변경되거나, 애플리케이션 권한이 변경되거나, 인증 오류가 발생하면 명령어가 이전 카테고리를 출력하거나 응답을 중단할 수 있습니다.

컴퓨터에서 게임 인식 및 그 한계

별도의 인식 도구는 Twitch 카테고리가 수동으로 변경되지 않을 때만 필요합니다. 이러한 자동화는 실행 중인 프로세스, 게임 플랫폼 데이터, 활성 창 또는 텔레메트리를 추적하고, 게임을 Twitch 카테고리와 매칭한 후 API를 통해 채널을 갱신합니다.

그 후에도 봇은 화면 내용이 아니라 Twitch 카테고리를 읽습니다. 자동화는 단지 대신 채널 데이터를 변경할 뿐입니다. 게임이 런처를 통해 실행되거나, 브라우저 버전이 사용되거나, 프로세스 이름이 게임과 일치하지 않거나, 스트리머가 다른 프로그램으로 전환한 경우 오류가 발생할 수 있습니다.

인식의 단점은 별도로 설정하고 관리해야 한다는 것입니다. 여러 게임, 모드, 에뮬레이터 및 기술적 장면이 있는 스트림에서는 수동 카테고리 변경이 더 안정적인 경우가 많습니다.

빈 카테고리, 여러 게임 및 수동 텍스트

플랫폼은 하나의 현재 카테고리만 전달합니다. 방송에 여러 게임이 있는 경우 !게임 명령어는 현재 진행 중인 게임을 표시해야 하며, 방송 계획은 별도의 !일정 명령어나 채널 설명에 두는 것이 좋습니다.

빈 카테고리의 경우 «Текущая категория пока не указана» 또는 «Сейчас разговорный эфир»와 같은 명확한 응답을 준비하세요. Nightbot과 StreamElements에서는 이러한 처리를 위해 별도의 명령어나 수동 텍스트 변경이 필요할 수 있습니다. 커스텀 API 스크립트에서는 game_name 필드가 비어 있는지 확인하고 대체 값을 넣을 수 있습니다.

수동 명령어는 작동하는 예비 수단으로 남습니다: «Сейчас играем в: 게임 이름». 단점은 명확합니다 — 게임 변경 후 갱신하는 것을 잊기 쉬워 시청자들이 잘못된 정보를 받게 됩니다.

권한, 지연 및 방송 전 확인

기본 !게임 명령어는 보통 모든 시청자가 사용할 수 있도록 두되 cooldown을 추가합니다. 이렇게 하면 여러 사람이 동시에 게임을 물을 때 동일한 메시지가 반복되는 것을 줄일 수 있습니다. 캐시 초기화, 텍스트 수동 갱신 또는 Action 재시작 명령어는 모더레이터와 채널 소유자에게만 남겨두세요.

봇, 토큰 또는 Twitch 연동을 변경한 후에는 명령어를 확인하세요. 올바른 변수라도 봇이 다른 채널에 연결되어 있거나 데이터 읽기 권한을 잃었다면 도움이 되지 않습니다.

1. Twitch 패널에서 원하는 게임이나 카테고리를 지정하세요.
2. 새 이름이 채널 페이지에 표시되는지 확인하세요.
3. 챗봇이 정확히 자신의 채널에 연결되어 있는지 확인하세요.
4. 일반 시청자 계정으로 !게임을 호출하세요.
5. 카테고리를 변경하고 캐시 갱신 또는 명령어 지연 후에 다시 호출하세요.
6. 빈 카테고리와 대화 방송 중의 응답을 확인하세요.
7. API를 사용하는 경우 토큰 유효 기간과 요청 오류 로그를 확인하세요.