Asobiai
ログイン

Asobiai SDK

みんなの集計

AIGame.tally で1票を入れ、AIGame.getTally でみんなの合計を読めます。アンケート、「今日の問題はみんな何手で解いたか」の分布、遊ばれるほど賢くなるゲームの学習データなどに使えます。残るのは合計だけで、誰が何を選んだかは残りません。

v2.4.0ゲームの中からは window.AIGame?.version で確認できます。更新履歴

使い方

js
// 1票入れる (1回のプレイで、同じ名前には1票だけ)
window.AIGame?.tally("favorite-stage", "forest");

// まとめて入れる (10個まで)。「今日の問題」なら名前に日付を入れる
window.AIGame?.tally({ "d20261024.result": "solved", "d20261024.moves": 5 });

// 読む
const t = await window.AIGame?.getTally("d20261024.moves");
// => { total: 128, counts: { "4": 12, "5": 61, "6": 55 } }   (Asobiai の外では null)
const many = await window.AIGame?.getTally(["d20261024.result", "d20261024.moves"]);
// => { "d20261024.result": { total, counts }, "d20261024.moves": { total, counts } }
  • 1回のプレイ（ゲームを始めてから）で、同じ名前には1票だけです（2回目からは数えず、counted が 0 になります）。ゲストも投票できます。
  • 名前は英数字と _ . : - （64文字まで）、選んだものは文字か数（32文字まで）。1つの名前の選択肢は 100種類まで、1ゲームの名前は 10000個まで、1回のプレイで 100票まで。
  • 誰でも投票できるので、画面に出すときはゲームが決めた選択肢だけを使ってください（知らない値は無視する）。気軽な集計向けで、票の水増しを完全には防げません。
  • Asobiai のゲームページと埋め込みで使えます。公開前のバージョンのプレビューと自動テストでは票は入りません。
AIに伝えるときの文面

遊び終わったら、ほかの人の結果と比べられるようにしてください。結果が出たら window.AIGame?.tally({ "名前": 結果 }) で1票入れ（例: 日替わりの問題なら "d20261024.moves": 手数）、window.AIGame?.getTally(["名前", …]) で { total, counts } を読んで、分布のグラフや「○%の人が解けた」を出してください。名前は英数字と _ . : - だけ。画面に出すのはゲームが決めた選択肢だけにして、知らない値は無視してください。Asobiai の外で getTally が null のときは、その表示を出さないでください。