Livedeck APIで自分だけのTikTok LIVEウィジェットを作る方法
ウィジェットとは何か、オーバーレイでどう動くか、スターターキットから完成までの流れを説明します。
4分で読めます 2026年11月4日更新
Livedeck APIを使えば、目標、ティッカー、ランキング、ミニゲーム、アニメーションなど、オーバーレイ用の自作ウィジェットを作れます。ウィジェットはHTML、CSS、JavaScriptでできた小さなWebページです。LivedeckがLIVEのイベント(ギフト、チャット、いいね、フォローなど)を送り、ウィジェットがそれをオーバーレイに描画します。
注意:ウィジェットはベータ版です。当初は許可されたアカウントのみアップロードできます。参加を希望する場合は、サポートまでご連絡ください。
ウィジェットの動作
- 通常のオーバーレイリンク(OBS、TikTok LIVE Studio)の中でそのまま動作します。2つ目のソースは不要です。
- 各ウィジェットは独自のアドレスを持つ専用フレーム内で隔離して動作します。manifest.jsonで要求したイベントだけを受け取り、アカウント、Cookie、他のウィジェットにはアクセスできません。
- ウィジェットに必要なものはすべてパッケージ内に含まれます。外部サイトからは何も読み込みません(Webからのフォント、画像、スクリプト、トラッカーは不可)。LIVE中もブラウザがこうした読み込みをブロックします。
- プロフィール画像やギフト画像は、ウィジェット自身がWebから読み込むことなくSDK経由で取得できます。
- ウィジェットがフリーズしたりCPUを使いすぎたりした場合、Livedeckはそのウィジェットだけを停止します。オーバーレイの他の部分はそのまま動作します。
スターターキットから完成まで
- スターターキットをダウンロードして解凍します。
- manifest.json、index.html、style.css、app.jsを編集します。手順はすべて「はじめてのウィジェット」で説明しています。
- ファイルを再びZIPにまとめます。
- エディターの「マイウィジェット」›「自作をアップロード」でZIPをアップロードします。これには二要素認証(認証アプリまたはパスキー)が必要で、それを使ってログインしている必要があります。
- 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で販売できます。方法は「審査・販売・アップデート」で説明しています。
開発者向けページ一覧
この記事は役に立ちましたか?