Twitch에 앱 연결하기

앱을 Twitch에 연결하여 커스텀 스트림 오버레이 제작, 실시간 방송 데이터 표시, 채널 활동 추적, 크리에이터 및 커뮤니티 도구를 Lovable 앱에서 직접 구축하세요.

Twitch는 게임, 창작 콘텐츠, 실시간 커뮤니티 상호작용에 특화된 라이브 스트리밍 플랫폼입니다. Twitch 커넥터를 사용하면 Twitch API에 접근하여 스트림 오버레이, 대시보드, 채널에서 일어나는 일에 반응하는 커뮤니티 도구를 구동할 수 있습니다.

Twitch를 연동하면 앱에서 다음과 같은 작업이 가능합니다:

• Twitch 채널의 실시간 채팅 표시
• 팔로워 및 구독자 수 표시
• 팔로워 또는 구독 목표 등 커스텀 목표 추적
• 스트림 상태, 시청자 수, 채널 메타데이터 조회
• 클립, 일정, 채널 정보 가져오기
• Twitch 채널에 채팅 메시지 전송
• 채널, 게임, 카테고리 검색

Twitch는 스트림과 함께 동작하는 앱에 적합합니다. 오버레이, 모더레이션 도구, 이벤트 대시보드, 크리에이터 분석 앱 등이 그 예입니다.

주요 활용 사례 및 예시 앱

Twitch 연결 방식

Twitch는 인증에 OAuth 2.0을 사용합니다. Twitch를 연결하면 인증된 계정을 대신하여 Twitch에 접근하도록 Lovable을 승인합니다.

Twitch는 안전한 OAuth 처리와 자동 토큰 갱신을 위해 Lovable의 게이트웨이 아키텍처를 사용합니다. 인증 및 사용량 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.

각 Twitch 연결은 하나의 Twitch 계정에 연결됩니다. 필요하면 여러 연결을 만들 수 있습니다. 예를 들어, 개발/운영 환경이나 서로 다른 크리에이터 계정을 분리할 수 있습니다.

Twitch 연결하기

워크스페이스 admin 또는 owner가 Twitch를 연결할 수 있습니다.

연결을 만들면 해당 워크스페이스의 모든 프로젝트에서 Twitch를 사용할 수 있습니다.

사전 준비

Twitch를 연결하기 전에 다음을 준비하세요:

• Twitch 계정
• Lovable 워크스페이스 admin 또는 owner 권한

1단계: 연결할 계정 선택

연결은 Twitch 계정을 직접 사용합니다. 개발자 애플리케이션이나 API 키가 필요하지 않습니다.

연결된 계정에 사용 사례에 필요한 권한이 있는지 확인하세요.

예를 들어:

• 팔로워 데이터를 읽으려면 계정에 해당 채널의 모더레이터 접근 권한이 필요합니다.
• 채팅 메시지를 보내려면 계정에 해당 채널에서 메시지를 게시할 수 있는 권한이 필요합니다.
• 구독 데이터에 접근하려면 연결된 계정이 채널 소유자여야 합니다.

대부분의 오버레이 설정에서는 스트리머 본인의 계정을 연결하면 가장 넓은 접근 권한을 얻을 수 있습니다.

2단계: Lovable에 Twitch 연결

1. Settings → Connectors → Shared connectors에서 Twitch를 선택합니다.

2. Add connection을 클릭합니다.

3. Display name에 연결 이름을 입력합니다. 예: Twitch Production

4. Scope 설정 (선택)

   Advanced settings를 펼쳐 앱에 필요한 Twitch API 권한을 설정합니다.

   기본 scope:

   • user:read:email — 계정 이메일 조회
   • channel:read:subscriptions — 채널 구독 데이터 조회
   • moderator:read:followers — 모더레이팅 중인 채널의 팔로워 데이터 조회
   • user:write:chat — Twitch 채팅에 메시지 전송

   클립 관리, 예측, 투표, 분석, 채널 포인트 등의 기능을 위한 추가 scope도 사용할 수 있습니다.

   앱에 필요한 scope만 활성화하세요. 나중에 연결을 편집하고 Reconnect를 선택하면 scope를 업데이트할 수 있습니다.

   전체 scope 목록은 Twitch OAuth scope reference를 참고하세요.

5. Connect를 클릭합니다. Twitch 승인 창이 열립니다. 팝업 차단을 해제해 주세요.

6. Twitch에 로그인하고, 요청 권한을 검토한 뒤 Authorize를 클릭합니다.

승인이 완료되면 Lovable에 연결이 표시되며 앱에서 Twitch 데이터를 사용할 수 있습니다.

제한 사항

Twitch 커넥터는 현재 다음을 지원하지 않습니다:

• 게이트웨이를 통한 실시간 Twitch 채팅 읽기
  Twitch 채팅은 WebSocket 기반 IRC를 사용하며, Lovable 게이트웨이를 통해 프록시할 수 없습니다.

  채팅 메시지를 읽으려면 앱에서 Twitch의 채팅 엔드포인트에 직접 연결해야 합니다: wss://irc-ws.chat.twitch.tv

  공개 채팅 읽기는 인증이 필요 없습니다. Twitch API를 통한 채팅 메시지 전송은 인증이 필요합니다.

• EventSub 웹훅 수신
  스트림 시작 알림이나 팔로우 이벤트 등 수신 Twitch 이벤트는 현재 지원되지 않습니다.

• 사용자별 Twitch 로그인
  각 연결은 하나의 Twitch 계정을 인증합니다. 앱의 최종 사용자가 이 커넥터를 통해 자신의 Twitch 계정을 연결할 수는 없습니다.

Twitch 연결에서 프로젝트 연결 해제

Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.

연결 해제 방법:

연결 해제 후 해당 프로젝트는 이 연결을 통해 Twitch에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.

Twitch 연결 삭제

워크스페이스 admin 또는 owner가 Twitch 연결을 삭제할 수 있습니다.

삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.

삭제 방법: