콘텐츠로 이동
stream4j

stream4j 소개

stream4j는 chzzk4j에서 출발하여, 치지직 외 4개 플랫폼(씨미·숲·유튜브·투네이션)을 추가 지원하도록 확장한 Java 라이브러리입니다.

왜 필요한가요?

섹션 제목: “왜 필요한가요?”

스트리밍 플랫폼마다 채팅 연결 방식, 후원 이벤트 구조, 인증 방법이 모두 다릅니다. 여러 플랫폼을 동시에 운영하려면 각각의 API를 따로 연동해야 하는데, stream4j는 이 과정을 하나의 통합 API로 해결합니다.

  • 플랫폼별 URL을 넣으면 자동으로 플랫폼을 감지합니다.
  • 채팅 메시지와 후원 이벤트를 공통 형식으로 받을 수 있습니다.
  • 연결이 끊어지면 자동으로 재연결합니다.

이런 분께 적합합니다

섹션 제목: “이런 분께 적합합니다”
  • 멀티플랫폼 통합 채팅 뷰어를 만들고 싶은 개발자
  • 여러 플랫폼의 후원 알림 봇을 구축하려는 팀
  • 스트리밍 관련 자동화 도구를 기획하는 PM
  • 다중 플랫폼 방송 운영에 필요한 기술을 검토하는 분

지원 플랫폼

섹션 제목: “지원 플랫폼”
플랫폼채팅후원방송 종료 감지인증 필요
치지직 (Chzzk)✅✅✅선택
씨미 (CiMe)✅✅✅불필요
숲 (SOOP, 구 아프리카TV / 아프리카티비)✅✅✅선택
유튜브 (YouTube)✅✅✅불필요
투네이션 (Toonation)—✅—불필요

핵심 기능

섹션 제목: “핵심 기능”
  • 플랫폼 자동 감지 — URL을 넣으면 어떤 플랫폼인지 자동으로 판별
  • 통합 후원 모델 — 치즈, 별풍선, 슈퍼챗 등 플랫폼별 후원을 하나의 Donation record로
  • 안정적인 연결 유지 — OkHttp ManagedWebSocket, 자동 재연결, idle timeout 감지
  • 방송 종료 감지 — 각 플랫폼에 맞는 방식으로 자동 감지
  • 원화 환산 내장 — CurrencyUtils로 치즈·빔·별풍선·USD 등을 KRW로 통합

대표 사용 사례

섹션 제목: “대표 사용 사례”
  • 🖥️ 여러 플랫폼의 채팅을 한 화면에 모아보는 통합 채팅 뷰어
  • 🔔 후원이 들어오면 알려주는 멀티플랫폼 후원 알림 봇
  • 📊 채팅/후원 데이터를 수집·분석하는 방송 관리 대시보드
  • 🎮 마인크래프트 서버 연동 — 후원 시 보스 소환·아이템 지급·이펙트 발동
  • 🤖 디스코드 봇 연동 — 채팅·후원을 디스코드 채널로 실시간 중계
  • 🎬 OBS 오버레이 연동 — 후원 알림을 방송 화면 커스텀 오버레이로
  • 🔊 TTS 음성 알림 — 후원 메시지를 자동 음성 변환

다음 단계

섹션 제목: “다음 단계”