Livedeck API로 나만의 TikTok LIVE 위젯을 만드는 방법

위젯이 무엇인지, 오버레이에서 어떻게 실행되는지, 스타터 키트에서 완성된 위젯까지 가는 방법을 알아봐요.

4분 분량 2026년 11월 4일 업데이트

Livedeck API로 오버레이에 넣을 나만의 위젯을 만들 수 있어요: 목표, 티커, 리더보드, 간단한 게임이나 애니메이션 등. 위젯은 HTML, CSS, JavaScript로 만든 작은 웹페이지예요. Livedeck이 LIVE의 이벤트(선물, 채팅, 좋아요, 팔로우 등)를 위젯에 보내면, 위젯이 오버레이에 화면을 그려요.

참고: 위젯은 베타 단계예요. 처음에는 승인된 계정만 업로드할 수 있어요. 참여하고 싶다면 고객지원으로 문의해 주세요.

위젯이 실행되는 방식

  • 평소 쓰는 오버레이 링크(OBS, TikTok LIVE Studio) 안에서 바로 실행돼요. 소스를 하나 더 추가할 필요가 없어요.
  • 모든 위젯은 고유한 주소를 가진 별도 프레임 안에서 격리되어 실행돼요. manifest.json에서 요청한 이벤트만 볼 수 있고, 내 계정, 쿠키, 다른 위젯에는 접근할 수 없어요.
  • 위젯에 필요한 모든 것은 패키지 안에 들어 있어요. 다른 사이트에서는 아무것도 불러오지 않아요: 웹 폰트, 이미지, 스크립트, 트래커 모두 없어요. LIVE 중에도 브라우저가 이런 시도를 차단해요.
  • 위젯은 직접 웹에서 불러오지 않고 SDK를 통해 프로필 사진과 선물 이미지를 받아요.
  • 위젯이 멈추거나 CPU를 너무 많이 쓰면, Livedeck이 해당 위젯만 꺼요. 나머지 오버레이는 계속 실행돼요.

스타터 키트에서 완성된 위젯까지

  1. 스타터 키트를 다운로드하고 압축을 풀어요.
  2. manifest.json, index.html, style.css, app.js를 수정해요. 모든 단계는 "첫 위젯 만들기"에서 확인할 수 있어요.
  3. 파일을 다시 ZIP으로 압축해요.
  4. 에디터의 내 위젯 › "직접 업로드"에서 ZIP을 업로드해요. 이를 위해 2단계 인증(인증 앱 또는 패스키)이 필요하고, 해당 인증으로 로그인한 상태여야 해요.
  5. Livedeck이 패키지를 검사하고 위젯을 자동으로 테스트해요. 에디터 미리보기에서 바로 사용해 볼 수 있어요. OBS 링크에서는 관리자가 승인한 후에 실행돼요.

AI로 만들기

코딩을 직접 하지 않나요? 아이디어를 한 문장으로 설명하고 Claude, ChatGPT, Cursor 같은 AI에게 위젯을 만들게 해 보세요. AI가 Livedeck의 모든 규칙과 제한이 담긴 가이드를 읽고 ZIP 파일을 만들어 주면, 위에 설명한 대로 업로드하면 돼요. 사용하기 전에 에디터 미리보기에서 결과를 확인하세요.

AI로 위젯 만들기

위젯이 할 일을 한 문장으로 적은 뒤, 이 텍스트를 Claude, ChatGPT, Cursor 등 원하는 AI에 붙여 넣으세요. AI가 저희 규칙을 읽고 바로 업로드할 수 있는 ZIP을 만들어 줘요.

https://help.livedeck.de/widgets/agent.md에 있는 안내를 읽고 그대로 따라 Livedeck 위젯을 만들어 줘. 거기 있는 규칙을 정확히 지켜 줘.

내 위젯을 다른 크리에이터에게 제공하고 싶나요? Livedeck Marketplace에서 판매해 보세요. 방법은 "검토, 판매 및 업데이트"에서 확인할 수 있어요.

모든 개발자 페이지

이 글이 도움이 되었나요?