ギフト連動(画像・音・Webhook)

配信には接続していません

配信で投げられたギフトは、下の「直近のギフト」に並びます(直近30種類)。その中からフックするギフトを15個まで選ぶと、そのギフトが届いたときに OBS に画像を出して音を鳴らし、Webhook の URL を呼び出します。

フックするギフト

OBS の画面:未接続

ギフトの行を押すと設定が開きます。選んだギフトはここに残ります(直近のギフトから流れても消えません)。「選択をやめる」で外しても設定は覚えていて、もう一度選ぶと元に戻ります。

直近のギフト

配信で投げられたギフトが、新しい順に直近30種類まで並びます(×の数は届いた合計)。「選ぶ」でフックするギフトに入れます。

OBS に追加する(画像と音)
  1. OBS Studio の「ソース」の+ →「ブラウザ」を選ぶ
  2. コピーしたアドレスを貼り付け、幅 1920・高さ 1080 にする
  3. 「OBS で音声を制御する」にチェックを入れる(音が配信に乗ります。自分でも聞くときは、音声ミキサーでモニタリングを「モニターと出力」に)
  4. ふだんは透明なので、画面全体に重ねたままで大丈夫です

アドレスの後ろに ?pos=top(上に出す)・?pos=bottom(下に出す)・?scale=0.5(全体の大きさ)・?mute=1(音なし)を付けられます。

Webhook の呼び出しの記録

Webhook で送る内容・使い方
{
  "event": "gift", "test": false, "slot": 1,
  "gift": { "id": "5655", "name": "Rose", "diamonds": 1, "image": "https://…" },
  "count": 5, "diamondsTotal": 5,
  "user": { "id": "…", "uniqueId": "tiktok_id", "nickname": "表示名" },
  "at": "2026-10-18T00:00:00.000Z"
}