1つのボタンで多くのスマートフォンに
1つの起動ボタンを多くの人に。スタジアム、クラス、募金活動など。
アクティビティは、最初に開いたスマートフォンのものになります。ほかのスマートフォンはエラーになります。reuse: trueを使うと、ボタンを開いたスマートフォンごとに、アクティビティの専用のコピーが作られます。
再利用で開始する
reuse: trueとgroupを送ります。グループを使えば、1回の呼び出しですべてのコピーに届きます。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
curl -X POST https://api.webliveactivity.com/api/start \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "widgetContainerId": "lincoln-vs-central-2026-10-23", "group": "lincoln-vs-central", "reuse": true, "brand": { "title": "Lincoln vs Central", "name": "Lincoln High" }, "state": { "layout": "versus", "primaryText": "Kickoff at 7 PM", "secondaryText": "Lincoln vs Central", "versus": { "leftName": "Lincoln", "rightName": "Central", "leftScore": "0", "rightScore": "0" } } }'
人がいる場所にボタンを置く
links.iframeをWebページに置きます。ポスター、チラシ、スタジアムの入口には、そのページのアドレスのQRコードを印刷します。コードをスキャンしてボタンをタップしてもらいます。
参加した人を確認する
各コピーには専用のactivityIdがあります。スマートフォンが参加すると、active Webhookで届きます。
全員を更新する
groupとwidgetContainerIdを送ります。すべてのコピーが変わります。
1 2 3 4 5 6 7 8 9 10 11 12 13 14
curl -X POST https://api.webliveactivity.com/api/update \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "group": "lincoln-vs-central", "widgetContainerId": "lincoln-vs-central-2026-10-23", "state": { "primaryText": "Lincoln scores!", "secondaryText": "Lincoln 7, Central 0", "versus": { "leftScore": "7" } } }'
全員を終了する
1 2 3 4 5 6 7
curl -X POST https://api.webliveactivity.com/api/end \ -H 'Content-Type: application/json' \ -H 'x-api-key: wla_your_key' \ -d '{ "group": "lincoln-vs-central", "widgetContainerId": "lincoln-vs-central-2026-10-23" }'
ルール
- startが返す
activityIdはテンプレートです。スマートフォンには届きません。グループの更新ではテンプレートも更新されるので、あとから参加したスマートフォンは最新のステートで始まります。 - 再利用ボタンはオフにできません。コピーを終了しても止まりません。新しいスマートフォンの参加を止めるには、ボタンとQRコードを取り除きます。
- スマートフォンはコンテナごとに1つのアクティビティを保持します。同じコンテナのものがすでにある場合、アプリはユーザーに、残すか置き換えるかを確認します。毎週の試合のように繰り返すイベントでは、イベントごとに新しい
widgetContainerIdを使います。
