カウントダウン

こんなときに使います

イベント開始前は開始までの残り時間を、開催中は残り時間と進行バーを表示し、終わると消えます。

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

送り方

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

curl -X POST https://api.uchat.io/v2/rooms/room_xxxxxxxxxxxxxxxx/events \
  -H "Authorization: Bearer uchat_..." \
  -H "Content-Type: application/json" \
  -d '{"plugin":"countdown","save":true,"data":["週末イベント","1792400400","1792402200"]}'

• data の順番:タイトル、開始時刻、終了時刻(unix秒、UTC)
• 残り時間ではなく時刻を保存するので、送り直す必要はありません。途中から入った人も、その時点の残り時間から表示されます。延長するときは終了時刻だけを変えて保存し直します。
• "save": true で送ると最後の値として保存され、後から入った人も入室時に受け取ります。消すときは "data":[] を保存します。
• サーバーAPIから届いた値だけを描画し、値は文字としてのみ表示します。