첫 Livedeck 위젯: 스타터 키트부터 업로드까지

스타터 키트를 다운로드해 수정하고, ZIP으로 업로드한 뒤 에디터에서 테스트해요.

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

스타터 키트는 "Live Feed"라는 완성된 위젯이에요: 선물, 팔로우, 채팅을 카드로 보여 주고 좋아요 수를 세요. 이걸 바탕으로 나만의 위젯을 만들어 보세요.

패키지 구성

manifest.json

위젯의 이름, 버전, 크기, 권한 및 설정

index.html

시작 페이지예요. SDK와 내 파일을 불러와요.

style.css

디자인

app.js

로직: 이벤트에 반응해요

README.md

빠른 가이드

시작 페이지

모든 시작 페이지는 /sdk/v1.js 경로에서 SDK를 불러와요. Livedeck이 위젯 주소에서 SDK를 제공하니 패키지에 직접 넣을 필요는 없어요. 나머지 파일은 모두 상대 경로로 불러오세요.

html
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="style.css">
  <!-- Livedeck serves the SDK. Everything else lives in your package. -->
  <script src="/sdk/v1.js"></script>
</head>
<body>
  <div id="feed"></div>
  <script src="app.js"></script>
</body>
</html>

이벤트에 반응하기

js
function show(text) {
  const line = document.createElement("p");
  line.textContent = text; // textContent, never innerHTML: names are viewer text
  document.getElementById("feed").prepend(line);
}

livedeck.on("gift", (e) => {
  // "@" + e.user.handle (username), e.gift.name, e.count, e.totalDiamonds
  show("@" + e.user.handle + " sent " + e.count + "× " + e.gift.name);
});

livedeck.on("follow", (e) => {
  show("@" + e.user.handle + " followed you");
});

livedeck.ready(() => {
  // The overlay is connected and the settings are here.
  document.body.style.color = livedeck.settings.accent;
});

위젯은 manifest.json의 permissions에 요청한 이벤트만 받아요. 위 예시에서는 events.gift와 events.follow예요.

ZIP으로 압축해 업로드하기

  1. 나중에 버전을 구분할 수 있도록 manifest.json의 version을 올리세요(예: 1.0.0에서 1.0.1로).
  2. 파일을 ZIP으로 압축하세요. manifest.json은 ZIP의 최상위나, 모든 파일이 들어 있는 단일 폴더 안에 있어야 해요. Windows: 파일 선택 › 마우스 오른쪽 클릭 › 보내기 › 압축(ZIP) 폴더. Mac: 파일 선택 › 마우스 오른쪽 클릭 › 압축.
  3. 대시보드에서: 에디터 › 내 위젯 › "직접 업로드". 처음이라면 개발자 프로필을 만들고 규칙에 동의해야 해요.
  4. 약 1분 뒤 검사가 끝나요. 통과하지 못했나요? 모든 사유가 파일과 줄, 또는 측정값과 함께 표시돼요. 수정한 뒤 새 ZIP을 업로드하세요.
  5. 위젯을 캔버스에 배치하고, 설정의 테스트 버튼(선물, 채팅, 좋아요 등)으로 확인해 보세요.
팁: 파일 이름에는 a~z, 숫자, 하이픈, 밑줄만 사용하세요. __MACOSX, .DS_Store, Thumbs.db 같은 시스템 파일은 Livedeck이 무시해요.
참고: 에디터와 Marketplace의 테스트 이벤트는 livedeck.context.test = true와 가상의 시청자로 전달돼요. OBS 링크에서는 이 값이 false예요.

이 글이 도움이 되었나요?