콘텐츠로 이동
Get Started

Twitch

전체 과정은 Twitch 드롭에서 액세스 키 부여하기를 참고하세요.

Twitch 자격 증명 API를 호출하는 데 필요한 구성입니다.

Client ID, Client Secret, Organization and Game ID 필드가 있는 Twitch 구성 탭

  • Client ID - 드롭 캠페인을 소유한 Twitch 애플리케이션의 클라이언트 ID입니다. Twitch Developer Console의 앱 관리 페이지에서 확인할 수 있습니다.
  • Client Secret - 해당 클라이언트 ID에 대응하는 시크릿입니다. 저장 후에는 마스킹되어 표시되며, 교체 시 취소 후 재발급해야 합니다.
  • Organization and Game ID - Twitch Developer Console에서 게임의 애널리틱스 또는 박스아트 페이지 URL을 붙여넣으세요. FirstLook이 URL에서 두 ID를 자동으로 읽어 표시합니다.
    https://dev.twitch.tv/org/<org-id>/console/games/<game-id>/analytics

각 행은 하나의 Twitch 리워드 ID를 Grant Type(해당 리워드 수령 시 부여되는 키 유형)에 매핑합니다.

매핑된 리워드 ID와 키 인벤토리 수량을 표시하는 Grant Type 드롭다운이 있는 리워드 매핑 섹션

  • 리워드 ID는 Twitch에서 제공하며, Twitch Developer Console의 리워드 관리 페이지에서 확인할 수 있습니다.
  • FirstLook이 처리할 책임이 있는 리워드 ID만 추가하세요. 게임에 설정된 그 외 리워드 ID는 무시됩니다.

Monitor Drops 탭에서 Twitch와의 동기화를 시작하거나 중지하고, 동기화된 모든 리워드의 기록을 확인할 수 있습니다.

Start Syncing

  • Twitch EventSub drop.entitlement.grant 이벤트를 구독합니다.
  • 15분마다 백그라운드 동기화를 실행하여 수령된 리워드를 읽고, 키를 부여하며, 미완료된 부여 건을 재시도합니다.

Stop Syncing

  • EventSub 구독을 해제하고 백그라운드 동기화를 중지합니다.

Status Table

이 테이블은 FirstLook이 기록한 모든 드롭을 표시합니다. 플레이어 이름, Drop Status, 리워드 ID로 필터링할 수 있습니다.

드롭 및 부여 상태와 함께 동기화된 리워드를 보여주는 Monitor Drops 테이블

  • Drop Status - Twitch에서의 리워드 상태: Claimed 또는 Fulfilled.
  • Grant Status - 키 부여 상태: Pending, Granted, 또는 Player limit reached.