投げ銭の目標バー

こんなときに使います

チャットルームのいちばん上に投げ銭の目標バーを表示します。現在の金額が変わるたびにサーバーが保存すれば、後から入った人もこれまでに集まった金額を見られます。

外部サーバーがuchat APIで値を送ると、このプラグインが描画します。プラグインをオンにし、管理ページの API メニューでキーを発行してサーバーに設定すれば完了です。

送り方

POST https://api.uchat.io/v2/rooms/{APIチャットルームID}/events に Authorization: Bearer {APIキー} ヘッダーとJSON本文を送ります。plugin は donationGoal です。

curl -X POST https://api.uchat.io/v2/rooms/room_xxxxxxxxxxxxxxxx/events \
  -H "Authorization: Bearer uchat_..." \
  -H "Content-Type: application/json" \
  -d '{"plugin":"donationGoal","save":true,"data":["週末配信の目標","120000","300000"]}'

• data の順番:タイトル、現在の金額、目標金額
• 金額は数値で送ります。目標金額を超えると「目標達成!」が付きます。
• "save": true で送ると最後の値として保存され、後から入った人も入室時に受け取ります。消すときは "data":[] を保存します。
• サーバーAPIから届いた値だけを描画し、値は文字としてのみ表示します。