첫 Livedeck 위젯: 스타터 키트부터 업로드까지
스타터 키트를 다운로드해 수정하고, ZIP으로 업로드한 뒤 에디터에서 테스트해요.
6분 분량 2026년 11월 4일 업데이트
스타터 키트는 "Live Feed"라는 완성된 위젯이에요: 선물, 팔로우, 채팅을 카드로 보여 주고 좋아요 수를 세요. 이걸 바탕으로 나만의 위젯을 만들어 보세요.
패키지 구성
manifest.json
위젯의 이름, 버전, 크기, 권한 및 설정
index.html
시작 페이지예요. SDK와 내 파일을 불러와요.
style.css
디자인
app.js
로직: 이벤트에 반응해요
README.md
빠른 가이드
| 파일 | 용도 |
|---|---|
| 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으로 압축해 업로드하기
- 나중에 버전을 구분할 수 있도록 manifest.json의 version을 올리세요(예: 1.0.0에서 1.0.1로).
- 파일을 ZIP으로 압축하세요. manifest.json은 ZIP의 최상위나, 모든 파일이 들어 있는 단일 폴더 안에 있어야 해요. Windows: 파일 선택 › 마우스 오른쪽 클릭 › 보내기 › 압축(ZIP) 폴더. Mac: 파일 선택 › 마우스 오른쪽 클릭 › 압축.
- 대시보드에서: 에디터 › 내 위젯 › "직접 업로드". 처음이라면 개발자 프로필을 만들고 규칙에 동의해야 해요.
- 약 1분 뒤 검사가 끝나요. 통과하지 못했나요? 모든 사유가 파일과 줄, 또는 측정값과 함께 표시돼요. 수정한 뒤 새 ZIP을 업로드하세요.
- 위젯을 캔버스에 배치하고, 설정의 테스트 버튼(선물, 채팅, 좋아요 등)으로 확인해 보세요.
팁: 파일 이름에는 a~z, 숫자, 하이픈, 밑줄만 사용하세요. __MACOSX, .DS_Store, Thumbs.db 같은 시스템 파일은 Livedeck이 무시해요.
참고: 에디터와 Marketplace의 테스트 이벤트는 livedeck.context.test = true와 가상의 시청자로 전달돼요. OBS 링크에서는 이 값이 false예요.
이 글이 도움이 되었나요?