할로윈 세일: Agency Global $266/월, 연간 결제. 8개월 가격으로 12개월 이용. 10월 31일 종료.

종료까지세일 종료까지 7일 15시간 50분 남음할인 받기
한 단계 마이그레이션

몇 초 만에 TikTok-Live-Connector에서 전환

이미 tiktok-live-connector 패키지를 쓰고 계신가요? import 한 줄만 바꾸면 관리형 TikTool API로 전환돼요. 이벤트 이름도, 메서드도 그대로라 코드를 고칠 필요가 없어요.

1

SDK 설치

npm install @tiktool/live
2

import 한 줄 변경

-const { WebcastPushConnection } = require('tiktok-live-connector');
+const { WebcastPushConnection } = require('@tiktool/live');
3

TikTools API 키 사용

-signApiKey: 'EULER_API_KEY'
+signApiKey: 'TIKTOOL_API_KEY'

tik.tools에서 무료 키를 받으세요 - 신용카드 필요 없어요.

✅
끝이에요. 기존 이벤트 핸들러가 모두 똑같이 작동해요 - chat, gift, member, roomUser, like, follow, share, emote, linkMicBattle, linkMicArmies, questionNew, getState(), connect(), disconnect().

전체 작동 예제

이 코드는 tiktok-live-connector, @tiktool/live 어느 쪽에서든 똑같이 실행돼요. import만 바뀌어요.

// Before: const { WebcastPushConnection } = require('tiktok-live-connector');
const { WebcastPushConnection } = require('@tiktool/live');

const connection = new WebcastPushConnection('username', {
  signApiKey: 'YOUR_TIKTOOL_API_KEY',
});

connection.on('chat', data => {
  console.log(`${data.user.uniqueId}: ${data.comment}`);
});

connection.on('gift', data => {
  console.log(`${data.user.uniqueId} sent ${data.giftName}`);
});

connection.on('roomUser', data => {
  console.log(`Viewers: ${data.viewerCount}`);
});

connection.on('connected', state => {
  console.log('Connected!', connection.getState());
});

connection.connect();

이벤트 이름 100% 호환

모든 TTLC 이벤트 이름이 그대로 작동해요. TikTools 고유 이름의 이벤트도 동시에 발생해요.

TTLC 이벤트 이름상태비고
chat✓동일
member✓동일
gift✓동일
like✓동일
follow✓동일
share✓동일
subscribe✓동일
social✓동일
roomUser✓roomUserSeq의 별칭 - 둘 다 발생
questionNew✓question의 별칭 - 둘 다 발생
linkMicBattle✓battle의 별칭 - 둘 다 발생
linkMicArmies✓battleArmies의 별칭 - 둘 다 발생
emote✓emoteChat의 별칭 - 둘 다 발생
envelope✓동일
liveIntro✓동일
roomPin✓동일
barrage✓동일
superFan✓2.0.8에서 추가 - 지원
superFanJoin✓2.0.8에서 추가 - 지원
superFanBox✓2.0.8에서 추가 - 지원
connected✓동일
disconnected✓동일
error✓동일
streamEnd✓동일
rawData✓원본 이벤트 페이로드 전체와 함께 발생
websocketConnected✓WS 연결 시 발생

왜 관리형 API로 바꿔야 할까요?

🛡️

끊기지 않아요

TikTok은 프로토콜을 주기적으로 바꿔서 직접 연동을 깨뜨려요. TikTool이 모든 프로토콜 변경을 대신 처리해요 - 다운타임 없이.

⚡

더 빠른 이벤트 전달

최적화된 인프라로 50ms 미만의 이벤트 지연. 내 쪽에서 protobuf를 디코딩할 필요가 없어요.

🧩

의존성 제로

protobufjs도, ws-client도, HTTP 서명도 필요 없어요. 외부 의존성 없는 npm 패키지 하나면 끝.

🔄

자동 재연결

지수 백오프 재연결 내장. 네트워크가 잠깐 끊기거나 TikTok 서버가 재시작돼도 연결이 유지돼요.

📊

사용량 대시보드

tik.tools/dashboard에서 API 사용량, WebSocket 연결, 이벤트 양을 실시간으로 확인하세요.

💬

개발자 지원

디스코드, 이메일, 앱 내 지원 채팅으로 도움을 받으세요. 응답 시간 4시간 이내.

자주 묻는 질문

TypeScript 타입이 그대로 작동하나요?

네. @tiktool/live 패키지는 chat, gift, roomUser 등 모든 이벤트 페이로드에 대한 완전한 TypeScript 정의를 제공해요. TTLC의 커뮤니티 관리 타입을 쓰셨다면, 저희 타입이 더 엄격하고 TikTok의 실제 protobuf 스키마에 맞춰 계속 업데이트돼요.

sessionId, processInitialData, requestPollingIntervalMs 같은 TTLC 옵션은요?

연결 동작을 제어하는 생성자 옵션(sessionId, requestPollingIntervalMs, enableExtendedGiftInfo 등)은 그대로 받아서 전달해요. 더 이상 쓰이지 않는 옵션(processInitialData 등)은 조용히 무시되니 설정 객체를 정리할 필요가 없어요.

TTLC는 API 키 없이도 될 때가 있는데, TikTool은 키가 필요한가요?

네, signApiKey 값이 필요해요. 무료 Sandbox 키는 tik.tools/login에서 신용카드 없이 30초면 받을 수 있어요. Sandbox에는 하루 5,000회 API 호출과 동시 WebSocket 연결 3개가 포함돼 개발과 테스트에 충분해요.

TikTok이 프로토콜을 업데이트하면 실제로 어떻게 되나요?

TTLC는 TikTok의 주기적인 서명 알고리즘과 protobuf 스키마 업데이트 때문에 라이브러리가 멈춰요. TikTok 배포 후 몇 시간 만에 멈추기도 하고, 오픈소스 관리자가 패치할 때까지 해결되지 않아요. TikTool은 프로토콜 업데이트를 관리형 서버에서 처리해요. 내 코드는 바뀌는 게 없고, 이벤트는 계속 들어와요.

보너스: TTLC에 없는 기능

🔍

라이브 피드 탐색

지금 TikTok에서 누가 라이브 중인지 검색하고 찾아보세요. 언어, 지역, 시청자 수로 필터링할 수 있어요.

🐍

Python SDK

완전한 Python SDK 제공: pip install tiktok-live-api. 같은 API, 같은 이벤트, 다른 언어.

마이그레이션할 준비가 됐나요?

무료 API 키를 받으세요 - 신용카드 필요 없어요. Sandbox 요금제에는 하루 5,000회 요청과 동시 WebSocket 연결 3개가 포함돼요 - 무료, 개발 및 평가 전용.